如何编写一个Composer脚本来处理版本发布前的准备工作？（Git打标签）

composer项目中应通过解析composer.json获取版本号而非硬编码，使用php命令校验语义化格式后打v前缀git标签，并确保工作区干净、标签未重复，最后手动确认推送。

在 Composer 项目中，可以通过定义 scripts 来自动化版本发布前的 Git 标签操作。核心思路是：用 Composer 脚本调用 Shell 命令（如 git tag），并配合变量（如 $VERSION）或动态读取版本号，确保标签与 composer.json 中的 version 字段一致。

确认版本号来源：优先读取 composer.json

不要硬编码版本号。Composer 提供了内置变量 {$version}，但它只在包被安装时可用，**不适合在本地发布脚本中直接使用**。更可靠的方式是用命令行工具解析 composer.json：

• linux/macOS：用 jq 工具提取 version 字段，例如：jq -r '.version' composer.json
• windows（无 jq）：可改用 PHP 一行命令：php -r "echo json_decode(file_get_contents('composer.json'))->version;"
• 注意：确保 composer.json 中的 version 字段已手动更新为待发布的版本（如 "1.2.0"），这是语义化发布的前提

编写安全的打标签脚本（含校验）

避免重复打标签或误操作。推荐在 composer.json 的 scripts 中定义一个带检查的脚本：

"scripts": {   "release:tag": [     "@release:check-version",     "git tag -a "v{$VERSION}" -m "Release v{$VERSION}"",     "git push origin "v{$VERSION}""   ],   "release:check-version": "php -r "$v = json_decode(file_get_contents('composer.json'))->version; if (!$v || !preg_match('/^\d+\.\d+\.\d+(-[a-z0-9]+)?$/', $v)) { die('Invalid version format in composer.jsonn'); } echo "Using version: $vn';"" }

说明：

美图AI开放平台

美图推出的ai人脸图像处理平台

111

查看详情

• release:check-version 先校验 version 是否符合语义化版本格式（如 1.2.0 或 1.2.0-beta.1）
• release:tag 使用 {$VERSION} —— 这里需在运行时通过环境变量传入，例如：VERSION=$(php -r "echo json_decode(file_get_contents('composer.json'))->version;") composer release:tag
• 标签名加 v 前缀（如 v1.2.0）是主流约定，github/gitlab 自动识别为 Release

整合到完整发布流程（可选）

把打标签作为多步骤发布的一部分，比如：

• 更新 composer.json 中的 version
• 提交变更（如 git commit -am "chore: bump to v1.2.0"）
• 运行脚本：VERSION=$(php -r "echo json_decode(file_get_contents('composer.json'))->version;") composer release:tag
• 后续可追加打包、发布到 Packagist 等步骤（用 composer publish 等自定义脚本）

注意事项与避坑

常见问题要提前预防：

• Git 工作区必须干净：建议在脚本开头加 git status --porcelain 检查，非空则中止
• 标签已存在时会失败：加 -f 强制覆盖不推荐；更稳妥的是先查：git rev-parse v{$VERSION} >/dev/NULL 2>&1 || git tag ...
• Windows 用户注意路径和引号：PowerShell 对单引号处理不同，建议统一用 CMD + 双引号，或改用 PHP 脚本封装逻辑
• 别把敏感操作写死在 scripts 里：如自动 push，应明确提示用户确认，或拆分为 release:tag 和 release:push-tag 两步

基本上就这些。关键不是脚本多复杂，而是让版本号来源可信、操作可逆、失败有提示。Composer 脚本只是胶水，真正可靠的是你对 Git 和语义化版本的理解。

以上就是如何编写一个Composer脚本来处理版本发布前的准备工作？（Git打标签）的详细内容，更多请关注php中文网其它相关文章！