应通过执行git rev-parse HEAD等命令显式输出提交哈希，并结合GIT_COMMIT等插件变量、写入VERSION文件、注入Ansible参数及解析composer.lock，实现PHP源码版本可追溯。
如果您在Jenkins自动化部署PHP项目时需要确认实际拉取的源码版本，但构建日志中未明确显示Git提交哈希或标签信息，则可能是由于构建步骤未显式输出版本标识。以下是校验PHP源码版本的多种配置方法：
一、在构建步骤中执行Git命令获取版本信息
该方法通过Shell脚本直接调用Git命令，从工作区提取当前检出的提交ID、分支名或最近标签，确保版本可追溯且与构建过程强绑定。
1、在Jenkins任务的“构建” → “执行Shell”中添加以下命令：
2、输入：git rev-parse HEAD
立即学习“PHP免费学习笔记（深入）”；
3、输入：git symbolic-ref --short HEAD 2>/dev/null || git rev-parse --short HEAD
4、输入：git describe --tags --exact-match 2>/dev/null || echo "no exact tag"
二、将Git版本写入部署包元数据文件
该方法在代码同步前生成一个包含版本信息的临时文件（如VERSION或version.json），随PHP源码一同部署至目标服务器，便于运行时或运维核查。
1、在“执行Shell”步骤中追加命令：
2、输入：echo "$(git rev-parse --short HEAD) $(git symbolic-ref --short HEAD 2>/dev/null || git rev-parse --short HEAD)" > VERSION
3、输入：echo "{"commit":"$(git rev-parse HEAD)","branch":"$(git symbolic-ref --short HEAD 2>/dev/null || echo 'detached')","tag":"$(git describe --tags --exact-match 2>/dev/null || echo null)"}" > version.json
4、确保该文件被包含在rsync或ansible同步路径中，不被.gitignore排除。
三、使用Jenkins Git插件参数化暴露版本变量
该方法利用Git插件内置环境变量，在构建过程中直接引用已解析的Git元数据，无需额外执行Git命令，稳定性高且兼容流水线语法。
1、确认Jenkins任务已启用Git源码管理并成功拉取代码。
2、在“构建” → “执行Shell”中使用以下预定义变量：
3、输入：echo "GIT_COMMIT: $GIT_COMMIT"
4、输入：echo "GIT_BRANCH: $GIT_BRANCH"
5、输入：echo "GIT_URL: $GIT_URL"
四、在Ansible部署阶段注入版本环境变量
该方法将Git版本作为Ansible运行时参数传入playbook，在部署动作中动态写入PHP应用配置或日志上下文，实现部署即标记。
1、修改Jenkins构建Shell中的ansible-playbook调用语句：
2、在原有命令后追加：-e "deploy_commit=$GIT_COMMIT" -e "deploy_branch=$GIT_BRANCH"
3、在对应job_name.yml中使用{{ deploy_commit }}渲染到目标文件，例如：
4、在tasks中添加：copy: content: "{{ deploy_commit }}@{{ deploy_branch }}" dest: /alidata/www/VERSION
五、通过Composer.lock校验PHP依赖锁定版本
该方法适用于使用Composer管理依赖的PHP项目，通过解析composer.lock中package版本与hash，验证第三方组件一致性，辅助判断源码完整性。
1、在构建步骤中执行：
2、输入：if [ -f composer.lock ]; then php -r "$json=json_decode(file_get_contents('composer.lock'), true); echo $json['packages'][0]['name'] . ' v' . $json['packages'][0]['version'] . '\n';" | head -n 5; fi
3、输入：jq -r '.packages[] | select(.name == "your-vendor/your-package") | .version + " @" + .dist.shasum' composer.lock 2>/dev/null || echo "package not found"
