Laravel 5.3安装配置用户手册

一,安装

1、服务器要求
Laravel 框架有对服务器有少量要求,当然,Laravel Homestead 已经满足所有这些要求,所以我们强烈推荐使用 Homestead 作为 Laravel 本地开发环境(Mac的话还可以使用Valet作为本地开发环境)。

不过,如果你没有使用 Homestead,那么需要保证开发环境满足以下要求:

PHP版本 >= 5.6.4
PHP扩展:OpenSSL
PHP扩展:PDO
PHP扩展:Mbstring
PHP扩展:Tokenizer
2、安装 Laravel
Laravel 使用 Composer 管理依赖,因此,使用 Laravel 之前,确保机器上已经安装了Composer。

通过 Laravel 安装器

首先,通过 Composer 安装 Laravel 安装器:

composer global require "laravel/installer"
确保 ~/.composer/vendor/bin 在系统路径中,否则不能在任意路径调用 laravel 命令。

安装完成后,通过简单的 laravel new 命令即可在当前目录下创建一个新的 Laravel 应用,例如,laravel new blog 将会创建一个名为 blog 的新应用,且包含所有  Laravel 依赖。该安装方法比通过 Composer 安装要快很多:

laravel new blog
通过 Composer Create-Project

你还可以在终端中通过 Composer 的 create-project 命令来安装 Laravel 应用:

composer create-project --prefer-dist laravel/laravel blog
3、配置
Laravel 框架的所有配置文件都存放在 config 目录下,并且每一个配置项都有注释,所以你可以随意浏览任意配置文件去熟悉这些配置项。

Public目录

安装完Laravel后,需要将HTTP服务器的web根目录指向public目录,该目录下的index.php文件将作为前端控制器,所有HTTP请求都会通过该文件进入应用。

配置文件

Laravel框架的所有配置文件都存放在config目录下,所有的配置项都有注释,所以你可以轻松遍览这些配置文件以便熟悉所有配置项。

目录权限

安装完 Laravel 后,需要配置一些目录的读写权限:storage 和 bootstrap/cache 目录应该是可写的,如果你使用 Homestead 虚拟机做为开发环境,这些权限已经设置好了。

应用 Key

接下来要做的事情就是将应用的 key(APP_KEY)设置为一个随机字符串,如果你是通过 Composer 或者 Laravel 安装器安装的话,该 key 的值已经通过  php artisan key:generate 命令生成好了。

通常,该字符串应该是32位长,通过 .env 文件中的 APP_KEY 进行配置,如果你还没有将 .env.example 文件重命名为 .env,现在立即这样做。如果应用 key没有被设置,用户 Session 和其它加密数据将会有安全隐患。

更多配置

Laravel 几乎不再需要其它任何配置就可以正常使用了,但是,你最好再看看 config/app.php 文件,其中包含了一些基于应用可能需要进行改变的配置,比如 timezone 和 locale(分别用于配置时区和本地化)。

你可能还想要配置 Laravel 的一些其它组件,比如缓存、数据库、Session 等,关于这些我们将会在后续文档一一探讨。

安装完成后,即可进入下一步——配置Laravel。

二,配置

1、简介
Laravel 的所有配置文件都存放在 config 目录下,每个配置项都有注释,以保证浏览任意配置文件的配置项都能直观了解该配置项的作用及用法。

2、访问配置值
你可以使用全局辅助函数 config 在应用的任意位置访问配置值,该配置值可以文件名+“.”+配置项的方式进行访问,当配置项没有被配置的时候返回默认值:

$value = config('app.timezone');
如果要在运行时设置配置值,传递数组参数到 config 方法即可:

config(['app.timezone' => 'America/Chicago']);
3、环境配置
基于应用运行的环境不同设置不同的配置值能够给我们开发带来极大的方便,比如,我们通常在本地和线上环境配置不同的缓存驱动,这一机制在 Laravel 中很容易实现。
Laravel 使用 Vance Lucas 开发的 PHP 库 DotEnv 来实现这一机制,在新安装的 Laravel 中,根目录下有一个.env.example 文件,如果 Laravel 是通过 Composer 安装的,那么该文件已经被重命名为 .env,否则的话你要自己手动重命名该文件。

