跨平台AI项目需统一用/拼接路径、proc_open()替代exec()、OpenCV扩展须原生编译、显式定义AI_TEMP_DIR并确保权限——四点缺一不可。
AI模型加载路径在Windows和Linux下必须统一用/分隔
Windows上用\拼接模型路径（如__DIR__ . '\models\age-gender.caffemodel'）在Linux会变成非法路径，因为\被当作文本字符而非目录分隔符，导致file_exists()返回false、cv::dnn::readNetFromCaffe()报错“Cannot open file”。
这不是OpenCV的问题，是PHP路径字符串没过平台适配。
所有模型、权重、配置文件的路径拼接，一律用/：
-
__DIR__ . '/models/age-gender.caffemodel'—— ✅ 跨平台安全 - 避免
DIRECTORY_SEPARATOR：它会让Windows生成\，而OpenCV DNN模块只认/或绝对路径 - Linux下
/能被正确解析；Windows下PHP内部会自动转换为\供系统调用，但OpenCV不走PHP路径层，直接调用C标准库，所以必须原始/
exec()调用Python脚本时参数格式不一致会卡死
Linux下exec('python3 detect.py --img /tmp/test.jpg')正常，Windows下同样命令大概率挂起无响应——因为Windows的python.exe对空格和路径中括号更敏感，且默认不识别--长参数（尤其当Python未加argparse时）。
更糟的是，exec()在Windows下不继承环境变量，PYTHONPATH或虚拟环境activate.bat不会生效。
建议改用proc_open()并显式指定shell：
- Linux：用
['sh', '-c', 'python3 detect.py --img "$1"', '_', $path] - Windows：用
['cmd.exe', '/c', 'python detect.py --img "%~1"', '', $path] - 始终检查
proc_close()返回码，0才代表AI脚本真正完成，不是“启动了就完事”
OpenCV扩展在Windows和Linux下的ABI兼容性陷阱
Windows上编译的php_opencv.dll不能直接丢到Linux跑.so，反之亦然。这不是“装不上”的问题，而是底层符号表、内存布局、C运行时（MSVCRT vs glibc）完全不兼容。
常见误操作：
- 在Windows开发机用
pecl install opencv成功，把extension=opencv复制到Linuxphp.ini里——结果php -m不显示，extension_loaded('opencv')返回false - 用Docker镜像时，误用
FROM php:8.2-cli-windows（不存在），实际拉的是Linux基础镜像，却硬塞Windows扩展 - Linux上必须从源码编译：
git clone https://github.com/php-opencv/php-opencv && cd php-opencv && phpize && ./configure && make && make install
临时文件写入权限与路径在Linux下更严格
AI推理常需保存中间图（如人脸裁剪后上传）、缓存模型（cv::dnn::Net::setPreferableBackend()可能触发磁盘缓存），Windows下sys_get_temp_dir()返回C:\Windows\Temp，通常可写；Linux下返回/tmp，但容器或受限用户可能被挂载为noexec,nosuid,nodev，导致file_put_contents(sys_get_temp_dir() . '/face_123.jpg', $data)静默失败或报Permission denied。
解决方式：
- 不要依赖
sys_get_temp_dir()，显式定义AI_TEMP_DIR = __DIR__ . '/storage/tmp'，并在部署时确保该目录存在且www-data或nginx用户有读写权限 - Linux上线前执行
chown -R www-data:www-data storage/tmp && chmod -R 755 storage/tmp - Windows开发时也模拟相同结构，避免“本地能跑，线上崩”
立即学习“PHP免费学习笔记（深入）”；
