如何利用 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 脚本封装逻辑：

标签： composer 自动化配置 php linux laravel js bootstrap git json windo