PHP部署脚本浏览器触发时Composer命令失效，求解决方案

我尝试通过PHP的exec执行composer update --lock -n等部署命令，PHP代码如下：

$commands = array(
         'echo $PWD',
         'whoami',
         'git fetch',
         'git reset --hard HEAD',
         'git pull',
         'git status',
         'composer update --lock -n',
         'npm update --lockfile-version 3 --package-lock-only',
         'composer install -n',   
         'npm install',
         'npm run build' 
     );

foreach ($commands as $command) {
    exec("$command", $output2 , $status );
}

echo $output2;

服务器已全局安装Composer，默认使用composer.json文件。问题在于该部署脚本从浏览器运行时，所有命令均正常执行，唯独Composer包安装相关命令失效！

已做如下排查：

• 脚本运行的用户与控制台执行该PHP脚本的用户一致；
• 控制台运行该脚本时，Composer能正常安装包；
• 以GitHub webhook方式从浏览器运行脚本时，仅Composer依赖安装命令不生效。

恳请告知如何修改脚本，使浏览器触发时Composer能正常安装依赖，绕过此限制？该脚本对服务器部署至关重要！

解决方案 #

1. 使用Composer绝对路径执行 #

浏览器触发的PHP进程可能未加载控制台环境变量，导致找不到全局Composer路径。先在控制台执行which composer获取绝对路径（例如/usr/local/bin/composer），然后替换脚本中的composer为该路径：

// 修改后的命令示例
'/usr/local/bin/composer update --lock -n',
'/usr/local/bin/composer install -n',

2. 指定Composer Home目录 #

浏览器进程可能没有正确的Composer缓存目录权限，执行时手动指定COMPOSER_HOME环境变量：

// 替换为你的实际Composer Home目录（可通过composer config -g home获取）
'COMPOSER_HOME=/home/your-user/.composer /usr/local/bin/composer update --lock -n',

3. 捕获命令错误输出排查问题 #

当前脚本仅捕获标准输出，无法获取错误信息。修改为shell_exec并将错误输出重定向到标准输出，同时写入日志文件：

foreach ($commands as $command) {
    // 重定向错误到标准输出
    $output = shell_exec("$command 2>&1");
    // 将执行记录写入日志（替换为你的日志路径）
    file_put_contents('/var/log/deploy.log', "[$(date)] 命令：$command\n输出：$output\n\n", FILE_APPEND);
}

通过日志可直接查看Composer执行失败的具体原因（如权限不足、依赖冲突、网络问题）。

4. 确保项目目录权限正确 #

检查项目目录及子目录的所有者与权限，确保PHP运行用户拥有读写权限：

# 控制台执行，替换为你的项目路径和用户
chown -R your-user:your-user /path/to/your/project
chmod -R 755 /path/to/your/project

5. 手动指定PHP路径执行Composer #

部分场景下浏览器进程的PHP路径与控制台不一致，可直接指定PHP路径执行Composer：

'/usr/bin/php /usr/local/bin/composer install -n --no-interaction',

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