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文件是否存在。
立即学习“PHP免费学习笔记（深入）”；
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），内容为：
2、在Web服务器中访问该文件，或执行php check.php，输出bool(true)表示扩展已加载成功。
3、若输出bool(false)，检查PHP错误日志（由error_log指令指定），常见原因包括扩展文件权限不足、依赖库缺失（如libpng未安装）、PHP版本与扩展不兼容。
