首页 » Laravel 5.3 中文文档 » 正文

「Laravel 5.3 中文文档」开始 – 安装

运行环境需求

Laravel 对运行环境需求比较低。当然,所有的这些需求 Laravel Homestead 虚拟机都满足,所以,强烈推荐你使用 Homestead 作为 Laravel 本地开发环境。

但是,如果你不使用 Homestead 的话,你需要确保你的运行环境满足下面的条件:

  • PHP >= 5.6.4
  • 开启PHP OpenSSL 扩展
  • 开启 PHP PDO 扩展
  • 开启 PHP Mbstring 扩展
  • 开启 PHP Tokenizer 扩展

安装 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 应用,并且包含了其所有的依赖:

laravel new blog

通过 Composer 的 Create-Project 安装

此外,你还可以通过在终端使用 Composer 的 create-project 命令安装 Laravel:

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

配置

安装之后,你需要把应用的 WEB 根目录指向 public 文件夹。

Laravel 所有的配置文件都位于 config 目录下。每一个选项都有完整的注释,所以你可以浏览这些文件去熟悉你可能用到的配置项。

文件夹权限

安装 Laravel 之后,你需要配置一些权限。storage 下的目录以及 bootstrap/cache 需要有写权限,否则 Laravel 将不能运行。如果你使用 Homestead 虚拟机,那么这些权限已经配置好了。

应用 key 值

安装 Laravel 后下一个需要做的就是把应用的 key 设置为一个随机字符串,这个值已经通过 php artisan key:generate 命令生成好了。一般情况下,这个字符串长为 32。这个 key 可以在 .env 环境变量文件中设置,如果你还没有把 .env.example 命名为 .env,那你现在就需要做。如果应用的 key 没有设置的话,那么用户 session 以及其他加密的数据都是不安全的。

额外的配置

Laravel 几乎不需要再进行其他配置,你就可以使用它进行开发了。然而,你最好看一下 config/app.php 文件及其注释,它包含了诸如 timezonelocale 之类的选项,你可能需要根据自己的应用来修改它们。

你可能希望配置一些其他的 Laravel 组件,例如:

  • 缓存
  • 数据库
  • Session

安装 Laravel 后,你可能还需要配置本地环境


该篇属于专题:《Laravel 5.3 中文文档

发表评论