跨平台PHP AI开发需分平台配置：Windows宜用HTTP/CLI调Python服务，Mac需规避GMP依赖并禁用ext-gmp，composer.json的platform配置须拆分维护，且严禁共用vendor目录。
跨平台 PHP AI 开发环境不是靠“一套配置走天下”，Windows 和 Mac 在底层运行时、路径处理、扩展加载机制上存在本质差异，强行复用同一份 php.ini 或 composer.json 配置大概率会触发 Class not found、dl() not supported 或模型加载失败。核心矛盾不在 PHP 版本，而在 Python 与 PHP 的进程桥接方式、共享库路径、以及 Apple Silicon 对 x86 扩展的兼容策略。
Windows 上用 exec() 调 Python 模型服务最稳
Windows 缺乏可靠的 PHP 原生 AI 扩展（如 php-tensor 已多年未更新），且 ext-py 等绑定库在 Windows + PHP 8.2+ 下编译失败率极高。绕过扩展，改用 HTTP 或 CLI 进程通信是实际可行路径。
- 把 Python 模型封装成 FastAPI/Flask 服务，监听
http://127.0.0.1:8000/predict，PHP 用file_get_contents()或curl_init()调用，避免 DLL 加载冲突 - 若必须本地执行（如离线场景），用
exec('python.exe C:\ai\infer.py --input ' . escapeshellarg($json))，注意：必须用绝对路径调用python.exe，不能只写python—— Windows 的PYTHONPATH和 PATH 解析不稳定 - 别用
shell_exec()直接拼接 JSON 输入，容易被换行或单引号截断；先json_encode()再escapeshellarg()两层转义
Mac（尤其是 M1/M2）要禁用 php-ml 的 ext-gmp 强依赖
php-ml 的某些版本在 macOS 上会强制 require ext-gmp，但 Homebrew 安装的 PHP（如 php@8.2）默认不带 GMP，手动编译又常因 ARM64 架构符号缺失报错 ld: symbol(s) not found for architecture arm64。
- 改用纯 PHP 实现的轻量替代库，例如
thephpleague/uri不相关，但mltdev/php-ml-lite（社区维护分支）已移除 GMP 依赖，仅保留数组运算 - 如果必须用原版
php-ml，在php.ini中注释掉extension=gmp，并在代码中用if (!extension_loaded('gmp')) { throw new \RuntimeException('GMP required'); }主动拦截，比静默失败更易定位 - Homebrew 用户注意：
brew install gmp后还需pecl install gmp，且要确认pecl对应的是当前php -v的版本，M1 上常见pecl指向系统老 PHP 导致扩展装错位置
composer.json 的 platform 配置在双平台下必须拆开维护
同一份 composer.json 若设 "platform": {"php": "8.2.10"}，在 Mac 上可能因 OpenSSL 版本不匹配导致 ext-openssl 报告 “version mismatch”，而 Windows 又因 cURL SSL backend（Schannel vs OpenSSL）不同引发证书验证失败。
立即学习“PHP免费学习笔记（深入）”；
- Mac 端在项目根目录加
.env，内容为COMPOSER_PLATFORM_CHECK=0，再运行composer install --ignore-platform-reqs绕过扩展版本校验（仅限开发） - Windows 端保留
platform配置，但把关键 AI 依赖（如symfony/process）升级到 v6.4+，它修复了 Windows 上长命令行参数被截断的问题 - CI/CD 流水线里禁止共用
vendor/，Mac 用composer install --no-dev，Windows 加--with-all-dependencies确保symfony/console等工具链完整
真正卡住进度的往往不是模型精度，而是 php.ini 里一行没注释的 extension=php_tensor.dll（Windows）或 extension=php_ml.so（Mac）——它们不会报错，只是让后续所有 class_exists() 返回 false。跨平台不是配置同步，是各自收敛到最小可行路径。
