PHP扩展安装方法：Windows与Linux区别详解

本文深入解析了PHP扩展在Windows与Linux系统下的安装差异与实操要点：Windows只需在php.ini中取消对应.dll扩展行的分号并确保VC运行时和extension_dir路径正确，操作简洁但需注意版本兼容性；Linux则必须通过包管理器（如apt/yum）、pecl或源码编译安装.so文件，且对PHP ABI（ZTS、主版本、线程模型）要求严苛，严禁直接复制.so文件。文章还强调了跨平台常见陷阱——如php.ini实际加载路径混淆、CLI与Web环境配置分离、模块名大小写及前缀差异，并提供了php --ini、php -m、function_exists()等多重验证手段，帮助开发者快速定位和解决扩展加载失败问题。

Windows 下直接用 php.ini 启用拓展最省事

Windows 版 PHP 通常自带常用拓展的 .dll 文件，比如 php_curl.dll、php_mysqli.dll，放在 ext/ 目录下。你只需打开 php.ini，去掉对应行前面的分号即可：

;extension=php_curl.dll → 改成 → extension=php_curl.dll

改完重启 Web 服务（如 Apache 或 Nginx + PHP-FPM），用 php -m 或 phpinfo() 验证。注意两点：

• extension_dir 必须指向正确的 ext/ 路径，比如 extension_dir = "C:\php\ext"
• 某些拓展（如 php_opcache.dll）依赖 VC 运行时版本，必须和 PHP 编译时用的 VC 版本一致（常见是 VC15/VC16），否则启动时报 The specified module could not be found

Linux 下得编译或包管理器安装，不能直接复制 .so

Linux 没有“开箱即用”的二进制拓展包，.so 文件必须和当前 PHP 的 ABI（主要是 ZTS、线程模型、PHP 主版本）严格匹配。直接从别处拷 .so 几乎必失败。

推荐方式按优先级排序：

• 用系统包管理器：Ubuntu/Debian 上 sudo apt install php-curl php-mbstring；CentOS/RHEL 上 sudo yum install php-curl php-mbstring —— 自动处理依赖和路径
• 用 pecl 安装：比如 pecl install redis，但需确保已安装 php-dev（Ubuntu）或 php-devel（CentOS）
• 手动编译：下载源码后 phpize && ./configure && make && sudo make install，然后在 php.ini 加 extension=redis.so

关键点：phpize 必须来自当前 PHP 对应的安装目录，否则生成的 .so 会加载失败，报错类似 undefined symbol: php_json_decode_ex。

跨平台装拓展最常踩的坑：php.ini 位置和模块名大小写

很多人在 Linux 上改了错的 php.ini，或者 Windows 上写了错误的模块名，导致拓展始终不生效。

• 查真实生效的 php.ini：运行 php --ini（CLI）或 phpinfo()（Web），看 “Loaded Configuration File”
• Linux 拓展名通常是小写无前缀，比如 extension=mysqli；Windows 是带 php_ 前缀的 .dll 名，比如 extension=php_mysqli.dll
• 部分拓展在 CLI 和 Web SAPI 下配置文件不同（尤其 Ubuntu 的 /etc/php/*/cli/php.ini 和 /etc/php/*/apache2/php.ini），要分别确认

扩展是否装成功？别只信 phpinfo()，用命令行交叉验证

phpinfo() 显示的是 Web 环境下的配置，而 php -m 显示的是 CLI 环境，两者可能不一致。更可靠的方式是：

• 查模块是否被识别：php -m | grep curl
• 查具体函数是否存在：php -r "var_dump(function_exists('curl_init'));"
• 查扩展加载错误：php -v 启动时如果有 PHP Warning: Unable to load dynamic library 就说明路径或依赖出问题了

特别是用 pecl 安装后没加 extension=xxx.so 到 php.ini，或者 so 所在目录不在 extension_dir 中，php -m 就完全看不到它——这点比 Windows 更隐蔽。

到这里，我们也就讲完了《PHP扩展安装方法：Windows与Linux区别详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！