Windows下启用PHP扩展最省事:直接在php.ini中取消extension=php_curl.dll等行的分号;Linux则需用包管理器、pecl或源码编译,且.so文件必须与PHP ABI严格匹配。

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 几乎必失败。
推荐方式按优先级排序:
立即学习“PHP免费学习笔记(深入)”;
- 用系统包管理器: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 更隐蔽。











