从PHP中执行avconv的最优方案？解决system/exec返回NULL问题

我来帮你梳理下PHP里执行avconv的正确姿势，以及你遇到返回NULL问题的原因和解决办法：

为什么system/exec会返回NULL？ #

你碰到的返回NULL情况，大概率是这几个核心原因：

• avconv路径不匹配：PHP运行时的环境变量和你控制台的不一样——你在控制台能执行是因为当前用户的环境变量包含了avconv的路径，但web服务器进程（比如www-data）的环境变量里没这个路径，导致PHP找不到可执行文件。
• 输出流捕获不全：avconv -i的大部分信息是输出到标准错误流（stderr），而exec()/system()默认只捕获标准输出流（stdout）的内容，自然拿不到任何返回值，就会得到NULL。
• 权限不足：web服务器用户没有执行avconv的权限，或者没有读取film.mkv文件的权限，命令根本没正常执行起来。

执行avconv的最佳实践 #

1. 先确认avconv的绝对路径 #

先在控制台执行which avconv，得到它的绝对路径（比如/usr/bin/avconv），之后在PHP里一定要用这个绝对路径调用，彻底避免路径找不到的问题。

2. 正确捕获所有输出（包括stderr） #

用exec()的时候，把stderr重定向到stdout，同时捕获输出数组和返回码，这样就能拿到完整的执行信息：

$avconvPath = '/usr/bin/avconv';
$inputFile = 'film.mkv';
// 转义文件名，避免命令注入风险
$escapedFile = escapeshellarg($inputFile);
// 2>&1 把stderr重定向到stdout，让exec能捕获所有输出
exec("$avconvPath -i $escapedFile 2>&1", $output, $returnCode);

// 调试用：打印输出和返回码
print_r($output);
echo "命令退出码: $returnCode";

如果$returnCode是0，说明命令执行成功；非0则表示有错误，$output里会包含具体的错误提示。

3. 更灵活的选择：proc_open #

如果需要实时获取avconv的执行日志，或者精细控制输入输出流，proc_open是更好的选择——它能分别处理stdout和stderr，适合复杂的命令执行场景：

$avconvPath = '/usr/bin/avconv';
$inputFile = 'film.mkv';
$escapedFile = escapeshellarg($inputFile);

// 定义管道描述符：分别对应标准输入、输出、错误
$descriptorspec = [
    0 => ["pipe", "r"],
    1 => ["pipe", "w"],
    2 => ["pipe", "w"]
];

$process = proc_open("$avconvPath -i $escapedFile", $descriptorspec, $pipes);

if (is_resource($process)) {
    // 读取所有输出内容
    $stdout = stream_get_contents($pipes[1]);
    $stderr = stream_get_contents($pipes[2]);
    
    // 关闭管道
    fclose($pipes[0]);
    fclose($pipes[1]);
    fclose($pipes[2]);
    
    // 获取命令退出码
    $returnCode = proc_close($process);
    
    echo "标准输出:\n$stdout\n";
    echo "错误输出:\n$stderr\n";
    echo "命令退出码: $returnCode";
}

4. 权限排查与修复 #

• 检查film.mkv的权限：确保web服务器用户（比如www-data）能读取它，可执行chmod 644 film.mkv，或者把文件所属组改为www-data。
• 检查avconv的执行权限：执行ls -l /usr/bin/avconv看权限位是否有x（执行权限），一般默认是有的，如果没有可以用chmod +x /usr/bin/avconv修复。
• 谨慎使用sudo：除非必要，不要给web服务器用户sudo权限执行avconv，这会带来安全风险。如果必须用，要在sudoers文件里限制仅允许执行avconv，并且不需要密码。

安全提醒 #

永远不要直接拼接用户输入的文件名或参数到命令里，一定要用escapeshellarg()或escapeshellcmd()转义，防止命令注入攻击。比如如果用户输入的文件名是film.mkv; rm -rf /，不转义的话会执行恶意命令。

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