環境変数

env モジュールは、ランタイムが公開する環境変数を読み取り、更新します。

このページは API リファレンスです。各スニペットは独立した操作であり、指定した変数とセキュリティポリシーがすでに存在することを前提とします。

変数にアクセスする前に環境システムで定義する必要がある。システムは値を提供するストレージバックエンド（OS、ファイル、メモリ）と変数が読み取り専用かどうかを制御。

ロード

local env = require("env")

get

環境変数の値を取得。

-- データベース接続文字列を取得
local db_url = env.get("DATABASE_URL")
if not db_url then
    return nil, errors.new({ kind = errors.INVALID, message = "DATABASE_URL not configured" })
end

local port, port_err = get_or("PORT", "8080")
if port_err then return nil, port_err end

戻り値: string, error

変数が存在しない場合はnil, errorを返す。

set

環境変数を設定。

-- Set runtime configuration
local updated, set_err = env.set("APP_MODE", "production")
if set_err then return nil, set_err end
return updated

戻り値: boolean, error

get_all

アクセス可能なすべての環境変数を取得。

local logger = require("logger")

local vars, vars_err = env.get_all()
if vars_err then return nil, vars_err end

-- Log names only. Values such as connection URLs may contain credentials even
-- when their keys do not include words like SECRET or KEY.
local accessible_keys = {}
for key in pairs(vars) do table.insert(accessible_keys, key) end
logger:debug("accessible environment variables", {keys = accessible_keys})

-- Check required variables
local required = {"DATABASE_URL", "REDIS_URL", "API_KEY"}
for _, key in ipairs(required) do
    if not vars[key] then
        return nil, errors.new({ kind = errors.INVALID, message = "Missing required env var: " .. key })
    end
end

戻り値: table, error

権限

環境アクセスはセキュリティポリシー評価の対象。

セキュリティアクション

get_all に専用のセキュリティアクションはありません。各変数名を env.get でフィルタリングし、env.get アクションが許可されている変数のみを返します。

アクセス確認

local security = require("security")

if security.can("env.get", "DATABASE_URL") then
    local url = env.get("DATABASE_URL")
end

ポリシー設定についてはセキュリティモデルを参照。

エラー

エラーの処理についてはエラー処理を参照。

関連項目

• 環境システム - ストレージバックエンドと変数定義の設定