PHP连接数据库前必须开启对应扩展:MySQL/MariaDB需启用extension=mysqli和extension=pdo_mysql;PostgreSQL需extension=pgsql和extension=pdo_pgsql;SQLite3通常默认已开;且PDO基础扩展extension=pdo必须启用,否则pdo_mysql等无法工作。

PHP 连接数据库前必须开启的扩展有哪些
不开启对应扩展,mysqli_connect()、pdo_mysql 等函数直接报错 Fatal error: Uncaught Error: Call to undefined function mysqli_connect(),不是代码写错了,是 PHP 根本没加载驱动。
常见扩展按数据库类型区分:
- MySQL / MariaDB:必须启用
extension=mysqli和/或extension=pdo_mysql - PostgreSQL:启用
extension=pgsql和/或extension=pdo_pgsql - SQLite3:启用
extension=sqlite3(通常默认已开)
注意:mysql 扩展(非 mysqli)在 PHP 7.0+ 已彻底移除,强行启用会启动失败。
如何确认 php.ini 路径并修改它
运行 php --ini(命令行)或 phpinfo();(Web 页面),找到 Loaded Configuration File 对应的路径。别改错文件——PHP CLI 和 Web SAPI(如 Apache/Nginx)可能用不同 php.ini。
立即学习“PHP免费学习笔记(深入)”;
修改步骤:
- 用文本编辑器打开该
php.ini - 搜索
;extension=mysqli,删掉前面的分号;(取消注释) - 同样处理
;extension=pdo_mysql(PDO 方式推荐同时开启) - 保存后,必须重启 Web 服务器或 PHP-FPM,否则修改不生效
验证是否成功:执行 php -m | grep -i mysql,应输出 mysqli 和 pdo_mysql。
常见报错与对应配置漏项
以下错误几乎全是扩展未启用或路径不对导致:
-
Class 'PDO' not found→ 没开extension=pdo(基础 PDO 模块,pdo_mysql依赖它) -
Call to undefined function pg_connect()→ 没开extension=pgsql -
Driver not found(PDO 构造时)→ 开了pdo_mysql但没开pdo,或extension_dir指向错误目录 - Windows 下提示
php_mysqli.dll not found→ 检查extension_dir是否指向正确的ext/目录(如C:\php\ext),且 DLL 文件真实存在
Linux 下编译安装 PHP 时的扩展注意事项
如果用源码编译(非包管理器安装),扩展不是靠改 php.ini 就能启用的:
- 编译时需显式加参数,例如:
./configure --with-mysqli --with-pdo-mysql - 若 MySQL 头文件不在默认路径(如 MariaDB 装在
/usr/local/mariadb),要加--with-mysqli=/usr/local/mariadb/bin/mysql_config -
make && make install后,仍需检查生成的php.ini中对应extension=行是否已写入且未注释
Ubuntu/Debian 用户更推荐用 apt install php-mysql,自动处理依赖和配置;CentOS/RHEL 用 yum install php-mysqlnd(mysqlnd 是原生驱动,比 libmysqlclient 更稳定)。
extension=mysqli extension=pdo_mysql ; extension=pgsql # 如需 PostgreSQL,取消此行注释
扩展启用只是第一步,mysqli 和 PDO 的连接方式、错误处理、预处理写法差异很大,别在连通后直接硬写 SQL 字符串拼接。











