安装
安装 Composer
Laravel 框架使用 Composer(PHP包管理工具,参考 Composer 中文文档)来管理代码依赖性。
首先,你需要下载 Composer 的 PHAR 打包文件( composer.phar
),下载完成后把它放在项目目录下或者放到 usr/local/bin
目录下以便在系统中全局调用。在Windows操作系统中,你可以使用 Composer 的Windows安装工具。
安装 Laravel
通过 Laravel 安装器安装
首先,通过 Composer 下载 Laravel 安装器。
composer global require "laravel/installer=~1.1"
请确保把 ~/.composer/vendor/bin
路径添加到 PATH 环境变量里, 这样laravel
可执行文件才能被命令行找到, 以后您就可以在命令行下直接使用 laravel
命令.
安装成功后, 可以使用命令 laravel new
在您指定的目录下创建一份全新安装的 Laravel。例如,laravel new blog
将会在当前目录下创建一个叫 blog
的目录, 此目录里面存放着全新安装的 Laravel 以及其依赖的工具包。这种安装方法比通过 Composer 安装要快许多。
通过 Composer 的 create-project 命令安装 Laravel
还可以通过在命令行执行 Composer 的 create-project
命令来安装Laravel:
composer create-project laravel/laravel --prefer-dist
通过下载 Laravel 包安装
Composer 安装完成后,下载最新版Laravel框架,把它解压缩到你服务器上的一个目录中。然后在 Laravel 应用的根目录下运行命令行命令 php composer.phar install
(或者 composer install
)来安装所有的框架依赖包。在此过程中,为了成功完成安装,你需要在服务器上安装好 Git。
当 Laravel 框架安装好后,你可以使用命令行命令 php composer.phar update
来更新框架。
对服务器环境的要求
Laravel 框架对系统环境有如下要求:
- PHP >= 5.4
- MCrypt PHP 扩展
从 PHP 5.5 版本开始,针对某些操作系统的安装包需要你自己手工安装 PHP 的 JSON 扩展模块。如果你使用的是 Ubuntu,可以通过, apt-get install php5-json
命令直接安装。
配置
安装完 Laravel 之后,首先需要做的事情就是为你的应用程序设置一个随机字符串作为整个应用的 key(用于加密)。如果你是通过 Composer 安装的 Laravel,这个 key 可能已经通过 key:generate
指令自动为你设置好了。通常,key 的长度是 32 个字符。还可以在 app.php
配置文件中直接设置 key。如果你的应用程序没有设置 key,session 和其他需要加密的数据就会不安全。
Laravel 框架几乎无需配置就可立即使用。你可以自由地快速开始开发。然而,你也许希望先查看下 app/config/app.php
配置文件和相关的文档说明。它包含了一些你也许要修改的配置选项,如 时区
和 地区
等。
一旦 Laravel 安装成功,你还应该配置本地开发环境,这样你就能在本地机器上开发时收集所有详细的错误信息了。默认情况下,详细错误信息报告在生产环境的配置文件中是关闭的。
注意: 在生产环境的配置文件中,绝对不要把
app.debug
设置为true
,切记,切记!
权限设置
Laravel框架有一个目录需要额外设置权限: 需要为 app/storage
目录下的文件设置写权限。
路径设置
一些框架目录路径是可以设置的。如果需要改变这些目录的位置,可以查看 bootstrap/paths.php
文件中的设置。
Pretty URLs
Apache 服务器
Laravel框架通过设置 public/.htaccess
文件去除链接中的index.php
。 如果你你的服务器使用的是 Apache,请确保开启 mod_rewrite
模块。
如果框架附带的 .htaccess
文件在你的Apache环境中不起作用,请尝试下面这个版本:
Options +FollowSymLinks
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
Nginx 服务器
如果是 Nginx 服务器,将下列指令放到网址的配置文件中,就能让网址更优雅了:
location / {
try_files $uri $uri/ /index.php?$query_string;
}