Laravel Lumen 安装及配置 及 Laravel5.5中文文档

Laravel5.5中文文档  路由 | 基础功能 |《Laravel 5.5 中文文档 5.5》| Laravel China 社区

参考网址：数据库 | 更多功能 |《Lumen 中文文档 5.5 5.5》| Laravel China 社区

---

安装

环境要求

Lumen 框架对系统有几点要求。当然，所有的要求虚拟机 Laravel Homestead 都可以满足，所以我们强烈推荐你使用 Homestead 作为你的本地开发环境。

但如果你暂时没有使用 Homestead 环境开发，那么请必须满足以下条件：

• PHP >= 7.0
• OpenSSL PHP 扩展
• PDO PHP 扩展
• Mbstring PHP 扩展

安装 Lumen

Lumen 使用 Composer 来管理代码依赖。所以，在使用 Lumen 之前，请先确认你的电脑上安装了 Composer。

通过 Lumen 安装器

首先，使用 Composer 下载 Lumen 安装包：

composer global require "laravel/lumen-installer"

请确定你已将 ~/.composer/vendor/bin 路径加到 PATH，只有这样系统才能找到 lumen 的执行文件。

一旦安装完成，就可以使用 lumen new 命令在指定的目录创建一个新的 Lumen 项目，例如：lumen new blog 将会在当前目录下创建一个叫 blog 的目录，此目录里面存放着新安装的 Lumen 和所有代码依赖。这种方法的安装速度比通过 Composer 安装要快上许多：

lumen new blog

通过 Composer Create-Project 命令

除此之外，你也可以在命令行使用 Composer 的 create-project 命令来安装 Lumen :

composer create-project --prefer-dist laravel/lumen blog

运行你的应用程序

为了能在本地运行你的应用程序，你可以使用 Laravel Homestead 虚拟机，Laravel Valet, 或者 PHP 内置的开发服务器 :

php -S localhost:8000 -t public

配置信息

跟全栈框架 Laravel 框架不一样的是，所有的 Lumen 框架的配置信息都存储在 .env 文件中。一旦 Lumen 成功安装，你需要去 配置本地环境。

应用程序密钥

在你安装完 Lumen 后，首先需要做的事情是设置一个随机字符串到应用程序密钥。通常这个密钥会有 32 字符长。这个密钥可以被设置在 .env 环境文件中。如果你还没将 .env.example 文件重命名为 .env，那么你现在应该去设置下。如果应用程序密钥没有被设置的话，你的用户 Session 和其它的加密数据都是不安全的！

---

配置

• 介绍
• 获取配置信息
• 环境配置
  • 判定当前运行环境

介绍

Lumen 框架所有的配置信息都存储在 .env 文件中。

获取配置信息

你可以在应用的任何地方使用全局辅助函数 config() 来轻松获取你的配置信息。设置值可以通过「点」语法来获取，其中包含了文件与选项的名称。你也可以指定一个默认值，当该设置选项不存在时就会返回默认值：

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

若要在运行期间修改设置值，请传递一个数组至 config 辅助函数：

config(['app.locale' => 'en']);

应用环境配置

这对于应用需要运行在不同环境下的情况来说是非常有用的。例如，你希望本地的开发环境和生产环境使用不同的缓存驱动，那么使用
基础环境配置就比较容易实现。

Vance Lucas 开发的 Lumen 组件 -- DotEnv PHP 库就可以做到。在新安装的 Lumen 应用根目录中有一个 .env.example 文件，在你创建你的应用时，你须要将 .env.example 命名为或拷贝一份命名为 .env。

当应用启动后，env 文件中的所有变量会加载到 PHP 全局变量 $_ENV 中。你可以使用 env() 函数获取到已加载的环境变量：

$ debug = env('APP_DEBUG', true);

env() 函数的第二个参数是 “默认值”，当函数未检索到第一个参数对应的值时，将使用给定的默认值。

不要将 .env 文件提交到你的代码版本管理库，防止不同使用者 / 服务器配置需求与你不同。

如果你是团队开发，你可能希望应用包含 .env.example 文件。其他开发者通过对比 .env.example 文件的配置项，可以清楚地看到运行应用所需的配置项。

检测当前环境

你可以查看 .env 文件中的 APP_ENV 配置项来确定当前环境。你也可以通过应用实例的 environment() 方法来获取 APP_ENV 的具体值：

$environment = app()->environment();

你也可以传参数给 environment() 方法来检测是否匹配给定的参数值。如有必要，可以给 environment() 方法传多个参数值，当环境值匹配其中任一值时，将返回 true:

if (app()->environment('local')) {
    // 运行环境为 local
}

if (app()->environment('local', 'staging')) {
    // 运行环境为 local 或 staging
}