目录
电子文档:https://laravel.book.wangyan.org/5.3/ 文章合集:http://www.wangyan.cloud/tag/#laravel-5.3
安装
安装
运行环境要求
Laravel 框架会有一些系统上的要求。当然,这些要求在 Laravel Homestead 虚拟机上都已经完全配置好了,强烈建议使用 Homestead 作为本地开发环境。
不过,如果你没有使用 Homestead,那么需要保证运行环境满足以下要求:
译者注:强烈推荐使用 Homestead 作为开发环境,尤其是新手,可以避免很多不必要的麻烦。线上环境可以参考 Homestead 的环境部署脚本 进行部署。
安装 Laravel
Laravel 使用 Composer 来管理代码依赖。所以,在使用 Laravel 之前,请先确认你的电脑上安装了 Composer。
通过 Laravel 安装工具
首先,通过 Composer 安装 Laravel 安装工具:
composer global require "laravel/installer"
请确保 ~/.composer/vendor/bin 目录 (或者你操作系统类似的目录) 在你的系统环境变量中,这样 laravel 才可以在你系统任意路径调用运行。
译者注:例如 windwos 系统,该目录是
C:/Users/xxxx/AppData/Roaming/Composer
一旦安装完成,就可以使用 laravel new 命令在指定目录创建一个新的 Laravel 项目,例如:laravel new blog 将会在当前目录下创建一个叫 blog 的新应用,此目录里面存放着新安装的 Laravel 和代码依赖。
laravel new blog
译者注:通过这种方式安装,速度要比通过 Composer 安装要快上许多,因为代码依赖是直接一起打包安装的。
通过 Composer Create-Project
除此之外,你也可以通过 Composer 在命令行运行 create-project 命令来安装 Laravel:
composer create-project --prefer-dist laravel/laravel blog
译者注:如果要下载其他版本,比如 5.1 LTS 版本,可以使用这个命令:
composer create-project --prefer-dist laravel/laravel blog 5.1.*
本地开发服务器
如果你在本地安装了 PHP ,想使用 PHP 内置的 Web 服务器访问应用。你需要使用 serve Artisan 命令。这个命令会启动 PHP 内置的开发服务器,通过 http://localhost:8000 访问。
php artisan serve
当然,了解更多本地开发选项,请阅读文档 Homestead 和 Valet。
配置信息
Public 目录
安装完成后,你应该指定 Web 服务器的网站根目录到 public 文件夹上。在这个文件夹下的 index.php 文件是所有 HTTP 请求的入口控制文件。
配置文件
所有 Laravel 框架的配置文件都放置在 config 目录下。每个选项都有说明,请仔细阅读这些说明,并熟悉这些选项配置。
目录权限
安装 Laravel 之后,你必须设置一些文件目录权限。storage 和 bootstrap/cache 目录必须让 Web 服务有写入权限。否则 laravel 将无法运行。如果你使用 Homestead 虚拟机,那么这些权限已经被设置好了。
应用程序密钥
安装完 Laravel 后,下一步要做的事情是将应用程序密钥设置为一个随机字符串。假设你是通过 Composer 或是 Laravel 安装工具安装的 Laravel,那么这个密钥已经通过 key:generate 命令帮你设置完成。
这个密钥可以被设置在 .env 环境文件中。如果你还没将 .env.example 文件重命名为 .env,那么你现在应该去设置下。
如果应用程序密钥没有被设置的话,你的用户 Session 和其它的加密数据都是不安全的!
其它设置
Laravel 几乎不需做任何其它设置就可以马上使用,但是建议你先浏览 config/app.php 文件和对应的文档,这里面包含着一些选项,如 时区 和 语言环境,你可以根据应用程序的情况来修改。
你也可以设置 Laravel 的几个附加组件,像是:
一旦 Laravel 安装完成,你应该立即 设置本机环境。
最后更新:2016.09.21