通过配置composer.json脚本可实现PHP项目一键发布，具体流程包括：定义pre-release、release、post-release等阶段脚本，集成代码检查、版本更新、Git打标与推送操作；结合自定义PHP脚本处理版本变更与日志生成，联动Git和CI/CD实现自动化部署，提升发布效率与可靠性。
在现代PHP项目开发中，使用Composer管理依赖和自动化发布流程已成为标准实践。通过合理配置composer.json中的脚本（scripts），可以将版本发布过程简化为一条命令，减少人为错误，提升效率。
理解Composer脚本机制
Composer允许你在composer.json中定义自定义脚本，这些脚本可以绑定到特定事件或通过composer run [script-name]手动执行。脚本可以是PHP函数、外部命令或系统shell指令。
例如：
"scripts": {
"pre-publish": "echo '准备发布...'",
"publish": "@php ./scripts/publish.php",
"post-publish": ["git push", "git push --tags"]
}
这样你只需运行composer run publish，就会依次执行预处理、主发布逻辑和后续操作。
构建完整的发布流程脚本
一个典型的自动化发布流程包括：代码检查、版本号更新、打Git标签、推送远程、通知团队等。你可以将这些步骤整合进Composer脚本。
常见脚本结构如下：
- pre-release：运行测试、静态分析（如PHPStan）、格式化代码
- release：更新版本号、生成变更日志、提交更改
- post-release：推送到Git仓库、创建标签、触发CI/CD
示例配置：
"scripts": {
"pre-release": [
"@test",
"phpstan analyse src/"
],
"release": "php ./bin/release.php",
"post-release": [
"git push origin main",
"git push origin --tags"
],
"test": "phpunit"
}
编写发布逻辑PHP脚本
你可以写一个独立的PHP脚本（如release.php）来处理复杂逻辑，比如解析当前版本、询问新版本号、修改composer.json、生成CHANGELOG等。
关键点包括：
- 读取并解析composer.json获取当前版本
- 提示用户输入新版本号（或根据参数自动递增）
- 使用file_put_contents()写回新版本
- 执行git tag和git commit
这个脚本可以通过@php前缀在Composer脚本中调用。
结合Git与远程服务实现全自动发布
完成本地脚本后，可将其与Git工作流集成。例如，在打标签后自动触发GitHub Actions部署生产环境。
也可以在post-release中调用API发送通知到Slack或钉钉，告知团队新版本已发布。
注意安全：避免在脚本中硬编码敏感信息，使用环境变量传递Token或密钥。
基本上就这些。通过组合Composer脚本与外部工具，能有效把繁琐的手动发布变成一键操作，既省时又可靠。关键是设计清晰的流程，并逐步验证每一步是否按预期运行。
