shell_exec返回空字符串、false或null时，需分情况处理：空字符串表示输出异常；false说明管道失败（如函数被禁用）；null常因stderr未合并。必须加2>&1捕获错误，用trim()清理输出，结合exec获取退出码验证执行状态，并确认PHP运行用户权限与命令路径。
如果您在PHP中调用shell_exec()获取系统命令输出，却得到空字符串、false或null，而终端中相同命令能正常显示结果，则问题往往出在输出流捕获机制或环境差异上。以下是处理shell_exec返回值的多种方法与典型陷阱：
一、识别shell_exec的三种返回状态及其含义
shell_exec()并非简单“执行失败”，其返回值需按类型分别判断：返回空字符串（''）表示命令有输出但被截断或重定向异常；返回false说明管道建立失败（如disable_functions限制、权限不足）；返回null则可能因命令无输出、stderr未合并、或执行错误但未触发警告。
1、使用var_dump()完整检查返回值类型与内容，避免仅用empty()或== ''粗略判断。
2、在调用前确认函数未被禁用：执行var_dump(function_exists('shell_exec'))。
立即学习“PHP免费学习笔记（深入）”；
3、检查PHP配置中disable_functions是否包含shell_exec，路径为php.ini中的disable_functions = ...项。
二、强制捕获stderr以解决“命令有输出却返回null”
多数CLI工具（如pdftotext -v、convert -version、gs -version）将版本信息、警告等写入stderr而非stdout，而shell_exec默认只捕获stdout，导致看似成功执行却返回null。
1、在命令末尾添加2>&1重定向操作符，确保stderr合并至stdout。
2、确保2>&1紧贴命令结尾，中间无空格，例如：shell_exec('pdftotext -v 2>&1')。
3、对返回值使用trim()去除首尾空白与换行，防止解析失败。
三、使用临时文件绕过无回显场景
当shell_exec持续返回空且无法调试时，可将命令输出重定向至服务器可读文件，再由PHP读取该文件内容，规避管道建立失败或输出截断问题。
1、构造带重定向的命令：$cmd = 'ls -la /tmp > /tmp/shell_output.txt 2>&1'。
2、执行shell_exec($cmd)，该调用本身可能返回空，但文件已写入。
3、随后调用file_get_contents('/tmp/shell_output.txt')获取实际输出。
4、执行完毕后立即unlink('/tmp/shell_output.txt')清理临时文件。
四、切换为exec()并捕获退出码验证执行状态
shell_exec无法提供进程退出码，而exec可通过第三个参数获取$return_code，从而区分“命令未找到”（127）、“权限拒绝”（126）、“执行出错”（非0）与“成功”（0）。
1、声明空数组$output和整型$return_code：$output = []; $return_code = 0;
2、调用exec('date 2>&1', $output, $return_code)。
3、检查$return_code是否为0，再决定是否处理$output。
4、若$return_code非0，可结合$output内容进一步定位错误原因。
五、验证PHP运行用户权限与环境隔离问题
Web服务器（如nginx或Apache）下PHP常以www-data、nginx或nobody用户运行，该用户可能无权访问目标命令、路径或系统工具，导致静默失败。
1、在PHP中执行echo shell_exec('whoami')确认当前执行用户。
2、检查命令是否存在：shell_exec('which ls')或shell_exec('command -v pdftotext')。
3、测试该用户是否具备执行权限：shell_exec('sudo -u www-data /usr/bin/pdftotext -v 2>&1')（需提前配置sudoers）。
4、始终使用绝对路径调用命令，避免PATH环境变量缺失导致的“command not found”。
