跳转到主要内容
约 2 分钟阅读

环境与配置 (Configuration)

Laravel 所有配置文件均集中保存在 config 目录下。每个选项均有详细注释,方便开发者按需查阅与自定义。

环境变量管理

Laravel 使用 DotEnv 库实现配置与代码的分离。在代码中,你可以随时使用 env() 辅助函数获取 .env 中的值:

// 获取环境变量,并提供默认后备值
$debug = env('APP_DEBUG', false);
$dbHost = env('DB_HOST', '127.0.0.1');

读取与修改配置

推荐使用全局 config() 函数从 config 目录下的配置文件中提取数值(采用点语法):

use Illuminate\Support\Facades\Config;

// 读取 config/app.php 中的 timezone
$timezone = config('app.timezone');

// 运行时动态覆写配置(仅在当前请求生命周期内有效)
config(['app.timezone' => 'America/Chicago']);

生产环境性能优化:配置缓存

在生产环境中部署应用时,强烈建议运行配置缓存指令,将所有配置文件整合成单个高效率文件,大幅减少磁盘 I/O:

# 缓存配置
php artisan config:cache

# 清除配置缓存(本地调试时使用)
php artisan config:clear

重要注意:一旦执行了 config:cache,系统将不再动态解析 .env 文件。因此,在业务代码中请始终使用 config('xxx') 读取配置,而不要直接调用 env()