如何在 Laravel Sail 中正确连接 MySQL 数据库-php教程-PHP中文网

如何在 Laravel Sail 中正确连接 MySQL 数据库

Laravel Sail 使用 Docker 网络隔离，应用容器需通过服务名 mysql（而非 localhost 或 127.0.0.1）访问数据库容器，.env 中 DB_HOST=mysql 是关键配置。

laravel sail 使用 docker compose 构建多容器开发环境，其中应用（`laravel.test`）与数据库（`mysql`）运行在独立容器中，且同属 `sail` 自定义桥接网络。此时，容器间通信必须使用服务名称作为主机名——`localhost` 或 `127.0.0.1` 指向当前容器自身，而非数据库容器，因此无法建立连接。

✅ 正确配置 .env 数据库参数

将 .env 文件中的 DB_HOST 明确设为 mysql（即 docker-compose.yml 中定义的 service name）：

DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3307
DB_DATABASE=myDb
DB_USERNAME=sail
DB_PASSWORD=password

? 注意：DB_PORT 值（如 3307）是宿主机映射端口，而 Laravel 应用容器内连接 MySQL 容器时，实际访问的是容器内默认 MySQL 端口 3306 —— 但 Sail 的 mysql 服务已自动配置为监听 3306，因此 DB_PORT 在容器内通信中通常可省略或保持默认 3306；若显式指定 DB_PORT=3307，仅当应用容器主动尝试连接宿主机 3307 时才生效（错误路径）。推荐统一使用：
DB_PORT=3306  # 容器内直连 mysql:3306，更可靠

? 验证连接是否生效

修改配置后，务必重启 Sail 并清除配置缓存：

./vendor/bin/sail up -d
./vendor/bin/sail artisan config:clear
./vendor/bin/sail artisan tinker

在 Tinker 中测试连接：

MySQL（Linux）

MySQL 9.6.0是面向Linux平台的2026年创新版本，核心架构迎来重大革新。其将外键约束与级联操作从InnoDB引擎层上移至SQL层，确保所有数据变更均被完整记录至Binlog，彻底解决了CDC（变更数据捕获）与主从复制中的数据不一致难题。此外，该版本引入container_aware启动选项以原生适配容器环境，并对审计日志进行了组件化重构，为追求极致数据一致性与云原生体验的开发者提供了全新选择。

下载

>>> DB::connection()->getPdo();
=> PDO {#304}

若抛出异常，请检查：

.env 是否已重载（执行 config:clear 后再试）；
docker-compose.yml 中 mysql 服务的 environment 是否与 .env 一致（尤其 MYSQL_USER/MYSQL_PASSWORD）；
运行 ./vendor/bin/sail ps 确认 mysql 容器状态为 healthy。