phpEnv 下启用 SOAP 扩展必须修改对应 PHP 版本的实际 php.ini 文件（如 C:\phpenv\php\8.2.15\php.ini），取消 ;extension=php_soap.dll（Windows）或 ;extension=soap（Linux/macOS）注释，确认 extension_dir 指向含对应扩展文件的目录，重启 PHP 服务后验证 php -m | grep soap 输出 soap。
phpEnv 下启用 SOAP 扩展，必须改对 php.ini 文件并重启对应 PHP 服务进程；否则 SoapServer 类根本不存在，直接报 Class 'SoapServer' not found。
确认当前版本实际加载的 php.ini 路径
phpEnv 是多版本隔离环境，每个 PHP 版本用自己独立的 php.ini。改错路径等于白改。
- 在项目目录下运行
php --ini，看Loaded Configuration File输出的完整路径（例如C:\phpenv\php\8.2.15\php.ini或~/.phpenv/versions/8.2.15/etc/php.ini） - 别信 phpEnv 控制面板里“配置文件”按钮打开的路径——它有时会跳转到备份或旧版本
- Apache / Nginx 模式下，Web 请求可能加载另一个
php.ini（如apache2\php.ini），需用<?php phpinfo(); ?>页面搜索Loaded Configuration File再次确认
启用 extension=soap 并验证 extension_dir
Windows 和 Linux/macOS 的扩展名不同，且必须和 extension_dir 指向的实际文件匹配。
- 打开上一步确认的
php.ini，搜索;extension=soap或;extension=php_soap.dll，删掉分号 - Windows 用户必须写
extension=php_soap.dll（不是soap或php_soap.so）；Linux/macOS 用户写extension=soap（不是php_soap.so） - 检查
extension_dir值是否指向真实存在php_soap.dll（Windows）或soap.so（Linux/macOS）的目录，例如extension_dir = "C:\phpenv\php\8.2.15\ext" - 若该目录下没有对应文件，说明当前 phpEnv 版本未打包 SOAP 扩展——需手动下载匹配架构（TS/NTS、x64/x86）、PHP 版本的 DLL，或重编译 PHP（见下一条）
SoapServer 构造失败的三个硬性条件
SoapServer 不像 SoapClient 那样依赖 WSDL 加载，但它对运行时环境更敏感。漏掉任意一项都会静默失败或抛出 SOAP-ERROR: Parsing WSDL 类错误。
立即学习“PHP免费学习笔记（深入）”；
-
location参数必须是客户端可访问的真实 URL（例如http://localhost/server.php），不能是相对路径或file://协议 - 若用 Apache，确保
.php后缀已正确关联 PHP SAPI；若用 Nginx + PHP-FPM，确认fastcgi_pass指向的是你刚改过php.ini的那个 PHP 版本 - 必须显式传
['uri' => 'http://your-namespace']，这个uri是命名空间标识符，不是 URL，且要和服务端 WSDL 中定义的targetNamespace完全一致 - 调试阶段务必加
['trace' => true]，否则构造失败时看不到底层 XML 错误
重编译是唯一能修复“扩展不存在”的方案
如果 php -m | grep soap 无输出，且 php_soap.dll 或 soap.so 确实不在 extension_dir 下，说明该 PHP 版本编译时没启用 --enable-soap —— 这时改 php.ini 没用。
- 编辑
~/.phpenv/plugins/php-build/share/php-build/default_configure_options，确保含--enable-soap（不是--with-soap） - 同时确认含
--enable-libxml（SOAP 依赖 libxml，禁用后直接失效） - 执行
phpenv install --reinstall 8.2.15（替换为你实际版本号） - 重装完成后，再按前两步修改新版本的
php.ini并重启服务
最容易被忽略的是：phpEnv 切换版本（phpenv local 8.2.15）只影响 CLI，不自动同步 Apache/Nginx 使用的 PHP SAPI。你得手动确认 Web 服务进程加载的是哪个 php.ini，否则 SoapServer 在浏览器里永远报错，而命令行却显示正常。
