Laravel 的配置信息

基础介绍

Laravel 框架的所有配置文件都放置在 config 目录下

环境配置

.env 文件作为 Laravel 的全局环境配置文件,位于根目录下

Laravel 使用 Vance Lucas 的 DotEnv PHP 函数库来实现项目内环境变量的控制
新建一个 .env.testing 文件。在运行 PHPUnit 测试或者带有 --env=testing 选项运行 Artisan 命令的时候,这个
.env.testing 文件会覆盖掉 .env 文件对应的值

配置参数

//应用名称
APP_NAME=Laravel
// 运行环境名称
APP_ENV=local
// 调试模式,开发阶段启用,上线状态禁用。
APP_DEBUG=true
// 敏感信息加密密钥,可使用 php artisan key:generate 重新生成。
APP_KEY=
// 设置等级日志,默认所有等级
APP_LOG_LEVEL=debug
// 项目根目录
APP_URL=http://localhost

//广播驱动设置
BROADCAST_DRIVER=log
// 缓存驱动,默认使用文件作为缓存。
CACHE_DRIVER=file
// 回话驱动,默认使用文件存储SESSION。
SESSION_DRIVER=file
// 队列驱动,默认使用同步模式。
QUEUE_DRIVER=sync

// Redis高性能key-value数据库,使用内存存储,用于数据持久化。
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

// 数据库配置项
DB_HOST=127.0.0.1//数据库主机名
DB_PORT=3306//数据库端口
DB_DATABASE=homestead//数据库名称
DB_USERNAME=homestead//数据库登录账户
DB_PASSWORD=secret//数据库登录密码

//邮件配置
MAIL_DRIVER=smtp //邮件发送驱动
MAIL_HOST=smtp.mailtrap.io //邮箱所在主机
MAIL_PORT=2525 //邮箱发送服务端口号
MAIL_USERNAME=null //邮箱账号
MAIL_PASSWORD=null //邮箱密码
MAIL_ENCRYPTION=null //加密类型

//配置事件广播
PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=

获取环境变量

通过函数 env() 获取

'debug' => env('APP_DEBUG', false),

.env 文件可看作对 /config/ 目录下的通用配置做的提取

数据库前缀设置

.env 文件中新增 DB_PREFIX 配置, 并在/config/database.php 修改 prefix 选项为 env(DB_PREFIX,'')

判断目前使用的环境

应用程序的当前环境由 .env 文件中的 APP_ENV 变量所决定

获取

$environment = App::environment();

判断

if (App::environment('local')) {
    // 当前正处于本地开发环境
}

if (App::environment('local', 'staging')) {
    // 当前环境处于 `local` 或者 `staging`
}

获取设置值

通过函数 config() 获取配置

使用config()可获取/config/目录下项目的配置项信息。

config('database.connections.mysql.prefix')

$value = config('app.timezone');

修改设置值

config(['app.timezone' => 'America/Chicago']);

配置缓存信息

使用以下 Artisan 自带命令,把 config 文件夹里所有配置信息合并到一个文件里,减少运行时文件的载入数量:

php artisan config:cache

上面命令会生成文件 bootstrap/cache/config.php,可以使用以下命令来取消配置信息缓存:

php artisan config:clear

注意:此命令不应该在开发时运行。 因为设置选项会在开发时经常变动。

维护模式

维护模式应用

当应用程序处于维护模式时,所有传递至应用程序的请求都会显示出一个自定义视图。用于更新应用或进行性能维护,可以轻松 关闭 整个应用程序。如果应用程序处于维护模式 则会抛出 503 的状态码。

启用维护模式

php artisan down

可以指定 down 命令的 messageretry 选项。 message 自定义显示给用户的信息, retry 作为 Retry-After HTTP 标头返回:

php artisan down --message='Upgrading Database' --retry=60

关闭维护模式

php artisan up

维护模式的响应模板

维护模式的默认模板放在 resources/views/errors/503.blade.php。你可以根据你的需求来修改这个模版

维护模式与队列

当应用程序处于维护模式中时,将不会处理任何 队列工作。所有的队列工作将会在应用程序离开维护模式后被继续运行。

维护模式的替代方案

维护模式有几秒钟的服务器不可用时间,如果你想做到平滑迁移的话,推荐使用 Envoyer 服务。

你可能感兴趣的:(Laravel 的配置信息)