PHP扩展加载方法详解

文章不知道大家是否熟悉？今天我将给大家介绍《PHP扩展如何加载到配置中》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

PHP扩展未加载时需依次确认扩展文件路径、编辑php.ini启用扩展、必要时用绝对路径配置、重启服务、最后验证加载成功。

如果您在运行PHP脚本时遇到“Call to undefined function”错误，或通过phpinfo()发现所需扩展未启用，则很可能是PHP扩展未正确加载到配置中。以下是将PHP扩展加载到配置中的具体操作步骤：

一、确认扩展文件存在并获取其路径

PHP扩展以动态库形式存在（Linux/macOS为.so文件，Windows为.dll文件），需先确认扩展文件已编译或安装完成，并定位其物理路径。该路径将用于php.ini中extension指令的值。

1、打开终端或命令提示符，执行命令：php -i | grep "extension_dir"，获取当前PHP扩展目录路径。

2、进入该目录，执行ls -l | grep 扩展名（如mysqli、gd、redis等）确认对应.so或.dll文件是否存在。

3、若扩展文件不在extension_dir目录下，需将其复制至该目录，或记录其完整绝对路径供后续配置使用。

二、编辑php.ini文件启用扩展

php.ini是PHP主配置文件，extension指令在此文件中声明后，PHP启动时才会加载对应扩展。必须确保修改的是CLI和Web服务器实际加载的php.ini文件，而非备份或错误路径下的副本。

1、执行php --ini查看已加载的配置文件路径，重点关注“Loaded Configuration File”行显示的路径。

2、用文本编辑器（如vim、Notepad++）打开该php.ini文件。

3、在文件中查找以;extension=开头的注释行，找到目标扩展对应的行（如;extension=mysqli或;extension=gd）。

4、删除该行开头的分号（;），取消注释；若该行不存在，则在文件末尾新增一行，格式为：extension=扩展名（Linux/macOS）或extension=扩展名.dll（Windows）。

5、保存php.ini文件。

三、使用绝对路径方式加载扩展（适用于非标准路径）

当扩展文件位于extension_dir之外，或多个PHP版本共存导致路径冲突时，可直接在php.ini中指定扩展的完整绝对路径，避免依赖extension_dir设置。

1、确认扩展文件的绝对路径，例如Linux下为/usr/local/php/ext/redis.so，Windows下为C:\php\ext\php_redis.dll。

2、在php.ini中新增一行，格式为：extension=/usr/local/php/ext/redis.so（Linux/macOS）或extension=C:\php\ext\php_redis.dll（Windows）。

3、确保路径中不包含中文、空格或特殊字符，否则可能导致加载失败。

四、重启Web服务器或PHP服务进程

PHP配置变更仅在进程启动时读取，修改php.ini后必须重启相关服务，使新配置生效。不同环境对应不同服务管理方式。

1、Apache环境下：执行sudo apachectl restart（macOS/Linux）或在Windows服务管理器中重启Apache服务。

2、Nginx + PHP-FPM环境下：执行sudo systemctl restart php-fpm（Linux systemd）或sudo service php7.4-fpm restart（Ubuntu旧版）。

3、CLI模式验证：执行php -m | grep 扩展名（如grep redis），确认扩展已列出。

五、验证扩展是否成功加载

最终需通过运行时检查确认扩展功能可用，排除配置语法错误或依赖缺失等隐性问题。

1、创建一个PHP文件（如check.php），内容为：