安装
安装 Composer
Laravel 使用 Composer 来管理其依赖项。首先,下载一份 composer.phar
。一旦你有了 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
你也可以通过在终端中发出 Composer create-project
命令来安装 Laravel:
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
文件及其文档。它包含一些选项,例如 timezone
和 locale
,你可能希望根据你的应用程序进行更改。
一旦安装了 Laravel,你还应该 配置你的本地环境。这将允许你在本地机器上开发时接收详细的错误消息。默认情况下,生产配置文件中禁用了详细错误报告。
你绝对不应该在生产应用程序中将 app.debug
设置为 true
。绝对不要这样做。
权限
Laravel 可能需要配置一组权限:app/storage
中的文件夹需要 Web 服务器的写入访问权限。
路径
框架目录路径中的几个是可配置的。要更改这些目录的位置,请查看 bootstrap/paths.php
文件。
美化 URL
Apache
框架附带一个 public/.htaccess
文件,用于允许没有 index.php
的 URL。如果你使用 Apache 来提供 Laravel 应用程序,请确保启用 mod_rewrite
模块。
如果与 Laravel 一起提供的 .htaccess
文件在你的 Apache 安装中不起作用,请尝试以下内容:
Options +FollowSymLinks
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
Nginx
在 Nginx 中,以下指令将在你的站点配置中允许“美化” URL:
location / {
try_files $uri $uri/ /index.php?$query_string;
}