PHP本地环境添加扩展步骤详解

一分耕耘，一分收获！既然都打开这篇《PHP本地环境添加扩展模块方法》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

Windows下添加PHP扩展需严格匹配版本、架构和线程安全类型，并将DLL放入php.ini中extension_dir指定路径，再在php.ini中以extension=redis形式启用。

Windows 下用 XAMPP、WAMP 或手动编译的 PHP，添加扩展模块本质就两步：把 .dll（Windows）或 .so（Linux/macOS）文件放进扩展目录，再在 php.ini 里启用它。但实际卡住的地方，90% 出在版本不匹配或路径写错。

确认 PHP 版本和线程安全（TS/NTS）类型

扩展必须和当前 PHP 严格匹配：主版本（如 8.1）、次版本（如 8.1.23）、架构（x64/x86）、线程模型（TS 或 NTS）。错一个就报 PHP Warning: PHP Startup: Unable to load dynamic library 或直接启动失败。

• 运行 php -v 看主版本号
• 运行 php -i | findstr "Thread Safe"（Windows）或 php -i | grep "Thread Safe"（Linux/macOS）确认是 enabled（TS）还是 disabled（NTS）
• 运行 php -i | grep "Architecture" 确认是 x86 还是 x64
• 去 PECL 官网 下载对应包，比如 redis-5.3.7-8.1-ts-vs16-x64.zip 中的 8.1 是 PHP 版本，ts 是线程安全，vs16 是编译器版本（XAMPP 通常用 vs16），x64 是架构

把扩展文件放到正确目录并修改 php.ini

别凭感觉写路径。先查真实扩展目录：

php --ini

输出里会显示 Loaded Configuration File（即你正在用的 php.ini）和 Scan for additional .ini files in。扩展文件要放的位置是 extension_dir 的值，不是 php.ini 所在目录。

• 运行 php -r "echo ini_get('extension_dir');" 获取准确路径，例如 C:\xampp\php\ext
• 解压下载的 PECL 包，把里面的 php_redis.dll（Windows）或 redis.so（Linux）复制到该 ext 目录下
• 打开 php.ini，找到 ;extension=mbstring 这类行，在下面新增一行：extension=redis（注意：不要写 .dll 或 .so 后缀，也不要用绝对路径）
• 如果扩展有依赖（如 igbinary），必须先加载依赖：extension=igbinary 再 extension=redis

验证是否加载成功

改完 php.ini 后必须重启 Web 服务（Apache/Nginx）或 CLI 服务，否则无效。验证方式不止一种：

• 命令行执行 php -m | findstr redis（Windows）或 php -m | grep redis（Linux/macOS），看到 redis 表示已加载
• 写个 info.php 文件：

  <?php phpinfo(); ?>

  ，浏览器访问，搜索 “redis” 或对应扩展名，看是否有完整模块信息块
• 如果只显示 extension=redis 但没模块页，常见原因是 DLL 文件被杀毒软件拦截、权限不足、或 php.ini 被多个地方加载覆盖（比如 Apache 的 httpd.conf 里又指定了另一个 php.ini）

最常被忽略的是：XAMPP/WAMP 的控制面板里点“Restart”未必真正重载了 PHP 配置，有时得手动关掉所有 Apache 进程再启动；另外，CLI 和 Web 使用的 php.ini 很可能不是同一个文件，php --ini 和 phpinfo() 显示的路径必须一致才可靠。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP本地环境添加扩展步骤详解》文章吧，也可关注golang学习网公众号了解相关技术文章。