可通过 Composer 的 post-install-cmd 脚本在 composer install 后自动执行 PHP 脚本生成配置文件,如 .env 或 config/app.php;需在 composer.json 的 scripts 中配置,脚本可读取环境变量、交互输入或复制模板,并注意 CI/CD 兼容性与安全性。

可以通过 Composer 的 post-install-cmd 脚本,在 composer install 完成后自动执行 PHP 脚本生成配置文件,比如根据环境变量或交互式输入创建 .env、config/app.php 等。
在 composer.json 中注册 post-install-cmd 脚本
在项目根目录的 composer.json 文件中,添加或修改 scripts 字段:
"scripts": {
"post-install-cmd": [
"php scripts/generate-config.php"
]
}
确保脚本路径可执行(如 scripts/generate-config.php 存在且有读取权限)。Composer 会按顺序执行数组中的命令,支持 PHP 脚本、Shell 命令或自定义类方法。
编写配置生成脚本(PHP 示例)
在 scripts/generate-config.php 中,可以读取环境变量、提示用户输入,或复制模板生成实际配置。例如:
- 检查
.env是否存在,不存在则从.env.example复制并替换占位符 - 用
getenv()或$_SERVER获取APP_ENV、DB_HOST等,写入配置文件 - 使用
file_put_contents()写入内容,注意确保目标目录可写 - 添加简单校验,如关键变量缺失时抛出异常,避免静默失败
支持交互与安全处理
若需用户输入(如数据库密码),可在脚本中使用 readline() 或 fgets(STDIN);但注意 CI/CD 环境通常无交互终端,建议优先通过环境变量注入:
- 本地开发:允许交互 + 回退到
.env.example - 生产部署:依赖
APP_KEY、DB_PASSWORD等预设环境变量,跳过提示 - 敏感值不硬编码,不写入 Git,生成后设置文件权限(如
chmod 600 .env)
调试与触发时机注意事项
post-install-cmd 仅在首次安装或 composer install(非 update)时运行,不会在 composer update 后触发 —— 如需后者,要额外加 post-update-cmd。
调试时可临时加 echo 或日志输出;若脚本报错,Composer 会中断流程并显示错误信息,便于定位问题。










