PHP 8.4 彻底移除 COM 扩展,com_load、new COM() 等均不可用;Windows 下无法通过编译或 PECL 恢复;推荐用 exec() 调用 PowerShell/VBScript 或封装独立 CLI 工具替代。

PHP 8.4 官方不支持 COM 扩展,com_load、new COM() 等调用会直接报错或根本不可用。
PHP 8.4 已移除 com 扩展
自 PHP 8.0 起,com_dotnet 扩展已被标记为废弃;到 PHP 8.4,该扩展已从源码中彻底删除。Windows 下也**无法通过编译或 pecl 安装恢复**。
- 运行
php -m | findstr com或get_loaded_extensions()查看,结果为空 - 尝试
new COM("WScript.Shell")会触发Fatal error: Uncaught Error: Class "COM" not found - 即使降级到 PHP 8.3,
com_dotnet也仅在 NTS(非线程安全)+ VC17 x64 构建下勉强可用,且不稳定
替代方案:用 exec() 调用 PowerShell 或 VBScript
这是目前 Windows 下最可靠、兼容 PHP 8.4 的 COM 交互方式——绕过 PHP 层,交由系统脚本执行。
- PowerShell 可原生调用 COM 对象,例如:
$excel = New-Object -ComObject Excel.Application - 用
exec()或proc_open()启动 PowerShell 进程,传入脚本内容或临时文件 - 注意权限:IIS/Apache 运行的 PHP 进程需有桌面交互权限(通常需改用「本地系统」或显式配置)
- 输出需用
ConvertTo-Json或纯文本格式,避免 PowerShell 富格式干扰解析
exec('powershell -Command "$xl = New-Object -ComObject Excel.Application; $xl.Visible = $false; $wb = $xl.Workbooks.Add(); $wb.SaveAs(\'C:\\temp\\test.xlsx\'); $xl.Quit(); \'done\'"', $output);
var_dump(implode("\n", $output));更稳健的做法:改用 REST / CLI 封装中间层
若 COM 对象提供的是业务逻辑(如打印、Excel 处理、硬件驱动),不要让 PHP 直接耦合。
立即学习“PHP免费学习笔记(深入)”;
- 用 C# / AutoIt / Python(pywin32)写一个独立 CLI 工具,封装 COM 调用,标准输入/输出通信
- PHP 用
proc_open()启动它,传参并读取 JSON 输出 - 优势:隔离崩溃风险、可复用、便于日志和超时控制、不受 PHP 版本限制
- 示例工具名:
com-printer.exe --action=print --file=test.pdf
为什么别折腾 dll 注册 + dl() + 自定义扩展
有人想手动加载旧版 php_com_dotnet.dll,这条路在 PHP 8.4 上走不通。
-
dl()函数早在 PHP 7.4 就被彻底移除,8.4 中已不存在 - 即使找到匹配的 DLL,其依赖的 Zend API 符号(如
zend_register_internal_class_ex)在 8.4 中已变更,加载即段错误 - 官方构建不带
--enable-com-dotnet,且 configure 脚本里该选项已被删除
真正卡点不在“怎么调”,而在“谁来调”——PHP 8.4 主动放弃了这条路径。把 COM 逻辑下沉到外部进程,反而更可控、更易维护。别在 extension 兼容性上浪费时间,尤其是涉及 Office、WMI、老旧硬件 SDK 的场景。











