Composer 的 scripts 功能允许你在特定生命周期事件中执行自定义 PHP 代码或命令，比如在安装或更新依赖时触发。这些脚本通过 scripts 钩子（也叫事件）来绑定到 composer.json 中的相应阶段。

常用安装与更新相关的 scripts 钩子

以下是在依赖安装或更新过程中常用于执行自定义操作的事件：

• pre-install-cmd：在执行 install 命令前运行
• post-install-cmd：在 install 完成后运行
• pre-update-cmd：在执行 update 前运行
• post-update-cmd：在 update 完成后运行

这些钩子适合用来清理缓存、生成配置文件、执行数据库迁移等任务。

定义 scripts 脚本的方法

你可以在 composer.json 文件中添加 scripts 字段来注册回调函数或命令：

{     "scripts": {         "post-install-cmd": [             "echo '项目已安装完毕'",             "php bin/build.php"         ],         "post-update-cmd": [             "echo '依赖已更新'",             "php bin/clear-cache.php"         ]     } } 

上面的例子中，当运行 composer install 或 composer update 后，会自动打印提示并执行指定的 PHP 脚本。

行者AI

行者AI绘图创作，唤醒新的灵感，创造更多可能

100

查看详情

使用类方法作为脚本处理器

更高级的做法是编写一个 PHP 类，实现静态方法来处理事件。Composer 会传入一个 ComposerScriptEvent 对象：

class ScriptHandler {     public static function postInstallOutput($event)     {         $io = $event->getIO();         $io->write("<info>恭喜！项目安装完成。</info>");     } } 

然后在 composer.json 中引用该类方法：

"scripts": {     "post-install-cmd": [         "ScriptHandler::postInstallOutput"     ] } 

确保你的类能被自动加载（例如放在 autoload 区域中），否则会报错找不到方法。

注意事项和最佳实践

• 脚本命令按顺序执行，遇到失败会中断流程
• 可以使用数组形式列出多个命令，提高可读性
• 避免在脚本中执行耗时过长的操作，影响部署效率
• 调试脚本时可用 composer run-script [script-name] 手动测试

基本上就这些。只要把逻辑写好，绑定到合适的钩子上，就能让 Composer 自动帮你完成各种部署辅助工作。