Laravel怎么配置数据库连接_Laravel修改env文件连接MySQL【基础】

修改 .env 文件是最直接的数据库配置方式，需正确设置 DB_CONNECTION、DB_HOST 等参数，并执行 php artisan config:clear 清除缓存，否则配置不生效；切勿硬编码 config/database.php。

修改 .env 文件是最直接的数据库配置方式

laravel 启动时默认从 .env 文件读取数据库连接参数，而不是直接改 config/database.php。改配置前先确认项目根目录下存在 .env 文件（若没有，复制 .env.example 并重命名）。

关键配置项如下：

• DB_CONNECTION=mysql —— 必须为 mysql，否则即使装了 MySQL 也会报 Driver [mysql] not supported
• DB_HOST=127.0.0.1 —— 不建议用 localhost，PHP 的 MySQL 扩展会尝试走 socket 连接，容易因权限或路径失败
• DB_PORT=3306 —— 如果 MySQL 装在 docker 或非标端口，必须显式写对
• DB_DATABASE=your_db_name —— 数据库需已手动创建，Laravel 不会自动建库
• DB_USERNAME=root 和 DB_PASSword= —— 密码含特殊字符（如 @、/）时，整个值要用双引号包裹，例如 DB_PASSWORD="p@ss/w0rd"

php artisan config:clear 是验证修改是否生效的关键步骤

改完 .env 后不能直接刷新网页看效果——Laravel 会缓存配置。不清理缓存，哪怕 .env 写错了也还是旧连接。

执行以下命令：

php artisan config:clear

如果使用了配置缓存（比如线上环境跑过 php artisan config:cache），还需补一句：

php artisan config:cache

常见误操作：

• 只改了 .env 就去访问页面，报 SQLSTATE[HY000] [1045] access denied 却以为是账号错，其实是缓存没清
• 在 Homestead/Valet 等环境里改了宿主机的 .env，但实际运行的是虚拟机里的代码，该改的是 VM 里的文件
• 用 ide 自带终端执行命令，但当前工作目录不是项目根目录，导致命令无效

连接失败时优先检查 MySQL 服务状态和用户权限

Laravel 报 Connection refused 或 Access denied，大概率不是 Laravel 配置问题，而是底层连不上。

快速排查顺序：

• 终端执行 mysql -h 127.0.0.1 -P 3306 -u root -p，能登录说明服务正常、账号可用；连不上则先查 MySQL 是否运行、防火墙是否放行端口
• 确认用户有对应数据库的权限：GRANT ALL ON your_db_name.* TO 'root'@'%'; FLUSH PRIVILEGES;（本地开发用 'root'@'127.0.0.1' 更安全）
• Docker 环境注意网络模式：如果 Laravel 容器和 MySQL 容器不在同一 network，DB_HOST 不能填 127.0.0.1，得填 MySQL 容器名（如 mysql）
• Mac M1 用户若用 Homebrew 装 MySQL，mysqld 默认绑定 ::1（ipv6），而 PHP MySQL 扩展可能只走 IPv4，此时 DB_HOST 改成 127.0.0.1 比 localhost 更可靠

config/database.php 里不要硬编码数据库参数

这个文件只是配置的“模板”，所有真实值应来自 .env。比如 MySQL 相关部分长这样：

'mysql' => [     'driver' => 'mysql',     'url' => env('DATABASE_URL'),     'host' => env('DB_HOST', '127.0.0.1'),     'port' => env('DB_PORT', '3306'),     'database' => env('DB_DATABASE', 'forge'),     'username' => env('DB_USERNAME', 'forge'),     'password' => env('DB_PASSWORD', ''),     // ... ],

如果你把 'host' => '192.168.1.100' 这样写死在这里，.env 的 DB_HOST 就完全失效了。多人协作或部署到不同环境时，这种写法会导致配置无法隔离。

唯一合理修改 config/database.php 的场景是：需要动态切换连接（比如按租户路由到不同库）、或启用 pdo 层级选项（如 'options' => [PDO::ATTR_EMULATE_PREPARES => false]）。

真正容易被忽略的是：有些团队把 .env 提交到 git，导致测试库密码泄露；或者在 CI/CD 中忘了注入 .env 变量，结果跑测试时连的是本地空库。