ThinkPHP的.env文件必须扁平化为字符串键值对，第三方SDK配置如ALIYUN_OSS_ACCESS_KEY_ID=xxx；需在config/对应PHP文件中用env()读取并返回结构；修改后须清除配置缓存，且文件须为UTF-8无BOM编码。
Env 文件里写第三方 SDK 配置项，用标准键值对就行
ThinkPHP 的 .env 文件本质是环境变量加载器，不识别嵌套或数组语法。所有第三方 SDK 参数（比如微信支付、阿里云 OSS、极光推送）都必须扁平化为字符串键值对，用下划线分隔层级。
常见错误是照搬 PHP 配置数组写法，例如：wechat.app_id=xxx 是对的，但 wechat = [app_id => xxx] 或 wechat['app_id']='xxx' 会直接被忽略。
ALIYUN_OSS_ACCESS_KEY_ID=your_key_idALIYUN_OSS_ACCESS_KEY_SECRET=your_key_secretALIYUN_OSS_BUCKET=my-bucketALIYUN_OSS_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.comJIGUANG_APP_KEY=abcd1234JIGUANG_MASTER_SECRET=efgh5678
在配置文件中读取 env 变量并透传给 SDK
ThinkPHP 不允许在 .env 中直接 new 实例或调用 SDK 初始化逻辑，必须通过框架的配置机制桥接。推荐做法是在 config/ 下新建对应配置文件（如 aliyun.php），用 env() 函数读取，并返回 SDK 所需结构。
例如 config/aliyun.php：
立即学习“PHP免费学习笔记（深入）”；
<?php
return [
'oss' => [
'access_key_id' => env('ALIYUN_OSS_ACCESS_KEY_ID', ''),
'access_key_secret' => env('ALIYUN_OSS_ACCESS_KEY_SECRET', ''),
'bucket' => env('ALIYUN_OSS_BUCKET', ''),
'endpoint' => env('ALIYUN_OSS_ENDPOINT', ''),
],
];
注意：不要在配置文件里做条件判断或复杂运算，env() 返回值类型默认是字符串，SDK 构造器若需要布尔或整型，得手动转换（如 (bool) env('DEBUG_MODE', false)）。
运行时加载失败？检查 env 加载时机和缓存
ThinkPHP 默认只在应用启动初期加载一次 .env，且生产环境下会缓存配置。改完 .env 后没生效，大概率是配置缓存没清。
- 开发环境：确认
APP_DEBUG=true，否则env()可能返回 null - 生产环境：执行
php think clear:config清除配置缓存（不是clear:route或clear:cache） - 验证是否加载成功：在控制器里临时加
dump(env('ALIYUN_OSS_BUCKET'));，非空才说明读取正常 - 如果值是空字符串但 .env 明确写了，检查 .env 文件编码是否为 UTF-8 无 BOM —— BOM 会导致 key 前缀污染，
env('ALIYUN_OSS_BUCKET')实际查的是ALIYUN_OSS_BUCKET（带不可见字符）
敏感参数别硬编码，但也要避开 config 缓存陷阱
数据库密码、SDK 密钥这类字段必须从 .env 读，不能写死在 config/ 文件里。但要注意：某些 SDK 初始化逻辑（如微信支付 Pay::instance()）会在服务提供者里提前调用，此时若依赖未加载的 env 变量，就会报错 “Missing config key”。
解决方法只有两个：
- 确保该 SDK 的服务提供者（如
App\Providers\WechatServiceProvider）在config/app.php的providers数组里排在think\provider\ConfigProvider::class之后 - 或者把初始化延迟到第一次使用时（用单例 + 懒加载），而不是在服务提供者
register()里直接 new 实例
最易被忽略的是：本地测试时一切正常，部署到线上后突然报密钥为空 —— 很可能是服务器上 .env 权限不对（如 600），导致 PHP 进程无法读取，但又不报错，只默默返回默认空值。
