【PHP框架 | Laravel8 系列2】 - 配置文件简介

前言：之前在学习并使用 Laravel 框架过程中，全是碎片化掌握，现在重新学习并记录一次学习的过程。

本文内容对应 Laravel8.* 版本。

直达入口：

• Laravel 框架专栏
• Laravel 框架官网

一、介绍

Laravel 框架的所有配置文件都保存在 config 目录中。

.env 文件保存着配置所用的变量及值，.env 文件不应该提交至版本控制，因为每个人的本地配置不一样，除非同用一个虚拟环境、镜像啥的。

• config 目录
  • app.php 框架配置文件
  • auth.php 验证配置文件
  • broadcasting.php 广播事件配置文件
  • cache.php 缓存配置文件
  • cors.php 跨域共享配置文件
  • database.php 数据库配置文件
  • filesystems.php 文件系统配置文件
  • hashing.php 哈希配置文件
  • logging.php 日志配置文件
  • mail.php 邮件配置文件
  • queue.php 队列配置文件
  • sanctum.php 请求验证配置文件
  • services.php 第三方服务配置存储文件
  • session.php session 配置文件
  • view.php 视图配置文件

---

二、环境配置

2.1 环境变量类型

如果需要使用包含空格的配置值，则需要使用双引号括起来。

APP_NAME="My Blog"
1

2.2 检索环境配置

使用 env 函数获取配置值，第二个参数是“默认值”，如果获取的配置不存在，则值用“默认值”。

# 获取 .env 文件中的配置
$app_name = env('APP_NAME', 'New Blog');

# 或

# 获取 config 目录中文件内的配置，使用「点」语法。
$app_name = config('app.name');
$auth_default = config('auth.defaults');

# 设置
config(['app.name' => 'New Blog']);
1
2
3
4
5
6
7
8
9
10
11

2.3 当前环境变量

当前应用程序环境通过 .env 文件中 APP_ENV 变量值确定的。

可通过 APP::environment() 来获取。

if (App::environment('local')) {
 // 本地环境
}
if (App::environment(['local', 'staging'])) {
 // 本地环境或临时环境
}
1
2
3
4
5
6

---

三、维护配置

3.1 启用维护模式

php artisan down
1

3.2 关闭维护模式

php artisan up
1

3.3 定义 token 绕过维护模式

# 自定义 token 并开启维护模式
php artisan  down --secret="自定义的 token"
1
2

# 使用 token 绕过维护模式

http://test.com/自定义的 token
1
2
3

3.4 自定义维护模式展示的视图

php artisan down --render="errors::503"
1

3.5 重定向维护模式的请求

php artisan down --redirect=https://www.baidu.com

php artisan down --redirect=/
1
2
3