Composer 脚本事件可用于在依赖管理过程中执行自定义逻辑,如缓存清理、配置生成等。通过 composer.json 中的 "scripts" 字段可定义各类事件对应的命令或 PHP 方法,常见事件包括 pre-install-cmd、post-install-cmd、pre-update-cmd、post-update-cmd、post-autoload-dump、post-package-install、post-package-update 和 pre-package-uninstall。脚本支持 shell 命令或静态 PHP 方法(需自动加载),例如使用 ScriptHandler::onPostUpdate 处理更新后任务。运行 composer install 时,事件按 pre-install-cmd → post-install-cmd → post-autoload-dump 顺序执行,并根据包操作触发对应包级事件。合理利用脚本能有效集成项目构建与部署流程,但应避免脚本过重影响性能。

Composer 在安装、更新或卸载依赖包时,会触发一系列脚本事件,允许你在特定生命周期节点执行自定义逻辑。这些脚本通常用于自动化任务,比如清除缓存、生成配置文件、运行测试或执行数据库迁移。
常见的 Composer 脚本事件
Composer 支持多种内置事件,你可以在 composer.json 文件中通过 "scripts" 字段定义对应操作:
- pre-install-cmd:在执行 install 命令前触发
- post-install-cmd:install 完成后执行
- pre-update-cmd:update 命令开始前触发
- post-update-cmd:update 完成后执行
- post-autoload-dump:自动加载文件生成后触发(常用于生成类映射)
- post-package-install:某个包安装完成后触发
- post-package-update:某个包更新后触发
- pre-package-uninstall:卸载包之前执行
如何定义脚本
在 composer.json 中添加 scripts 配置项:
"scripts": { "post-install-cmd": [ "echo '安装完成,正在优化自动加载...'", "composer dump-autoload --optimize" ], "post-update-cmd": [ "echo '项目已更新,执行缓存清理'", "php clear-cache.php" ], "post-autoload-dump": [ "My\\Script\\Handler::onAutoloadDump" ] }脚本可以是 shell 命令,也可以是静态 PHP 方法(需自动加载支持)。
自定义脚本与类方法
若想使用 PHP 类处理事件,需确保该类能被自动加载。例如:
JTBC CMS(5.0) 是一款基于PHP和MySQL的内容管理系统原生全栈开发框架,开源协议为AGPLv3,没有任何附加条款。系统可以通过命令行一键安装,源码方面不基于任何第三方框架,不使用任何脚手架,仅依赖一些常见的第三方类库如图表组件等,您只需要了解最基本的前端知识就能很敏捷的进行二次开发,同时我们对于常见的前端功能做了Web Component方式的封装,即便是您仅了解HTML/CSS也
然后在 composer.json 中引用:
"scripts": { "post-update-cmd": "ScriptHandler::onPostUpdate" }事件的执行顺序
当运行 composer install 时,事件按如下顺序执行:
- pre-install-cmd
- (安装依赖过程)
- post-install-cmd
- post-autoload-dump(如果自动加载有变化)
每个已安装或更新的包还可能触发 post-package-install 或 post-package-update,按依赖解析顺序逐个执行。
基本上就这些。Composer 的脚本机制灵活,适合集成项目初始化、构建和部署流程,关键是合理使用,避免脚本过重影响依赖管理效率。









