PHP system()函数在Laravel Forge服务器上失效，本地运行正常

这种本地正常、部署到Forge就出问题的场景我碰过好多次，核心大概率是环境路径差异或者权限不足导致的，咱们一步步来排查解决：

1. 先确认系统命令的绝对路径 #

本地的zip命令可能在默认PATH里，但Forge服务器的PHP运行环境可能没把命令路径加入全局变量。你可以先在服务器SSH里执行：

which zip

拿到类似/usr/bin/zip的绝对路径，然后把代码里的system('zip ...')改成用绝对路径调用，比如：

system('/usr/bin/zip -r archive.zip /path/to/files 2>&1', $returnCode);

（后面加2>&1是把错误输出重定向到标准输出，方便你看报错）

2. 检查文件/目录权限 #

Forge的PHP进程默认用www-data用户运行，你生成Zip的目录和要压缩的文件必须让这个用户能读写：

• 给Zip输出目录设置正确权限：

chown -R www-data:www-data /path/to/your/zip-output-directory
chmod -R 755 /path/to/your/zip-output-directory

• 确保要压缩的源文件www-data也能读取，不然zip命令会因为权限不足失败。

3. 捕获system()的执行错误 #

本地能跑通不代表服务器上命令没出错，只是你没看到错误信息。修改代码捕获命令的返回值和输出：

$command = '/usr/bin/zip -r archive.zip /path/to/files';
$output = system($command . ' 2>&1', $returnCode);

// 打印调试信息（上线前记得删掉）
dd($returnCode, $output);

如果$returnCode不是0，说明命令执行失败，$output里会有具体的错误提示（比如“zip命令不存在”“权限不够”等），这能帮你快速定位问题。

4. 更稳妥的方案：用Laravel自带的Zip工具 #

依赖system()调用系统命令很容易踩环境差异的坑，Laravel本身封装了ZipArchive，用框架自带的Zip facade更靠谱，跨环境兼容性拉满：

use Illuminate\Support\Facades\Zip;

// 生成Zip文件
Zip::create('archive.zip', [
    'document.pdf' => storage_path('app/public/documents/document.pdf'),
    'image.jpg' => storage_path('app/public/images/image.jpg'),
], storage_path('app/public/zips'));

// 后续下载直接用这个路径即可
return response()->download(storage_path('app/public/zips/archive.zip'));

这种方式不用操心系统命令的路径、权限问题，Laravel会帮你处理好。

5. 排查PHP函数禁用情况 #

极端情况：Forge的PHP配置里禁用了system()函数。你可以在服务器上创建一个phpinfo文件，查看disable_functions项，如果里面包含system，可以在Forge的PHP配置里去掉它（不过更建议用上面的Zip facade，避免安全风险）。

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