

新闻资讯
技术学院Laravel等PHP框架数据库连接核心依赖PDO或MySQLi扩展,配置以.env为准,需确保驱动启用、host用127.0.0.1而非localhost、字符集设utf8mb4、校对集与前缀正确,FPM下禁用持久连接。
PHP 主流架构(Laravel、ThinkPHP、CodeIgniter 等)连接数据库,核心不是“选哪个框架”,而是统一落在 PDO 或 MySQLi 驱动上——框架只是封装了配置加载和连接管理逻辑。直接改配置文件就能生效,不需要重写底层代码。
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 或某些生僻字会丢数据框架底层依赖 PHP 扩展。没启用对应扩展,哪怕配置全对,也会报 Class 'PDO' not found 或 Driver not found 错误。
php -m | grep pdo 查看是否加载 pdo 及 pdo_mysql
php.ini 中是否取消注释:extension=pdo.so(macOS/Linux)或 extension=php_pdo.dll(Windows)PDO,ThinkPHP 5+ 也默认走 PDO;只有原生 PHP 或老项目才可能用 mysqli_connect()
PHP-FPM 是进程/线程模型,每次请求结束会释放数据库连接。所谓“长连接”(PDO::ATTR_PERSISTENT => true)在 FPM 下反而容易引发连接泄漏和状态污染,官方文档明确不推荐。
database.php 里手动加 'options' => [PDO::ATTR_PERSISTENT => true]
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