Composer脚本事件可自动化项目流程。在scripts字段定义，如post-install-cmd执行缓存优化，post-create-project-cmd生成.env文件，支持命令数组或静态方法调用，建议用于框架优化与初始化，确保幂等性以提升维护效率。
Composer 提供了丰富的脚本事件系统，允许你在特定生命周期执行自定义命令或 PHP 函数。这些事件可以绑定到 scripts 字段中，用于自动化项目初始化、构建、测试等流程。
常见 Composer Scripts 事件说明
pre-install-cmd
在执行 composer install 命令之前触发。适合做环境检查或备份操作。
post-install-cmd
安装依赖完成后触发。常用于生成配置文件、清除缓存或提示用户下一步操作。
pre-update-cmd
运行 composer update 前触发。可用于提醒开发者注意更新风险。
post-update-cmd
更新依赖后执行。适合重新生成 autoload 文件、运行迁移脚本或优化操作。
pre-autoload-dump
在生成自动加载文件前触发。可用于清理旧的类映射或准备命名空间目录。
post-autoload-dump
自动加载器生成后调用。常用于通知框架重建内部缓存（如 Laravel 的优化）。
pre-package-install
当某个包即将被安装时触发。可用来记录日志或中断不符合条件的安装。
post-package-install
某包安装完成后执行。可用于复制该包中的资源文件到公共目录。
pre-package-update
在更新一个包之前触发。可用于暂停服务或锁定部署状态。
post-package-update
某包更新完成后执行。适合处理兼容性调整或文档同步。
pre-package-uninstall
卸载包前触发。可用于确认是否删除关联配置或数据。
post-package-uninstall
包已卸载后执行。适合清理残留文件或通知系统模块失效。
pre-create-project-cmd
使用 create-project 创建项目时，在初始化代码前运行。可用于验证参数或设置模板变量。
post-create-project-cmd
项目创建完成之后执行。典型用途包括生成密钥（如 Laravel）、移除 .git 目录或输出欢迎信息。
如何定义 scripts？
在 composer.json 中添加 scripts 字段：
{
"scripts": {
"post-install-cmd": [
"echo '依赖已安装'",
"php artisan optimize"
],
"post-update-cmd": "php artisan clear-compiled",
"post-create-project-cmd": [
"php -r \"file_exists('.env') || copy('.env.example', '.env');\""
]
}
}
支持数组形式写多个命令，按顺序执行。也可以调用实现了 Composer\Script\Event 接口的静态方法。
自定义脚本类与方法
你可以将逻辑封装成类方法：
"scripts": {
"post-install-cmd": "App\\Console\\ComposerScripts::postInstall"
}
对应 PHP 类需确保能被自动加载：
namespace App\Console;use Composer\Script\Event;
class ComposerScripts { public static function postInstall(Event $event) { echo "执行自定义安装后逻辑...\n"; } }
实用建议
- 使用
post-update-cmd或post-install-cmd自动执行框架优化。 - 利用
post-create-project-cmd初始化项目配置文件。 - 避免在脚本中执行耗时过长的操作，影响用户体验。
- 脚本命令应具备幂等性，防止重复执行出错。
基本上就这些。合理利用 Composer 的事件机制，能显著提升项目的自动化程度和维护效率。
