PHP跨平台AI开发环境搭建_Windows与Mac配置【教程】-php教程-PHP中文网

跨平台PHP AI开发需分平台配置：Windows宜用HTTP/CLI调Python服务，Mac需规避GMP依赖并禁用ext-gmp，composer.json的platform配置须拆分维护，且严禁共用vendor目录。

php跨平台ai开发环境搭建_windows与mac配置【教程】

跨平台 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。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

改用纯 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）不同引发证书验证失败。

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。跨平台不是配置同步，是各自收敛到最小可行路径。