Skip to content

安装

安装 Composer

Laravel 使用 Composer 来管理其依赖项。首先,下载一份 composer.phar。一旦你有了 PHAR 文件,你可以选择将其保留在本地项目目录中,或移动到 usr/local/bin 以便在系统上全局使用。在 Windows 上,你可以使用 Composer Windows 安装程序

安装 Laravel

通过 Laravel 安装程序

首先,使用 Composer 下载 Laravel 安装程序。

php
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

你也可以通过在终端中发出 Composer create-project 命令来安装 Laravel:

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

通过下载

安装 Composer 后,下载 Laravel 框架的 4.2 版本 并将其内容解压到服务器上的一个目录中。接下来,在 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 后,你应该首先将应用程序密钥设置为随机字符串。如果你通过 Composer 安装了 Laravel,这个密钥可能已经通过 key:generate 命令为你设置。通常,这个字符串应该是 32 个字符长。密钥可以在 app.php 配置文件中设置。如果未设置应用程序密钥,你的用户会话和其他加密数据将不安全。

Laravel 几乎不需要其他配置即可使用。你可以自由开始开发!但是,你可能希望查看 app/config/app.php 文件及其文档。它包含一些选项,例如 timezonelocale,你可能希望根据你的应用程序进行更改。

一旦安装了 Laravel,你还应该 配置你的本地环境。这将允许你在本地机器上开发时接收详细的错误消息。默认情况下,生产配置文件中禁用了详细错误报告。

lightbulb

你绝对不应该在生产应用程序中将 app.debug 设置为 true。绝对不要这样做。

权限

Laravel 可能需要配置一组权限:app/storage 中的文件夹需要 Web 服务器的写入访问权限。

路径

框架目录路径中的几个是可配置的。要更改这些目录的位置,请查看 bootstrap/paths.php 文件。

美化 URL

Apache

框架附带一个 public/.htaccess 文件,用于允许没有 index.php 的 URL。如果你使用 Apache 来提供 Laravel 应用程序,请确保启用 mod_rewrite 模块。

如果与 Laravel 一起提供的 .htaccess 文件在你的 Apache 安装中不起作用,请尝试以下内容:

php
Options +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

Nginx

在 Nginx 中,以下指令将在你的站点配置中允许“美化” URL:

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