Laravel 5.3安装配置用户手册

一，安装

1、服务器要求
Laravel 框架有对服务器有少量要求，当然，Laravel Homestead 已经满足所有这些要求，所以我们强烈推荐使用 Homestead 作为 Laravel 本地开发环境（Mac的话还可以使用Valet作为本地开发环境）。

不过，如果你没有使用 Homestead，那么需要保证开发环境满足以下要求：

PHP版本 >= 5.6.4
PHP扩展：OpenSSL
PHP扩展：PDO
PHP扩展：Mbstring
PHP扩展：Tokenizer
2、安装 Laravel
Laravel 使用 Composer 管理依赖，因此，使用 Laravel 之前，确保机器上已经安装了Composer。

通过 Laravel 安装器

首先，通过 Composer 安装 Laravel 安装器：

composer global require "laravel/installer"
确保 ~/.composer/vendor/bin 在系统路径中，否则不能在任意路径调用 laravel 命令。

安装完成后，通过简单的 laravel new 命令即可在当前目录下创建一个新的 Laravel 应用，例如，laravel new blog 将会创建一个名为 blog 的新应用，且包含所有  Laravel 依赖。该安装方法比通过 Composer 安装要快很多：

laravel new blog
通过 Composer Create-Project

你还可以在终端中通过 Composer 的 create-project 命令来安装 Laravel 应用：

composer create-project --prefer-dist laravel/laravel blog
3、配置
Laravel 框架的所有配置文件都存放在 config 目录下，并且每一个配置项都有注释，所以你可以随意浏览任意配置文件去熟悉这些配置项。

Public目录

安装完Laravel后，需要将HTTP服务器的web根目录指向public目录，该目录下的index.php文件将作为前端控制器，所有HTTP请求都会通过该文件进入应用。

配置文件

Laravel框架的所有配置文件都存放在config目录下，所有的配置项都有注释，所以你可以轻松遍览这些配置文件以便熟悉所有配置项。

目录权限

安装完 Laravel 后，需要配置一些目录的读写权限：storage 和 bootstrap/cache 目录应该是可写的，如果你使用 Homestead 虚拟机做为开发环境，这些权限已经设置好了。

应用 Key

接下来要做的事情就是将应用的 key（APP_KEY）设置为一个随机字符串，如果你是通过 Composer 或者 Laravel 安装器安装的话，该 key 的值已经通过  php artisan key:generate 命令生成好了。

通常，该字符串应该是32位长，通过 .env 文件中的 APP_KEY 进行配置，如果你还没有将 .env.example 文件重命名为 .env，现在立即这样做。如果应用 key没有被设置，用户 Session 和其它加密数据将会有安全隐患。

更多配置

Laravel 几乎不再需要其它任何配置就可以正常使用了，但是，你最好再看看 config/app.php 文件，其中包含了一些基于应用可能需要进行改变的配置，比如 timezone 和 locale（分别用于配置时区和本地化）。

你可能还想要配置 Laravel 的一些其它组件，比如缓存、数据库、Session 等，关于这些我们将会在后续文档一一探讨。

安装完成后，即可进入下一步——配置Laravel。

二，配置

1、简介
Laravel 的所有配置文件都存放在 config 目录下，每个配置项都有注释，以保证浏览任意配置文件的配置项都能直观了解该配置项的作用及用法。

2、访问配置值
你可以使用全局辅助函数 config 在应用的任意位置访问配置值，该配置值可以文件名+“.”+配置项的方式进行访问，当配置项没有被配置的时候返回默认值：

$value = config('app.timezone');
如果要在运行时设置配置值，传递数组参数到 config 方法即可：

config(['app.timezone' => 'America/Chicago']);
3、环境配置
基于应用运行的环境不同设置不同的配置值能够给我们开发带来极大的方便，比如，我们通常在本地和线上环境配置不同的缓存驱动，这一机制在 Laravel 中很容易实现。
Laravel 使用 Vance Lucas 开发的 PHP 库 DotEnv 来实现这一机制，在新安装的 Laravel 中，根目录下有一个.env.example 文件，如果 Laravel 是通过 Composer 安装的，那么该文件已经被重命名为 .env，否则的话你要自己手动重命名该文件。

获取环境变量配置值

在应用每次接受请求时，.env 中列出的所有配置及其值都会被载入到 PHP 超全局变量 $_ENV 中，然后你就可以在应用中通过辅助函数 env 来获取这些配置值。实际上，如果你去查看 Laravel 的配置文件，就会发现很多地方已经在使用这个辅助函数了：

'debug' => env('APP_DEBUG', false),
传递到 env 函数的第二个参数是默认值，如果环境变量没有被配置将会是个该默认值。

不要把 .env 文件提交到源码控制（svn 或 git 等）中，因为每个使用你的应用的开发者/服务器可能要求不同的环境配置。

如果你是在一个团队中进行开发，你需要将 .env.example 文件随你的应用一起提交到源码控制中：将一些配置值以占位符的方式放置在 .env.example 文件中，这样其他开发者就会很清楚运行你的应用需要配置哪些环境变量。

判断当前应用环境

当前应用环境由 .env 文件中的 APP_ENV 变量决定，你可以通过 App 门面 的 environment 方法来访问其值：

$environment = App::environment();
你也可以向 environment 方法中传递参数来判断当前环境是否匹配给定值，如果需要的话你甚至可以传递多个值。如果当前环境与给定值匹配，该方法返回 true：

if (App::environment('local')) {
    // The environment is local
}

if (App::environment('local', 'staging')) {
    // The environment is either local OR staging...
}
应用实例也可以通过辅助函数 app 来访问：

$environment = app()->environment();
4、配置缓存
为了给应用加速，你可以使用 Artisan 命令 config:cache 将所有配置文件的配置缓存到单个文件里，这将会将所有配置选项合并到单个文件从而可以被框架快速加载。

应用一旦上线，就要运行一次 php artisan config:cache，但是在本地开发时，没必要经常运行该命令，因为配置值经常需要改变。

5、维护模式
当你的应用处于维护模式时，所有对应用的请求都会返回同一个自定义视图。这一机制在对应用进行升级或者维护时，使得“关闭”站点变得轻而易举。对维护模式的判断代码位于应用默认的中间件栈中，如果应用处于维护模式，则状态码为 503 的  MaintenanceModeException 将会被抛出。
要开启维护模式，只需执行 Artisan 命令 down 即可：

php artisan down
要关闭维护模式，对应的 Artisan 命令是 up：

php artisan up
维护模式响应模板

默认的维护模式响应视图模板是 resources/views/errors/503.blade.php

维护模式 & 队列

当你的站点处于维护模式中时，所有的队列任务都不会执行；当应用退出维护模式这些任务才会被继续正常处理。

维护模式的替代方案

由于维护模式命令的执行需要几秒时间，你可以考虑使用 Envoyer 实现 0 秒下线作为替代方案。