必须加 2>&1，否则 shell_exec() 只捕获 stdout 而丢弃 stderr，导致 Python/Shell 报错不可见；返回 null 表示执行失败，空字符串可能表示成功但无输出，需用 === null 和 trim 判断，并统一 UTF-8 编码。
必须加 2>&1，否则 shell_exec() 默认只捕获 stdout，stderr 会被丢弃——这是 90% 的“返回为空”问题的根源。
为什么 shell_exec() 看不到 Python/Shell 报错
PHP 的 shell_exec() 本质是调用 shell 打开一个管道读取 stdout，但 stderr 是独立流，默认不经过该管道。哪怕 Python 脚本因语法错误崩溃、路径不存在或权限不足，只要没向 stdout 写东西，shell_exec() 就返回 null 或空字符串，看起来像“什么都没发生”。
常见错误现象：
- 执行
python3 /tmp/test.py返回null，但手动在终端运行却报ModuleNotFoundError - 脚本里
print("done")没输出，但sys.stderr.write("fail")实际触发了 - 中文报错乱码（如
й），因为 stderr 编码未统一
解决办法就一条：强制把 stderr 合并进 stdout。
立即学习“PHP免费学习笔记（深入）”；
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
正确写法：$output = shell_exec('python3 /tmp/test.py 2>&1');
shell_exec() 的返回值判断不能只看是否为空
shell_exec() 返回 null 表示管道建立失败（比如 PHP 禁用了该函数、命令中含非法字符、系统资源不足），而返回空字符串 "" 可能只是命令成功执行但没输出，也可能是 stderr 被重定向后内容为空——这两者语义完全不同，但都表现为“没结果”。
实操建议：
- 先检查
shell_exec()是否被禁用：in_array('shell_exec', array_map('trim', explode(',', ini_get('disable_functions')))) - 用
=== null判断管道失败：if ($output === null) { /* 函数不可用或命令格式非法 */ } - 用
trim($output) === ''判断有输出但为空内容：else if (trim($output) === '') { /* 命令执行了，但没打印任何东西 */ } - 对非空输出做 UTF-8 统一转换：
$output = mb_convert_encoding($output, 'UTF-8', 'auto');，尤其处理中文报错时必加
PHP8.2 下 shell_exec() 的兼容性注意点
PHP8.2 对外部命令调用没有行为变更，但默认更严格地对待错误和编码。几个关键细节：
- Windows 上仍不推荐用于二进制输出（如图片、压缩包），会因文本模式换行符转换导致损坏；Linux/macOS 无此限制
- 如果命令本身带变量（如用户输入的文件名），必须用
escapeshellarg()包裹：shell_exec('python3 ' . escapeshellarg($script_path) . ' 2>&1')，否则存在命令注入风险 - 超时控制需靠外部命令实现，PHP 层不提供原生 timeout 参数；常用方案是加
timeout 10s前缀：shell_exec('timeout 10s python3 script.py 2>&1') - 当 Python 脚本依赖虚拟环境时，不要只写
python3，应指定完整路径：/var/www/venv/bin/python，避免因$PATH差异导致模块找不到
真正容易被忽略的是：即使加了 2>&1，如果目标命令本身不产生任何输出（包括错误），shell_exec() 仍返回空字符串——这时你得靠 exec() 的第三个参数 $return_var 或改用 proc_open() 拿退出码，单靠输出内容无法判断成败。
