PHP调用含cv2的Python脚本终端运行正常、调用失败如何解决？

核心原因排查与解决办法 #

• 路径统一替换为绝对路径
  你脚本中所有相对路径都是相对于PHP执行时的工作目录，而非Python脚本所在目录，很容易出现找不到文件的问题：
  1. PHP调用时补全python3和Python脚本的绝对路径，同时追加2>&1捕获错误输出方便调试：

  // 请替换为你服务器对应的真实绝对路径
  $run_log = shell_exec('/usr/bin/python3 /var/www/project/video2frames.py 2>&1');
  // 打印日志即可看到Python脚本的所有输出和报错
  var_dump($run_log);
  

  2. Python脚本内的视频路径、帧存储路径全部改为绝对路径：

  # 示例替换，改为你服务器真实路径
  cam = cv2.VideoCapture("/var/www/project/input/video.mp4")
  # ...
  if not os.path.exists('/var/www/project/input/frames'):
      os.makedirs('/var/www/project/input/frames')
  # ...
  name = '/var/www/project/input/frames/frame' + str(currentframe) + '.png'
  

• 移除无图形环境下不兼容的代码
  PHP调用Python属于无头运行场景，不存在图形窗口，cv2.destroyAllWindows()调用会直接抛出异常终止脚本，直接删除该行代码即可。
• 新增OpenCV初始化校验逻辑
  你当前没有判断VideoCapture是否初始化成功，资源加载失败时后续逻辑自然不会运行，补充判断逻辑：

  cam = cv2.VideoCapture("你的绝对路径视频地址")
  if not cam.isOpened():
      print("视频加载失败，请检查路径、权限")
      exit()
  

• 修复运行权限问题
  PHP默认以www-data（部分环境为apache、nginx）用户运行，和你终端登录的用户权限不同：
  1. 确认视频文件、存储帧的目录对运行PHP的用户开放读写权限，可执行命令赋权：

  # 替换为你项目目录的真实路径
  chown -R www-data:www-data /var/www/project/input
  chmod -R 755 /var/www/project/input
  

  2. 如果你是在个人用户目录下安装的cv2（比如用pip install --user opencv-python安装），www-data用户会找不到cv2模块，可切换到root用户全局安装：

  pip3 install opencv-python
  

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