Laravel等PHP框架数据库连接核心依赖PDO或MySQLi扩展,配置以.env为准,需确保驱动启用、host用127.0.0.1而非localhost、字符集设utf8mb4、校对集与前缀正确,FPM下禁用持久连接。

PHP 主流架构(Laravel、ThinkPHP、CodeIgniter 等)连接数据库,核心不是“选哪个框架”,而是统一落在 PDO 或 MySQLi 驱动上——框架只是封装了配置加载和连接管理逻辑。直接改配置文件就能生效,不需要重写底层代码。
数据库配置文件怎么写(以 Laravel 为例)
Laravel 的数据库配置集中在 .env 和 config/database.php,实际生效以 .env 为准。常见错误是只改了 config/database.php 却忽略 .env,导致配置不生效。
-
DB_CONNECTION=mysql:必须与安装的驱动匹配;若用 PostgreSQL,得改成pgsql,且确保已启用pdo_pgsql扩展 -
DB_HOST=127.0.0.1:不要写localhost(在某些 Linux + MySQL 组合下会强制走 socket,而非 TCP,导致超时) -
DB_PORT=3306:Docker 或云数据库常改端口,务必核对 -
DB_CHARSET=utf8mb4:必须设为utf8mb4,utf8是 MySQL 的假 utf8(仅支持 3 字节),存 emoji 或某些生僻字会丢数据
PDO 和 MySQLi 驱动怎么确认是否启用
框架底层依赖 PHP 扩展。没启用对应扩展,哪怕配置全对,也会报 Class 'PDO' not found 或 Driver not found 错误。
- 运行
php -m | grep pdo查看是否加载pdo及pdo_mysql - Apache 环境下,需检查
php.ini中是否取消注释:extension=pdo.so(macOS/Linux)或extension=php_pdo.dll(Windows) - MySQLi 不是 PDO 的替代品,而是另一套 API;Laravel 强制要求
PDO,ThinkPHP 5+ 也默认走PDO;只有原生 PHP 或老项目才可能用mysqli_connect()
连接池和长连接要不要开
PHP-FPM 是进程/线程模型,每次请求结束会释放数据库连接。所谓“长连接”(PDO::ATTR_PERSISTENT => true)在 FPM 下反而容易引发连接泄漏和状态污染,官方文档明确不推荐。
立即学习“PHP免费学习笔记(深入)”;
- 不要在
database.php里手动加'options' => [PDO::ATTR_PERSISTENT => true] - 真正需要连接复用的场景(如 CLI 命令、Swoole 长生命周期服务),才考虑用
Swoole\Coroutine\MySQL或连接池组件(如hyperf/database) - 高并发下连接数打满?优先调
max_connections和wait_timeout,而不是硬上持久连接
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=testdb DB_USERNAME=root DB_PASSWORD=secret DB_CHARSET=utf8mb4 DB_COLLATION=utf8mb4_unicode_ci DB_PREFIX=tp_
配置项里最易被跳过的其实是 DB_COLLATION 和 DB_PREFIX:前者影响 ORDER BY 和索引排序行为,后者一旦设错,所有查询表名都找不到——而且错误提示里通常不直接说“表不存在”,而是报 SQLSTATE[42S02]: Base table or view not found,得倒回去一行行核对。










