Skip to content

安装

安装 Composer

Laravel 使用 Composer 来管理其依赖项。因此,在使用 Laravel 之前,您需要确保您的机器上已安装 Composer。

安装 Laravel

通过 Laravel 安装器

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

php
composer global require "laravel/installer=~1.1"

确保将 ~/.composer/vendor/bin 目录放入您的 PATH 中,以便系统可以找到 laravel 可执行文件。

安装完成后,简单的 laravel new 命令将在您指定的目录中创建一个新的 Laravel 安装。例如,laravel new blog 将创建一个名为 blog 的目录,其中包含一个新的 Laravel 安装及所有依赖项。此安装方法比通过 Composer 安装要快得多:

php
laravel new blog

通过 Composer Create-Project

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

php
composer create-project laravel/laravel {directory} "5.0.*" --prefer-dist

安装完成后,您应该升级到最新的软件包。首先,删除 {directory}/vendor/compiled.php 文件,然后将当前目录更改为 {directory} 并发出 composer update 命令。

脚手架

Laravel 附带了用户注册和身份验证的脚手架。如果您想删除此脚手架,请使用 fresh Artisan 命令:

php
php artisan fresh

服务器要求

Laravel 框架有一些系统要求:

  • PHP >= 5.4, PHP < 7
  • Mcrypt PHP 扩展
  • OpenSSL PHP 扩展
  • Mbstring PHP 扩展
  • Tokenizer PHP 扩展

从 PHP 5.5 开始,一些操作系统发行版可能需要您手动安装 PHP JSON 扩展。在使用 Ubuntu 时,可以通过 apt-get install php5-json 来完成。

配置

安装 Laravel 后,您应该做的第一件事是将您的应用程序密钥设置为一个随机字符串。如果您是通过 Composer 安装的 Laravel,这个密钥可能已经通过 key:generate 命令为您设置好了。

通常,这个字符串应该是 32 个字符长。密钥可以在 .env 环境文件中设置。如果没有设置应用程序密钥,您的用户会话和其他加密数据将不安全!

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

安装 Laravel 后,您还应该配置您的本地环境

lightbulb

您不应在生产应用程序中将 app.debug 配置选项设置为 true

权限

Laravel 可能需要配置一些权限:storagevendor 内的文件夹需要由 Web 服务器写入权限。

美观的 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;
}

当然,当使用 Homestead 时,美观的 URL 将自动配置。