[ Laravel 5.2 文档 ] 开始 —— 安装

1、服务器要求

Laravel 框架有对服务器有少量要求,当然,Laravel Homestead 已经满足所有这些要求,所以我们强烈推荐使用 Homestead 作为 Laravel 本地开发环境。

如果你没有使用 Homestead,那么需要保证开发环境满足以下要求:

  • PHP版本 >= 5.5.9
  • 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 laravel/laravel --prefer-dist blog

3、基本配置

Laravel 框架的所有配置文件都存放在 config 目录下,并且每一个配置项都有注释,所以你可以随意浏览任意配置文件去熟悉这些配置项。

目录权限

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

应用 Key

接下来要做的事情就是将应用的 key(APP_KEY)设置为一个随机字符串,如果你是通过 Composer 或者 Laravel 安装器安装的话,该 key 的值已经通过  key:generate 命令生成好了。通常,该字符串应该是32位长,通过 .env 文件中的 APP_KEY 进行配置,如果你还没有将 .env.example 文件重命名为 .env,现在立即这样做。如果应用 key 没有被设置,用户 Session 和其它加密数据将会有安全隐患。

如果你想要手动生成该 key 的值,使用如下 Artisan 命令即可:

php artisan key:generate

更多配置

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

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

学院君

学院君 has written 550 articles

资深PHP工程师,Laravel学院院长