PHP 8 本身不参与视频编解码，硬件加速转码关键在 FFmpeg 是否启用 NVIDIA NVENC；需先验证 ffmpeg -hwaccels 含 cuda、ffmpeg -encoders 含 h264_nvenc、nvidia-smi 正常，再在 PHP 中用 exec 调用 -c:v h264_nvenc 命令，并配置 LD_LIBRARY_PATH 与权限确保 CUDA 可用。
PHP 8 本身不参与视频编解码，硬件加速转码的关键在 FFmpeg 是否启用 NVIDIA NVENC（或其他 GPU 加速模块），PHP 只负责调用命令。配置目标很明确：让 PHP 8 调用的 FFmpeg 命令真正走 GPU 编码，而不是默认的 CPU 软编码。
确认 FFmpeg 已支持 NVENC
这是前提，PHP 再怎么写也无法“凭空启用”硬件加速。必须先验证系统级 FFmpeg 是否编译时启用了 –enable-nvenc 和 –enable-cuda，并能识别显卡：
- 运行 ffmpeg -hwaccels，输出中应包含 cuda 和 nvenc
- 运行 ffmpeg -encoders | grep nvenc，应看到类似 hevc_nvenc、h264_nvenc 的编码器
- 运行 nvidia-smi，确认驱动正常、GPU 可见（尤其注意驱动版本 ≥ 470，CUDA 版本 ≥ 11.4）
PHP 8 中调用 NVENC 转码的核心命令
在 PHP 8 的 exec() 或 shell_exec() 中，直接使用硬件加速参数，例如将 H.265 转为 H.264：
-
基础命令：
ffmpeg -i input.mp4 -c:v h264_nvenc -preset p4 -b:v 2000k -c:a aac -b:a 128k output.mp4 -
关键点：
- -c:v h264_nvenc：强制使用 NVIDIA GPU 编码 H.264，不是 libx264
- -preset p4：NVENC 的预设（p1–p7），p4 是速度与质量较平衡的选择；p1 最快但压缩率低，p7 最慢但体积更小
- 不要加 -profile 或 -level 限制：NVENC 自动适配，硬设可能触发失败
- 音频仍可用 aac（CPU 编码），不影响整体加速效果
PHP 8 环境下的安全调用与错误捕获
避免 exec() 静默失败，必须规范处理：
立即学习“PHP免费学习笔记（深入）”；
- 确保 PHP 进程用户（如 www-data）对输入文件有读权限、对输出目录有写权限
- 禁用函数检查：确认 disable_functions 中未禁用 exec、shell_exec 或 proc_open
- 完整调用示例（带错误捕获）：
if ($return_code !== 0) {
error_log("NVENC 转码失败: " . implode("\n", $output));
throw new RuntimeException("GPU 转码异常");
}
常见失败原因与绕过技巧
即使命令正确，也可能报错 “Encoder 'h264_nvenc' not found” 或 “Cannot load libcuda.so”：
-
libcuda.so 找不到：在 PHP-FPM 或 Apache 的环境变量中补全路径，例如在 /etc/php/8.0/fpm/pool.d/www.conf 中添加：
env[LD_LIBRARY_PATH] = /usr/lib/x86_64-linux-gnu:/usr/local/cuda/lib64 -
权限不足（CUDA 初始化失败）：确保 PHP 进程运行在有 CUDA 访问权限的用户下；部分云服务器需开启“持久化模式”：
nvidia-smi -i 0 -dm 1 - 显存不足或并发超限：NVENC 单卡通常最多支持 4–8 路并发编码；批量任务建议加队列控制，避免 exec 并发炸掉 GPU
