php中swoft框架如何配置环境?

Swoft通过.env文件和APP_ENV环境变量自动加载对应环境配置,优先读取系统变量,未设置则回退到.env;配置按properties/与properties/{APP_ENV}/分层合并;支持命令行--env参数覆盖;可用Swoft::getEnv()或isDev()/isProd()验证。

在 Swoft 框架中配置环境,核心是通过 .env 文件 + 环境变量 + 框架启动时的自动加载机制来实现,不需要手动改代码判断环境。

设置 APP_ENV 控制运行环境

Swoft 依赖 APP_ENV 环境变量决定当前环境(如 devprodtest),它会自动加载对应环境的配置文件。默认读取顺序:

  • 先从系统环境变量读取 APP_ENV
  • 未设置则 fallback 到项目根目录下的 .env 文件中的 APP_ENV=dev

推荐统一在 .env 中设置,例如:

APP_ENV=prod

按环境分离配置文件

Swoft 的配置存放在 app/config/ 目录下,支持按环境分组:

  • app/config/properties/:基础配置(如数据库、Redis)
  • app/config/properties/dev/:开发环境覆盖项(如开启 debug、日志级别调低)
  • app/config/properties/prod/:生产环境覆盖项(如关闭 debug、启用缓存、调整日志路径)

框架启动时会自动合并 properties/ + properties/{APP_ENV}/ 下的同名文件。比如 database.phpprod/ 下重定义了 host,就会覆盖基础配置。

启动服务时指定环境(可选)

如果不想依赖 .env,也可以在命令行直接传参:

php bin/swoft http:start --env=prod

该方式会临时覆盖 .env系统变量,适合 CI/CD 或容器部署时灵活控制。

验证当前环境是否生效

在代码中可通过以下方式检查:

echo \Swoft::getEnv('APP_ENV'); // 输出 prod 或 dev
var_dump(\Swoft::isDev()); // true / false
var_dump(\Swoft::isProd()); // true / false

注意:\Swoft::isDev() 是基于 APP_ENV === 'dev' 判断的,不是根据调试开关。

基本上就这些。环境配置不复杂但容易忽略细节,关键是保持 .env 干净、配置文件层级清晰、部署时确认 APP_ENV 正确写入。