跳到主要内容
版本:4.2

安装

安装 Composer

Laravel 框架使用 Composer来管理其相依性。首先,下载一份 composer.phar 下来。之后,您可以把它放在本地端的项目目录,或者是移至 /usr/local/bin 让全站皆可使用。在 Windows 下,您可以使用 Composer Windows 安装工具

安装 Laravel

通过 Laravel 安装工具

首先, 使用 Composer 全局下载并安装 Laravel/installer:

composer global require "laravel/installer=~1.1"

请确定把 ~/.composer/vendor/bin 路径放置于您的 PATH 里, 这样laravel 可执行文件才能被命令行找到, 以后您就可以在命令行下直接使用 laravel 命令.

安装并且配置成功后, 可以使用命令 laravel new 在您指定的目录下创建一份全新安装的 Laravel 应用, 如这样的调用: laravel new blog 将会在当前目录下创建一个叫 blog 的目录, 此目录里面存放着全新安装的 Laravel 应用, 此方法跟其他方法不一样的地方在于是提前安装好所有代码依赖的, 您无需再通过 composer install 安装, 速度一下子提高了很多.

通过 Composer Create-Project

您一样可以通过 Composer 在命令行执行 create-project 来安装 laravel:

composer create-project laravel/laravel {directory} 4.2 --prefer-dist

通过下载

Composer 安装完成后,下载4.2版本的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 命令为你自动设置了。一般来说,这个字符串应该是 32 位长度的字符。这个 key 应该设定在 app.php 文件中。 如果这个应用的 key 没有设置,你的用户的 sessions 以及其他加密数据就不能保证安全。

Laravel 几乎无需设定即可马上使用。您可以自由的开始开发。然而,您可以查看 app/config/app.php 文件和他的文件。它包含了数个您的应用程序所想要更动的选项如 时区(timezone)语系(locale)

一旦 Laravel 安装完成,您应该同时设定本地环境。当您在您的本机上部署时,可以让您得到更详细的错误信息。默认在您的正式环境里详细的错误信息是被关掉的。

提示

您不应该在正式环境中将 app.debug 设为 true。绝对!千万不要!

权限

Laravel 框架有一个目录需要额外设置权限:app/storage 需要让网页服务器有写入的权限。

路径

一些框架的目录路径是可以被设定配置的。如果要更改这些目录的位置,请查看 bootstrap/paths.php 文件。

优雅链接

Apache

Laravel 框架通过 public/.htaccess 文件来去掉URL结尾的 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, 在 nginx 的配置文件中增加如下代码即可开启"优雅链接":

location / {
try_files $uri $uri/ /index.php?$query_string;
}