腳本開發 / 環境變量 DFF.ENV

在腳本編輯器左側邊欄配置的環境變量，可以在 Script 中使用其 ID 讀取。

API

方法	説明
DFF.ENV(key, default=None)	讀取環境變量；不存在時返回 default
DFF.ENV.get(key, default=None)	與直接調用 DFF.ENV(...) 等價
DFF.ENV.keys()	返回可用環境變量的 ID 列表
DFF.ENV.ref(key, default=None)	為支持動態取值的 DFF.API 參數創建延遲引用

company_name = DFF.ENV('companyName')
page_size = DFF.ENV('pageSize', default=10)
all_keys = DFF.ENV.keys()

找不到環境變量時返回 default，未傳入默認值時返回 None。password 類型的環境變量會自動解密；配置了類型轉換時，會返回轉換後的 Python 值。配置錯誤可能導致類型轉換拋出異常，因此讀取可選變量時應提供默認值或兜底邏輯。

def get_page_size():
    try:
        return int(DFF.ENV('pageSize', default=10) or 10)
    except Exception:
        return 10

動態引用

DFF.ENV.ref(...) 返回的是動態引用，而不是當前環境變量值。引用會在消費 Func 元數據時解析，可用於 DFF.API 的 delayed_cron_job、timeout、expires 和 queue 參數。

@DFF.API('動態超時', timeout=DFF.ENV.ref('FUNC_TIMEOUT', default=35))
def dynamic_timeout():
    return 'ok'

連接地址、Token、密碼和環境差異配置應優先存放在環境變量中，不要硬編碼在 Script 內，也不要通過 print(...) 或 Func 響應輸出敏感值。