获取环境变量配置值

在应用每次接受请求时,.env 中列出的所有配置及其值都会被载入到 PHP 超全局变量 $_ENV 中,然后你就可以在应用中通过辅助函数 env 来获取这些配置值。实际上,如果你去查看 Laravel 的配置文件,就会发现很多地方已经在使用这个辅助函数了:

'debug' => env('APP_DEBUG', false),
传递到 env 函数的第二个参数是默认值,如果环境变量没有被配置将会是个该默认值。

不要把 .env 文件提交到源码控制(svn 或 git 等)中,因为每个使用你的应用的开发者/服务器可能要求不同的环境配置。

如果你是在一个团队中进行开发,你需要将 .env.example 文件随你的应用一起提交到源码控制中:将一些配置值以占位符的方式放置在 .env.example 文件中,这样其他开发者就会很清楚运行你的应用需要配置哪些环境变量。

判断当前应用环境

当前应用环境由 .env 文件中的 APP_ENV 变量决定,你可以通过 App 门面 的 environment 方法来访问其值:

$environment = App::environment();
你也可以向 environment 方法中传递参数来判断当前环境是否匹配给定值,如果需要的话你甚至可以传递多个值。如果当前环境与给定值匹配,该方法返回 true:

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

if (App::environment('local', 'staging')) {
    // The environment is either local OR staging...
}
应用实例也可以通过辅助函数 app 来访问:

$environment = app()->environment();
4、配置缓存
为了给应用加速,你可以使用 Artisan 命令 config:cache 将所有配置文件的配置缓存到单个文件里,这将会将所有配置选项合并到单个文件从而可以被框架快速加载。

应用一旦上线,就要运行一次 php artisan config:cache,但是在本地开发时,没必要经常运行该命令,因为配置值经常需要改变。

5、维护模式
当你的应用处于维护模式时,所有对应用的请求都会返回同一个自定义视图。这一机制在对应用进行升级或者维护时,使得“关闭”站点变得轻而易举。对维护模式的判断代码位于应用默认的中间件栈中,如果应用处于维护模式,则状态码为 503 的  MaintenanceModeException 将会被抛出。
要开启维护模式,只需执行 Artisan 命令 down 即可:

php artisan down
要关闭维护模式,对应的 Artisan 命令是 up:

php artisan up
维护模式响应模板

默认的维护模式响应视图模板是 resources/views/errors/503.blade.php

维护模式 & 队列

当你的站点处于维护模式中时,所有的队列任务都不会执行;当应用退出维护模式这些任务才会被继续正常处理。

维护模式的替代方案

由于维护模式命令的执行需要几秒时间,你可以考虑使用 Envoyer 实现 0 秒下线作为替代方案。

时间: 2024-08-02 06:01:29

Laravel 5.3安装配置用户手册的相关文章

Laravel 5.2 安装配置教程详解

一,安装 1.服务器要求 Laravel 框架有对服务器有少量要求,当然,Laravel Homestead 已经满足所有这些要求,所以我们强烈推荐使用 Homestead 作为 Laravel 本地开发环境. 如果你没有使用 Homestead,那么需要保证开发环境满足以下要求: PHP版本 >= 5.5.9 PHP扩展:OpenSSL PHP扩展:PDO PHP扩展:Mbstring PHP扩展:Tokenizer 2.安装 Laravel Laravel 使用 Composer 管理依赖,

Laravel 5.1框架Redis 的安装配置及基本使用教程

1.安装启动Redis及依赖包 如果使用的是Homestead虚拟机作为本地开发环境的话,Homestead已经为我们安装好了Redis并开机启动,如果是使用Windows开发环境的话,可参考这篇文章安装启动Redis. Redis启动之后,还需要在Laravel项目根目录下运行如下命令使用Composer安装predis依赖包: composer require predis/predis 1.0.* 2.配置Redis 前面我们已经提到Redis可以用作主数据库,所以Laravel中Redi

Laravel Cashier安装配置篇教程详解

