修改 .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 配置问题,而是底层连不上。