根本原因是Windows动态链接器找不到PHP依赖DLL（如php8.dll、libcrypto-1_1.dll），因Apache进程需通过系统PATH定位这些文件，而它们位于PHP根目录而非ext子目录；必须将PHP安装路径（如C:\Webserver\php）添加至系统PATH并重启Windows，且需确认CLI与Web环境加载的是同一php.ini。
PHP 8.1 扩展报 “The specified module could not be found” 是 PATH 没设对
这不是扩展路径写错了，也不是 php.ini 配置漏了 extension=curl，而是 Windows 动态链接器根本找不到 PHP 自身的依赖 DLL（比如 php8.dll、libcrypto-1_1.dll、ssleay32.dll）。Apache 的 httpd.exe 进程启动时，会按系统 PATH 查找这些文件，而它们全在 PHP 安装根目录（如 C:\Webserver\php），不在 ext/ 子目录里。
常见表现：
PHP Warning: PHP Startup: Unable to load dynamic library 'curl' (tried: ext\curl ...)- 所有扩展一起失效（
curl、mbstring、openssl全挂） - 哪怕
php -v正常，php --ini显示配置路径也正确，Web 环境仍加载失败
必须操作：
- 打开「系统属性」→「高级」→「环境变量」→「系统变量」中编辑
Path - 新增一行：
C:\Webserver\php（⚠️ 不加尾部反斜杠） - 点击「确定」保存全部设置后，必须重启整个 Windows 系统——仅重启 Apache 或 CMD 终端无效
CLI 和 Web 加载的是两套 php.ini，改错文件等于白干
Windows 下 CLI 默认按顺序查找：当前工作目录的 php.ini → 环境变量 PHPRC 指向的路径 → PHP 安装目录下的 php.ini。而 Apache 的模块或 IIS 的处理器通常被显式配置为读取某个固定路径的 php.ini。两者很可能不是同一个文件。
立即学习“PHP免费学习笔记（深入）”；
验证方式：
- CLI 环境执行：
php --ini，看 “Loaded Configuration File” 路径 - Web 环境建
info.php（内容为<?php phpinfo(); ?>），访问后搜 “Loaded Configuration File” - 对比两个路径下是否都启用了目标扩展，例如都有
extension=php_curl.dll
典型陷阱：
- 你在
C:\php\php.ini里加了extension=curl，但 Apache 实际加载的是C:\Apache\conf\php.ini - 宝塔用户混淆
/www/server/php/81/etc/php.ini（FPM）和/usr/local/php/etc/php.ini（旧版或 CLI）
扩展 DLL 文件本身依赖 VC++ 运行库和架构匹配
即使 PATH 和 php.ini 都对了，php_swoole.dll 或 php_pgsql.dll 仍可能静默失败。错误日志里不会明说，但 Windows 事件查看器或 Apache 错误日志中会出现“模块初始化失败”类提示。
关键检查点：
- 用
php -v和phpinfo()确认：PHP 是 TS 还是 NTS？是 x64 还是 x86？下载的 DLL 必须完全匹配 - 确认已安装对应版本的 Microsoft Visual C++ Redistributable（如 VS2019 对应 vcruntime140.dll）
- PostgreSQL 扩展需额外把
libpq.dll、libeay32.dll等复制到System32或SysWOW64（x64 系统下注意位数） - 用
Dependency Walker（或lddfor Windows 工具）打开 DLL，看是否有标红的缺失模块
扩展加载失败不报错？去错误日志里翻真实原因
PHP 启动时若扩展加载失败，多数情况不会中断进程，也不会输出到页面或终端，而是记入错误日志。你看到的 “Class 'Redis' not found” 或 “Call to undefined function curl_init()”，只是后果，不是根因。
排查动作：
- CLI 下运行：
php --ri curl，若返回 “Extension 'curl' not found”，说明没加载成功 - Apache 用户查
logs/error.log，搜索PHP Warning: PHP Startup: - Nginx + PHP-FPM 用户查
php-fpm.log或系统日志（journalctl -u php8.1-fpm） - Linux 下可运行：
ldd /usr/lib/php/20220829/curl.so | grep "not found"，定位缺失的共享库
最常被跳过的一步：没确认扩展文件是否真在 extension_dir 指向的路径下。运行 php -i | grep extension_dir 拿到路径，再 dir 或 ls 看一眼——很多问题就卡在这一步。
