CodeIgniter4基础教程：多环境配置与切换-php教程-PHP中文网

ci4多环境配置核心是environment常量与.env文件联动，需通过web服务器注入ci_env环境变量，并确保app_env与ci_env一致；数据库等配置应通过env()函数从.env读取，日志和错误显示由app_debug控制。

codeigniter4基础教程：多环境配置与切换

CI4 的多环境配置不是靠改文件名或复制 config 目录实现的，核心是 ENVIRONMENT 常量 + .env 文件联动，且必须配合 Web 服务器环境变量注入才安全可靠。

ENVIRONMENT 常量怎么设才不踩坑

CI4 默认在 public/index.php 里定义 ENVIRONMENT，但它的值不能硬写死——比如直接改成 define('ENVIRONMENT', 'production')。这样代码提交后会把生产配置暴露在 Git 里，也容易被本地调试误触发。

正确做法是让 PHP 从服务器环境变量读取：

Apache：在虚拟主机配置里加 SetEnv CI_ENV production
Nginx：在 server 块里加 fastcgi_param CI_ENV "production";
Docker：用 environment: 下的 CI_ENV: production

然后确保 public/index.php 里这行没被改过：
define('ENVIRONMENT', isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'development');

如果 $_SERVER['CI_ENV'] 没传进来，就 fallback 到 development，开发时不用动任何配置也能跑。

.env 文件怎么配才生效

CI4 启动时会自动加载项目根目录下的 .env 文件，但前提是 APP_ENV 和 CI_ENV 一致——APP_ENV 是 CI4 内部用的环境标识，CI_ENV 是你传给 PHP 的外部变量，两者必须匹配，否则 .env 里写的数据库账号密码、密钥等全不会加载。

所以 .env 文件开头必须写：

APP_ENV = production
CI_ENV = production

常见错误：

CodeIgniter 4.7.0

CodeIgniter下载页提供 CodeIgniter 4.7.0 官方源码包，并整理框架安装、数据库配置与入门开发说明。

下载

APP_ENV=prod 但 CI_ENV=production → 不匹配，.env 被忽略
.env 权限设成 755 或放 Git 里 → 敏感信息泄露风险
本地开发用 php spark serve 启动时没加 --env=development → 默认走 production，报错“database connection failed”

database.php 怎么写才能按环境切换连接

CI4 不再推荐在 app/Config/Database.php 里写一堆 if (ENVIRONMENT === '...') 分支，而是用 .env 变量直接注入配置项。更干净的做法是：删掉所有环境判断逻辑，只保留基础结构，把具体值全交给 .env。

例如 app/Config/Database.php 中保持：

public $default = [
    'DSN'      => '',
    'hostname' => env('DB_HOST', 'localhost'),
    'username' => env('DB_USERNAME', ''),
    'password' => env('DB_PASSWORD', ''),
    'database' => env('DB_DATABASE', ''),
    'DBDriver' => env('DB_DRIVER', 'MySQLi'),
    'DBPrefix' => '',
    // …其余字段保持默认即可
];

对应 .env 就写：

# 开发环境
DB_HOST = localhost
DB_USERNAME = root
DB_PASSWORD =
DB_DATABASE = ci4_dev
<h1>生产环境</h1><p>DB_HOST = db-prod.example.com
DB_USERNAME = app_prod
DB_PASSWORD = s3cr3t_p@ss
DB_DATABASE = ci4_main</p>

注意：env() 函数第二个参数是 fallback，默认值只用于本地无 .env 时兜底，上线前必须确保 .env 存在且权限为 600。