ThinkPHP的env()函数仅支持解析标量值，不原生支持数组；需在.env中用JSON字符串（如API_TIMEOUTS='[30,60,90]'）并手动json_decode(env('API_TIMEOUTS'), true)解码，或改用config/目录下的PHP配置文件直接返回数组结构。
ThinkPHP 本身不支持直接从 .env 文件读取数组结构（如 DB_HOSTS=["192.168.1.1", "192.168.1.2"]），env() 函数只解析标量值（字符串、数字、布尔、null），遇到 JSON 格式字符串需手动 json_decode()。
env() 无法原生解析数组，必须用 JSON 字符串 + 手动解码
你不能在 .env 里写 API_TIMEOUTS=30,60,90 然后期望 env('API_TIMEOUTS') 返回 PHP 数组——它只会返回字符串 "30,60,90"。真正可行的是：
- 在
.env中写成合法 JSON 字符串：API_TIMEOUTS='[30,60,90]'或DB_CONFIG='{"host":"localhost","port":3306}' - 在配置文件（如
config/database.php）中显式调用：json_decode(env('DB_CONFIG', '{}'), true) - 注意单引号包裹 JSON，避免 shell 解析错误；双引号内需转义
-
json_decode(..., true)的第二个参数必须为true，否则返回 stdClass 对象，不是数组
config/ 目录下的 PHP 配置文件才是数组主战场
Env 只适合扁平化敏感项，复杂结构应下沉到 PHP 配置文件中，由框架自动合并：
- 在
config/app.php的'extra' => ['api']声明自定义配置文件 - 新建
config/api.php，直接返回 PHP 数组：return ['timeouts' => [30, 60, 90], 'hosts' => ['a.com', 'b.com']] - 之后统一用
config('api.timeouts')读取，无需 JSON 编解码，类型安全，IDE 可识别 - 修改该文件后需清缓存：
php think clear:config或删runtime/cache/下对应文件
env() 读取后未生效？检查这三点
常见“env('XXX') 返回 null”问题，和数组无关，但常被误判：
立即学习“PHP免费学习笔记（深入）”；
-
.env文件必须位于项目根目录（与index.php同级），且命名严格为.env（无后缀、无空格） - 确认
think\facade\Env::get()或env()助手函数在配置加载前已被调用（ThinkPHP 6 默认在bootstrap/app.php就加载.env，但若手动改过启动流程可能失效） - 运行时执行
php think env查看当前解析出的 env 变量列表，确认目标键是否存在、值是否符合预期（比如是否被引号截断）
Env 是启动期快照，不是实时监听器；数组结构天然不适合它。把结构化数据交给 PHP 配置文件，把密码、开关、简单列表交给 .env + json_decode，边界划清了，后续维护才不会掉坑里。
