Skip to content

Latest commit

 

History

History
184 lines (112 loc) · 8.73 KB

installation.md

File metadata and controls

184 lines (112 loc) · 8.73 KB

Installation

安装

服务器要求

该版本的 Laravel 框架对系统有一些要求. 当然, Laravel Homestead 虚拟机已经满足这些要求。

- PHP >= 5.5.9 - OpenSSL PHP Extension - PDO PHP Extension - Mbstring PHP Extension - Tokenizer PHP Extension

安装 Laravel

Laravel 使用 Composer 来管理其依赖关系。因此,使用 Laravel 前,请确认 Composer 已安装在你的计算机上。

通过 Laravel 安装程序

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

composer global require "laravel/installer=~1.1"

请确保 ~/.composer/vendor/bin 目录在你的 PATH 中。这样,Laravel 可执行文件才会存在于你的系统中。

一单安装后, 将可以使用一个简单的命令 laravel new 来创建一个全新的 Laravel 安装在你指定的目录。例如,laravel new blog 将创建一个名为 blog 的目录,并在该目录中创建一个全新安装的 Laravel,并且,所有 Laravel 的依赖已被安装。这个方法比通过 Composer 安装更快:

laravel new blog

通过 Composer 创建项目

你也可以通过 Composer create-project 命令来安装 Laravel:

composer create-project laravel/laravel --prefer-dist

配置

基本配置

所有配置文件都储存在 Laravel 框架的 config 目录中。每个选项都有注释,因此你可以你轻松的阅读并且熟悉这些配置选项。

目录权限

安装 Laravle 后,你可能需要配置一些权限。目录内的 storagebootstrap/cache 目录在你的Web服务器中,应有"写"的权限。如果你使用 Homestead 虚拟机,那么权限应已被配置好。

应用密钥

安装完 Laravel 后,你应该设置你的应用密钥为一个随机字符串。如果你是通过 Composer 或 Laravel 安装程序 进行安装的,这个密钥将已被使用 key:generate 命令设置。通常,这个字符串长度应该为32位。这个密钥被设置在 .env 环境配置文件中。如果你还没有将 .env.example 重命名为 .env,那你现在应该去更名它。如果应用密钥没有被设置,那么你的用户 Session 与其他加密数据将不会是安全的!

其他配置

Laravel 安装后几乎不需要任何配置即可开始使用。你可以很轻松地开始进行开发!然而,你不妨去查看 config/app.php 文件与其中的选项说明。它包含了几个选项,例如 timezonelocale。你可以根据你自己的应用需求来更改它们。

你也可能希望更改一些其他 Laravel 组件的配置,例如:

一旦 Laravel 被安装,你一样应该配置你的 环境配置

美观的 URL

Apache

Apache 框架自带了 public/.htaccess 文件,它将允许URL中省略 index.php。如果你的 Laravel 应用运行在 Apache 上,请确认启用了 mod_rewrite 模块。

如果这个 .htaccess 不起作用,你可以试试这样:

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

当然,在使用 Homestead 时,"美观的 URL" 已被自动配置!

环境配置

通常应用程序常常需要根据不同的执行环境而有不同的配置值。例如,你可能希望在你的本机开发环境上会有与发布服务器环境不同的缓存驱动,通过配置文件,就可以轻松完成。

Laravel 通过 DotEnv Vance Lucas 写的一个 PHP 类库。 在全新安装好的 Laravel 里,你的应用程序的根目录下会包含一个 .env.example 文件。如果你通过 Composer 安装 Laravel,这个文件将自动被命名为 .env,不然你应该手动更改文件名。

为了使它更轻松,Laravel 利用 Vance Lucas 的 DotEnv 库。在全新安装的 Laravel 中,你应用的根目录下含有一个 .env.example 文件,如果你是通过 Composer 安装的 Laravel,这个文件已被自动重命名为 .env。如没有,你应该手动去更名它。

当你的应用程序收到请求,这个文件的所有变量将会被加载到 $_ENV PHP 超级全局变量中。你可以使用 env 辅助方法来取出变量的值。事实上,如果你查看 Laravel 配置文件,你会发现几个选项已经使用这个辅助方法了!

根据你的自己的本地服务器或上线环境需求,你可以轻松地修改你的环境配置,然而,你的 .env 文件不应该被提交到应用程序代码版本控制中,因为每个开发者/服务器使用你的应用程序可能需要不同的环境配置。

如果你是一个团队的开发者,不妨将 .env.example 文件包含到你的应用。通过在配置文件中预留值,你的团队中其他开发人员将可以很清楚地看到执行你的应用程序所需的哪些环境配置。

获取配置

如果你需要访问当前应用环境,可以通过 App facade:

$environment = App::environment();

你也可以传递参数给 environment 来确认当前环境是否符合一个指定的值,你也可以传递多个值:

if (App::environment('local')) {
	// The environment is local
}

if (App::environment('local', 'staging')) {
	// The environment is either local OR staging...
}

一个应用实例也可以被通过 app 辅助方法访问到:

$environment = app()->environment();

配置缓存

为了提升你的应用速度,你应该使用 config:cache Artisan 命令缓存你所有的配置文件到单一文件。这将合并你应用中的所有配置选项到单一文件中,这样它才可以被框架更快的载入。 通常你应该将执行 config:cache 命令作为部署时的一个步骤。

取得配置值

你可以使用 config 全局辅助方法很容易地访问你的配置值。这个配置值可以被使用 "点" 语法访问到,其中包括你要访问的配置名,与该配置所在的文件名。你也可以指定一个如果配置不存在将返回的默认值:

$value = config('app.timezone');

要在程序运行时设置一个配置值,需传递一个数组到 config 辅助方法:

config(['app.timezone' => 'America/Chicago']);

应用程序命名

在安装 Laravel 后,你不妨来命名你的应用。默认情况下,app 目录下的命名空间为 App,且 Compsoer 自动加载使用 PSR-4 自动载入标准。然而,你可能会将命名空间改变为与你应用程序相匹配的名字。你可以很容易地通过 app:name Artisan 命令来更改。

例如,如果你的应用被命名为 "Horsefly",你可以在框架根目录下执行以下命令:

php artisan app:name Horsefly

重命名你的应用不是必须的。如果你希望,你完全可以保留默认的命名空间 App

维护模式

如果你的应用处于维护模式,当有请求传入时,将显示一个自定义的视图。"关闭" 你的应用将很利于应用的更新,或维护。默认的中间件栈中包含了维护模式的检查。如果当前应用处于维护模式,一个 HttpException 异常与 503 状态代码将被抛出。

要开启维护模式,你可以简单地使用 down Artisan 命令:

php artisan down

要关闭维护模式,你可以简单地使用 up Artisan 命令:

php artisan up

维护模式响应模板

默认的维护模式模板文件位于: resources/views/errors/503.blade.php.

维护模式和队列

当你的应用处于维护模式,将不会有 队列 Jobs 被处理。这些 Jobs 将在应用关闭维护模式后继续正常处理。