如何利用 Composer 的 post-create-project-cmd 脚本在新项目创建后进行自动化配置？

post-create-project-cmd钩子在composer create-project时自动执行配置任务，需定义在模板项目的composer.json的scripts中，仅触发一次且支持多命令顺序执行。

在用 composer create-project 初始化新项目时，post-create-project-cmd 钩子能自动执行配置任务，比如生成.env文件、初始化Git、设置权限或运行安装脚本——关键在于把它写进项目的 composer.json 的 scripts 区块里，并确保它只对新项目生效。

在模板项目中声明 post-create-project-cmd

这个钩子不会在你本地开发模板时触发，只会在别人用 create-project 基于你的包生成新项目时运行。所以必须把脚本定义放在**被当作模板的项目**（比如你的 Laravel starter 或自研框架骨架）的 composer.json 中：

• 打开模板项目的 composer.json
• 在 "scripts" 下添加：
  "post-create-project-cmd": ["php -r \"copy('.env.example', '.env');\"", "php artisan key:generate"]
  （注意：这是数组，支持多个命令，按顺序执行）
• 如果命令依赖扩展或 Artisan 等，建议用 php ./artisan 而非全局 php artisan，避免环境差异

区分环境，避免重复执行

该钩子在 create-project 结束后立即运行，但不会在后续 composer install 时再触发——这点和 post-install-cmd 不同。不过仍要注意：

• 不要在钩子里做“仅首次”的判断逻辑（比如检查 .env 是否存在再复制），因为 Composer 已保证它只运行一次
• 若需条件执行（例如仅当在 Linux 上才设 chmod），可用 shell 判断：
  "sh -c 'if [ \"$(uname)\" = \"Linux\" ]; then chmod -R 755 storage bootstrap/cache; fi'"
• PHP 脚本中可用 getcwd() 获取新项目根目录，无需硬编码路径

支持跨平台与错误处理

Windows 用户可能无法直接运行 shell 命令，所以推荐优先使用 PHP 脚本封装逻辑：

千鹿Pr助手

智能Pr插件，融入众多AI功能和海量素材

128

查看详情

• 新建 scripts/after-create.php，内容如：
  <?php file_put_contents('.env', file_get_contents('.env.example')); exec('php artisan key:generate');
• 在 composer.json 中调用：
  "post-create-project-cmd": ["php scripts/after-create.php"]
• 加上 set -e 或 PHP 中检查 file_exists('.env.example')，防止因缺失文件导致静默失败

验证是否生效

最简单的测试方式是：在本地用模板包路径运行 create-project（不走 packagist）：

• composer create-project --working-dir=./test ./path/to/your/template
• 观察终端输出是否打印脚本执行日志（Composer 默认显示执行的命令）
• 检查 ./test/.env 是否生成、APP_KEY 是否已写入
• 若没反应，确认模板项目的 composer.json 已提交，且没有被 .gitattributes 或 archive 配置排除

基本上就这些。它不复杂但容易忽略——重点不是写多炫的脚本，而是让新项目开箱即用的第一步稳稳落地。

以上就是如何利用 Composer 的 post-create-project-cmd 脚本在新项目创建后进行自动化配置？的详细内容，更多请关注php中文网其它相关文章！