安装

安装 Composer

Laravel 框架使用 Composer(PHP包管理工具,参考 Composer 中文文档)来管理代码依赖性。 首先,你需要下载 Composer 的 PHAR 打包文件( composer.phar ),下载完成后把它放在项目目录下或者放到 usr/local/bin 目录下以便在系统中全局调用。在Windows操作系统中,你可以使用 Composer 的Windows安装工具

安装 Laravel

通过 Laravel 安装器安装

先下载 Laravel 安装器 PHAR 文件。为了方便起见,将该文件重命名为 laravel 并移动至 /usr/local/bin 目录。完成后,只需在你指定的目录下输入简单的 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.5 版本开始,针对某些操作系统的安装包需要你自己手工安装 PHP 的 JSON 扩展模块。如果你使用的是 Ubuntu,可以通过, apt-get install php5-json 命令直接安装。

配置

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;
}