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

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

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

设置 APP_ENV 控制运行环境

Swoft 依赖 APP_ENV 环境变量决定当前环境（如 dev、prod、test），它会自动加载对应环境的配置文件。默认读取顺序：

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

推荐统一在 .env 中设置，例如：

APP_ENV=prod

按环境分离配置文件

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

立即学习“PHP免费学习笔记（深入）”；

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

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

标签： php swoft框架 redis app 环境变量 配置文件 开发环境 环境配置 red