LaravelAPI新手如何配置数据库_Laravel.env数据库配置【教程】-Laravel-PHP中文网

Laravel数据库配置应优先修改.env文件而非config/database.php，需确认APP_ENV非production、DB_HOST适配环境（如Docker填服务名）、DB_DATABASE手动创建、密码不含特殊字符、SQLite路径可写，并用tinker验证连接。

laravelapi新手如何配置数据库_laravel.env数据库配置【教程】

很多人一上来就改 config/database.php，结果改了没用——Laravel 默认优先读 .env 文件里的值，config/database.php 只是兜底和拼接逻辑。你改配置，必须先确认 .env 是否生效。

实操建议：

APP_ENV=local 必须设为 local 或 staging 等非 production 值，否则 Laravel 可能跳过重载 .env
检查 .env 文件是否被 Git 忽略（.gitignore 里通常有 .env），避免误提交或本地没生效
改完 .env 后运行 php artisan config:clear，否则缓存会掩盖修改
DB_CONNECTION=mysql 要和实际驱动一致；如果用 PostgreSQL，这里得是 pgsql，不能只改下面的 host/port

本地开发用 Docker、Valet、Homestead 时，localhost 指的是容器/虚拟机自身，不是宿主机的 MySQL。常见错误现象：启动 API 报错 SQLSTATE[HY000] [2002] Connection refused。

实操建议：

Docker 环境下，DB_HOST 填服务名，比如 mysql（对应 docker-compose.yml 里 service 的名字）
Homestead/Valet 用 127.0.0.1，而不是 localhost（避免 socket 连接干扰）
Mac 上用 MAMP 或 Sequel Ace 直连，确认端口是不是默认的 3306；MAMP 常用 8889，这时要同步改 DB_PORT=8889
密码含特殊字符（如 @、/）会导致 URL 解析失败，用 DB_PASSWORD 单独配比写进 DB_URL 更稳

Laravel 不会自动建库，php artisan migrate 报 Database does not exist 就是因为这个。新手常以为“跑 migrate 就行”，结果卡在第一步。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

实操建议：

MySQL 命令行执行 CREATE DATABASE your_db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;，别依赖工具点点点
DB_DATABASE 值必须和你创建的库名完全一致（区分大小写，Linux 下尤其注意）
用 DB_USERNAME 登录 MySQL 控制台，手动执行 SHOW DATABASES; 验证库是否存在、权限是否够
如果用 SQLite，DB_DATABASE 是路径，比如 database/database.sqlite，确保目录存在且可写

API 报 500 错误，不一定是路由或控制器问题，很可能是数据库根本没连上。与其看日志猜，不如直接进交互环境验证。

实操建议：

运行 php artisan tinker，然后输入 DB::connection()->getPdo(); —— 成功返回 PDO 实例，失败抛异常，信息比 Web 请求清晰得多
如果报 SQLSTATE[HY000] [1045] Access denied，重点查 DB_USERNAME 和 DB_PASSWORD 是否输错，空格、换行容易藏在复制粘贴里
加 DB_LOG=true 到 .env，再跑一次 tinker + 查询，就能看到完整 SQL 和绑定参数，方便定位慢查询或字段缺失