PHP扩展未加载导致CodeIgniter数据库连接失败,需确认php.ini路径、extension_dir、扩展文件名及版本匹配,重启Apache并验证扩展是否生效,MySQL 8.0+认证协议不兼容时需降级用户认证方式或升级PHP。

PHP扩展没加载,phpinfo() 里找不到 mysqli 或 pdo_mysql
CodeIgniter 启动报错“Unable to connect to your database server using the provided settings”之类,八成不是 CI 配置问题,而是底层 PHP 扩展根本没启用。Windows 下常见原因是 php.ini 指向错误或扩展路径不对。
实操建议:
- 确认你改的是实际被加载的
php.ini:运行php --ini看 Loaded Configuration File 路径,别只改了 Apache 目录下的副本 - 检查
extension_dir是否指向真实存在的目录,比如C:phpext(注意反斜杠要写成C:/php/ext或双反斜杠C:\php\ext) - 开启扩展时用完整文件名:
extension=php_mysqli.dll,不是extension=mysqli—— Windows 不支持简写 - 确保
php_mysqli.dll文件真在ext/目录下,且和 PHP 版本、线程安全(TS/NTS)、架构(x64/x86)完全匹配
Apache + PHP 重启后扩展仍不生效
改完 php.ini 以为就完了?Windows 上经常因为服务没真正重载导致配置白改。尤其用 XAMPP/WAMP 时,界面点“Restart”可能只重启了 Apache,没触发 PHP 模块重载。
实操建议:
- 先用命令行验证:
php -m | findstr mysqli(Windows CMD),如果命令行能列出来,说明 PHP 自身没问题,问题出在 Web 服务器集成环节 - Apache 需要同时加载
php_module并指定PHPIniDir,检查httpd.conf是否有这两行且路径正确:LoadModule php_module "C:/php/php8apache2_4.dll"<br>PHPIniDir "C:/php"
- WAMP 用户右键托盘图标 → “PHP” → “Version” → 切换一次再切回来,强制重载所有 PHP 设置
CodeIgniter 报 Call to undefined function mysqli_init()
这个错误说明 PHP 解释器识别到了 mysqli 扩展名,但函数不可用——典型是扩展加载失败后被静默忽略,或者启用了 mysql(已废弃)却没关掉它,造成冲突。
实操建议:
- 在
php.ini中搜索并注释掉所有extension=php_mysql.dll(PHP 7+ 已移除)或extension=mysql行 - 确认没有重复加载:同一份
php.ini里不要既有extension=mysqli又有extension=php_mysqli.dll - 如果用了 XAMPP,检查是否开启了“PHP Extensions”面板里的
mysqli和PDO MySQL两项(勾选状态必须对应php.ini中的启用行)
CI 连接数据库时提示 Client does not support authentication protocol requested by server
这不是 CodeIgniter 的锅,也不是扩展没装好,而是 MySQL 8.0+ 默认用 caching_sha2_password 认证插件,而旧版 PHP 的 mysqli 扩展(尤其是 PHP 7.2 之前)压根不认这个协议。
实操建议:
- 临时方案:在 MySQL 里把用户认证方式降级:
ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
- 长期方案:升级 PHP 到 7.4+(推荐 8.1+),它们的
mysqli已支持caching_sha2_password - 别试图在 CI 的数据库配置里加
'encrypt' => true来绕过——这只会让连接更早失败
php.ini。这三个点反复核对两遍,比查 CI 文档管用得多。










