Git post-receive脚本中Composer命令未找到，如何修复PATH？

核心原因 #

Git钩子脚本（如post-receive）运行在受限的shell环境中，不会自动加载用户终端的shell配置（如.bashrc或.profile），因此即使Composer全局安装，脚本也无法识别其执行路径。

解决方案 #

1. 使用Composer的绝对路径（最可靠） #

在cPanel终端执行which composer，获取Composer的绝对路径（例如/home/[user]/.local/bin/composer），直接在脚本中替换composer为该路径：

#!/bin/sh
git --work-tree=/home/[user]/[site] --git-dir=/home/[user]/[site].git checkout -f
# 替换为你实际的Composer绝对路径
/home/[user]/.local/bin/composer install --working-dir=/home/[user]/[site]

2. 加载用户的shell配置文件 #

将脚本解释器改为bash，并在开头加载用户的.bashrc或.profile，继承终端的PATH配置：

#!/bin/bash
# 加载用户的bash环境配置
. ~/.bashrc
git --work-tree=/home/[user]/[site] --git-dir=/home/[user]/[site].git checkout -f
composer install --working-dir=/home/[user]/[site]

3. 显式设置完整的PATH #

先在终端执行echo $PATH，复制输出的完整PATH字符串，在脚本中显式导出：

#!/bin/sh
# 替换为你终端中echo $PATH的输出内容
export PATH="/home/[user]/.local/bin:/home/[user]/bin:/usr/local/bin:/usr/bin:/bin"
git --work-tree=/home/[user]/[site] --git-dir=/home/[user]/[site].git checkout -f
composer install --working-dir=/home/[user]/[site]

针对你的问题解答 #

• 是否需要每次执行脚本时导出PATH？ 是的。脚本运行在独立子shell中，默认PATH仅包含系统基础路径，不会继承终端的完整PATH，因此需要在脚本内显式设置。
• 正确的PATH配置是什么？ 以你终端中echo $PATH的输出为准，确保包含Composer所在的目录（通常是/home/[user]/.local/bin或/home/[user]/bin）。
• 是否应该修改PATH？ 只需在脚本内临时修改即可，无需全局修改系统或用户的PATH配置，避免影响其他环境。

内容的提问来源于stack exchange，提问作者Coyote6