安装

5.3

11.x 10.x 9.x 8.5 8.x 7.x 6.x 5.8 5.7 5.6 5.5 5.4 5.3 5.2 5.1

Laravel 5.3 中文文档 /

本文档最新版为 10.x，旧版本可能放弃维护，推荐阅读最新版！

安装

安装

安装

运行环境要求

Laravel 框架会有一些系统上的要求。当然，这些要求在 Laravel Homestead 虚拟机上都已经完全配置好了，强烈建议使用 Homestead 作为本地开发环境。

系统要求为以下：

PHP >= 5.6.4
OpenSSL PHP Extension
PDO PHP Extension
Mbstring PHP Extension
Tokenizer PHP Extension
XML PHP Extension

译者注：强烈推荐使用 Homestead 作为开发环境，尤其是新手，可以避免很多不必要的麻烦。线上环境可以参考 Homestead 的环境部署脚本进行部署。

安装 Laravel

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

通过 Laravel 安装工具

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

composer global require "laravel/installer"

请确定你已将 ~/.composer/vendor/bin 路径加到 PATH，只有这样系统才能找到 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

译者注：安装 Laravel 5.3，请使用以下命令：

composer create-project laravel/laravel your-project-name --prefer-dist "5.3.*"

本地开发服务器

如果你在本地安装了 PHP，你可能希望像运行 PHP 内置的开发服务器一样来访问自己的应用程序，你可以使用 serve Artisan 命令来启动一个本地开发服务器，这样你就可以在 http://localhost:8000 来访问它。

php artisan serve

不过有更健壮的本地开发选项可用，比如 Homestead 和 Valet。

配置信息

Public 目录

安装完成后，你应该指定 Web 服务器的网站根目录到 public 文件夹上。index.php 文件是 Laravel 的主要入口文件。

配置文件

所有 Laravel 框架的配置文件都放置在 config 目录下。每个选项都有说明，请仔细阅读这些说明，并熟悉这些选项配置。

目录权限

安装 Laravel 之后，你必须设置一些文件目录权限。storage 和 bootstrap/cache 目录必须让服务器有写入权限。如果你使用 Homestead 虚拟机，那么这些权限已经被设置好了。

应用程序密钥

在你安装完 Laravel 后，首先需要做的事情是设置一个随机字符串的密钥。假设你是通过 Composer 或是 Laravel 安装工具安装的 Laravel，那么这个密钥已经通过 key:generate 命令帮你设置完成。通常这个密钥会有 32 字符长。这个密钥可以被设置在 .env 环境文件中。如果你还没将 .env.example 文件重命名为 .env，那么你现在应该去设置下。

如果应用程序密钥没有被设置的话，你的用户 Session 和其它的加密数据都是不安全的！