0.开始之前 在开始之前我们先理清几个概念. Stripe是一个为个人和公司提供在线支付解决方案的工具,支持Web和移动App. Laravel Cashier为Stripe提供了相应接口以便在Laravel中实现订购支付功能,从而避免让我们编写重复的样板化的代码,真正专注于业务逻辑处理,提高编程效率. 那么,Laravel Cashier到底是怎样的一把利器,下面让我们一一揭晓. 1.安装配置 使用composer安装 我们使用Composer安装Laravel Cashier依赖包,首先将如

安装配置bugzilla笔记

因为自己在安装配置的时候走了些弯路,所以一方面自己提个醒,另一方面可以让有这方面需要的朋友做个参考 bugzilla是一个可以发布bug以及跟踪报告bug进展情况的开源软件,有关的官方文档可以查看:http://www.bugzilla.org/docs/ 本人是在RH9上安装配置成功bugzilla-2.18rc3的,事先也成功安装配置过2.16.7,后来发现在2.18中加入了图表的功能,觉得蛮有意思的,所以升级了一下.在安装前先确定自己机器上一些软件版本的情况:perl(5.6 or abo

Winodws下IIS/Apache+PHP+MySQL的安装配置

apache|iis|mysql 我写过的教程不多,而且大部分都是来源于别人的教程,不过,这里所介绍的,都是融入我所总结的经验.--引言 PHP的执行效率是有目共睹的,这也是我喜欢它的原因之一,和它称为绝妙搭档的Mysql以及Apache想融合,不能不惊叹其效率了.PHP更新也很快,这里列举了目前最新版本PHP4.3.2RC4(几乎没有BUG了,估计写完这篇不久后正式版就出了),和最新版本的Mysql4.0.13的安装过程. PHP的安装文件可以直接到 http://www.php.net/ 下

Oozie-3.3.2安装配置运行实践

Oozie是一个开源的工作流调度系统,它能够管理逻辑复杂的多个Hadoop作业,按照指定的顺序将其协同运行起来.例如,我们可能有这样一个需求,某个业务系统每天产生20G原始数据,我们每天都要对其进行处理,处理步骤如下所示: 通过Hadoop先将原始数据同步到HDFS上: 借助MapReduce计算框架对原始数据进行转换,生成的数据以分区表的形式存储到多张Hive表中: 需要对Hive中多个表的数据进行JOIN处理,得到一个明细数据Hive大表: 将明细数据进行复杂的统计分析,得到排序后的报表信息

Hue安装配置实践

Hue是一个开源的Apache Hadoop UI系统,最早是由Cloudera Desktop演化而来,由Cloudera贡献给开源社区,它是基于Python Web框架Django实现的.通过使用Hue我们可以在浏览器端的Web控制台上与Hadoop集群进行交互来分析处理数据,例如操作HDFS上的数据,运行MapReduce Job等等.很早以前就听说过Hue的便利与强大,一直没能亲自尝试使用,下面先通过官网给出的特性,通过翻译原文简单了解一下Hue所支持的功能特性集合: 默认基于轻量级sq

Cacti安装配置及使用

工作原理图: 整个系统有四部分组成: 1.Cacti系统平台用于用户设置与查看图表:Cacti需要LAMP环境的支持. 2.snmp用于采集数据给rrdtool绘制成图,使用161.162端口,用MIB数据库来保持数据信息,根据OID定位数据(类似1.3.6.1.2.1):Linux下使用net-snmp自带的snmpget和snmpwalk等程序,Windows下使用php的snmp功能. 3.RRDTool绘图引擎用于性能数据的存储和绘画图像. 4.Mysql数据库用来存储RRDTool绘图

Windows系统下XAMPP的安装配置图文教程

  这是关于在windows下XAMPP的安装配置图文教程,XAMPP 是什么?在linux ubuntu系统下安装配置LAMP时提到了XAMPP,XAMPP为我们提供了一种在Linux.Solaris.Windows和Mac OS X系统下简易安装Apache服务器发行版的快捷方法. XAMPP(X-系统,A-Apache,M-Mysql,P-php,P- Phpmyadmin/Perl)这个缩写名称说明了XAMPP安装包所包含的文件:Apache web 服务器, MySQL数据库, PHP