Laravel 环境配置：.env 文件与数据库连接详解

Laravel 环境变量机制

Laravel 项目根目录下存在一个 .env 文件，它用于存储敏感或随环境变化的配置信息，如数据库凭证、应用密钥等。框架通过 config/database.php 等配置文件加载这些值。

在代码中使用 env('DB_HOST', 'localhost') 时，第一个参数为键名，第二个参数 'localhost' 为缺省值（Default Value）。若 .env 文件中未定义该键，则返回缺省值；若已定义，则返回文件中指定的值。这种机制确保了配置的可移植性和安全性，建议避免硬编码敏感信息。

配置 MySQL 数据库连接

默认情况下，Laravel 可能配置了 SQLite 或其他数据库驱动。若要使用 MySQL，需进行以下操作：

第1步：修改 .env 文件

打开项目根目录的 .env 文件，找到数据库相关字段并修改为你实际的 MySQL 配置：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

• DB_HOST：数据库服务器地址，本地通常为主机地址。
• DB_DATABASE：目标数据库名称，需提前在 MySQL 中创建。
• DB_USERNAME：数据库用户，默认为 root。
• DB_PASSWORD：数据库密码，为空表示无密码（仅适用于本地测试环境）。

第2步：创建数据库实例

在修改完配置后，需在 MySQL 服务端创建对应的数据库。可通过命令行工具执行以下 SQL 语句：

mysql -u root -p
CREATE DATABASE laravel;

若系统提示输入密码，请输入你设置的 MySQL root 用户密码。创建完成后，laravel 数据库即准备就绪。

第3步：验证 config/database.php 配置

查看 config/database.php 文件中关于 MySQL 的配置片段，确认其正确引用了环境变量：

'mysql' => [
    'driver'  => 'mysql',
    'host'   => env('DB_HOST', 'localhost'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset'  => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix'  => '',
    'strict'  => true,
],

注意：现代 Laravel 版本通常建议使用 utf8mb4 字符集以支持完整的 Unicode 表情符号，且 strict 模式默认开启以保证数据严谨性。若你的配置与此不同，可根据实际需求调整。

注意事项

• 配置缓存：在生产环境中，为了提高性能，Laravel 会将所有环境变量合并到 bootstrap/cache/config.php 文件中。若在修改 .env 后感觉配置未生效，可尝试运行 php artisan config:clear 清除缓存。
• 安全提醒：永远不要将 .env 文件提交到版本控制系统（如 Git），应确保它在 .gitignore 列表中，防止数据库密码泄露。

以上就是 Laravel .env 文件配置与数据库连接的详细内容，更多关于 Laravel 基础教程的资料请关注本站其它相关文章！