• 官方文档 https://learnku.com/docs/laravel/6.x/releases/5121

安装

Laravel框架使用Composer管理项目依赖，因此安装前需确保本机已经安装并配置好Composer。

安装配置Composer

Composer的应用文件为composer.phar，在Windows操作系统下可直接下载 https://getcomposer.org/Composer-Setup.exe 安装包。若没有在全局下安装Composer，只有composer.phar文件，也可将composer.phar文件放到项目根目录下后，使用php composer.phar来执行Composer命令。若全局已经安装过Composer且已加入环境变量则可直接使用composer命令。

$ vim composer.phar

<?php
/*
 * This file is part of Composer.
 *
 * (c) Nils Adermann <naderman@naderman.de>
 *     Jordi Boggiano <j.boggiano@seld.be>
 *
 * For the full copyright and license information, please view
 * the license that is located at the bottom of this file.
 */

// Avoid APC causing random fatal errors per https://github.com/composer/composer/issues/264
if (extension_loaded('apc') && ini_get('apc.enable_cli') && ini_get('apc.cache_by_default')) {
    if (version_compare(phpversion('apc'), '3.0.12', '>=')) {
        ini_set('apc.cache_by_default', 0);
    } else {
        fwrite(STDERR, 'Warning: APC <= 3.0.12 may cause fatal errors when running composer commands.'.PHP_EOL);
        fwrite(STDERR, 'Update APC, or set apc.enable_cli or apc.cache_by_default to 0 in your php.ini.'.PHP_EOL);
    }
}

Phar::mapPhar('composer.phar');
define('COMPOSER_DEV_WARNING_TIME', 1492865599);
require 'phar://composer.phar/bin/composer';

__HALT_COMPILER(); ?>

默认Composer源地址为国外需翻墙访问，可使用国内提供的Composer源镜像地址 https://packagist.phpcomposer.com，不过有时候也比较慢。推荐采用阿里提供的地址 https://mirrors.aliyun.com/composer/。

替换默认Composer仓库的源地址为镜像地址

$ composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

查看Composer全局配置列表中仓库地址

$ composer config -gl
$ composer config --global --list

源码包

Laravel源码包托管在不同平台上，常见的比如GitHub、Packgist。

• GitHub https://github.com/laravel/laravel
• Packagist https://packagist.org/packages/laravel/laravel

项目安装器

使用Composer全局安装Laravel框架项目安装器组件，即可直接使用laravel命令来创建项目。

$ composer search laravel/installer
laravel/installer Laravel application installer.
codemyviews/vanilla-installer Vanilla theme installer. Inspired by laravel/installer by Talor Otwel

$ composer global require laravel/installer
Warning from https://mirrors.aliyun.com/composer: You are using an outdated version of Composer. Composer 2.0 is now available and you should upgrade. See https://getcomposer.org/2

Composer需使用2.0版本，查看当前Composer版本。

$ composer -V
Composer version 1.8.5 2019-04-09 17:46:47

更新Composer版本为最新版

$ composer self-update
Updating to version 2.0.8 (stable channel).
   Downloading (100%)
Failed to decode response: zlib_decode(): data error
Retrying with degraded mode, check https://getcomposer.org/doc/articles/troubleshooting.md#degraded-mode for more info
Downloading (100%)

  [ErrorException]
  zlib_decode(): data error

修改Composer全局配置secure-http禁用HTTPS加密连接

$ composer config -g secure-http false

关闭网络连接中IPv6选项

$ composer -V
Composer version 2.0.8 2020-12-03 17:20:38

重新安装

$ composer global require laravel/installer
  [InvalidArgumentException]
  Could not find a matching version of package lavarel/installer. Check the package spelling, your version constraint and that the package is available in a stability which matches your m
  inimum-stability (stable).

关闭当前命令行窗口后重新执行

$ composer global require laravel/installer
Changed current directory to C:/Users/jc/AppData/Roaming/Composer
https://mirrors.aliyun.com/composer could not be fully loaded (curl error 61 while downloading https://mirrors.aliyun.com/composer/p2/laravel/installer.json: Error while processing content unencoding: Unknown failure within decompression software.), package information was loaded from the local cache and may be out of date

 [Composer\Downloader\TransportException]
  curl error 61 while downloading https://mirrors.aliyun.com/composer/p2/laravel/installer.json: Error while processing content unencoding: Unknown failure within decompression software.

阿里云镜像中laravel/installer不能安装成功，更换为国内源再次尝试。

$ composer config -g repo.packagist composer https://packagist.phpcomposer.com 
$ composer config -gl | grep packagist

$ composer global require laravel/installer
  [InvalidArgumentException]
  Could not find a matching version of package lavarel/installer. Check the package spelling, your version constraint and that the package is available in a stability which matches your m
  inimum-stability (stable).

关闭当前命令行窗口后，重新开启新的命令行窗口再次执行。

$ composer global require laravel/installer

依然没有安装成功，最后将资源包源地址修改会默认的 https://packagist.org 才会成功。

$ composer config -g repo.packagist composer https://packagist.org

创建项目

创建Laravel项目通常会采用两种方式，一种方式是使用专门的Laravel安装器（laravel/installer），另一种则是直接使用Composer的create-project命令来创建。

由于已经安装过Composer，可直接使用composer create-project命令创建Laravel项目。

创建名为nirvana的项目

$ composer create-project laravel/laravel nirvana

$ php composer.phar create-project laravel/laravel nirvana

使用Composer创建Laravel项目时可指定当前Laravel版本

$ composer create-project laravel/laravel nirvana "6.*" --prefer-dist
...
Writing lock file
Generating optimized autoload files
> Illuminate\Foundation\ComposerScripts::postAutoloadDump
> @php artisan package:discover --ansi
Discovered Package: facade/ignition
Discovered Package: fideloper/proxy
Discovered Package: laravel/tinker
Discovered Package: nesbot/carbon
Discovered Package: nunomaduro/collision
Package manifest generated successfully.
> @php artisan key:generate --ansi
Application key set successfully.

注意：Composer的--prefer-dist参数是为了强制下载.zip压缩包并缓存到本地，而非克隆源代码。因此没有保留.git文件夹，也没有版本信息。缓存到本地在下次安装时会从本地加载以提高速度。简单来说，是当有可用包时选择从dist安装。

命令执行完毕后会在当前目录下生成名为nirvana的文件夹即为目标项目

可使用php artisan命令查看当前项目所采用的Laravel框架的版本

$ cd nirvana
$ php artisan -V
Laravel Framework 6.18.43

也可以通过项目下Composer配置文件composer.json中的require选项查看Laravel框架的版本。

$ cd nirvana
$ vim composer.json
"laravel/framework": "^6.18.35"

需要注意的是当前Laravel6框架至少需要PHP7.2版本的支持，另外Laravel6也是一个LTS（Long-Time）最长时间支持和维护，因此会提供为期2年的错误修复和3年的安全修复。

运行测试

本地开发服务器

本地安装的PHP7.2自带了本地开发服务器，因此可直接使用PHP命令来开启文本服务器，默认Laravel框架采用8000端口，因此需确保本机8000端口没有被占用。

默认Laravel框架的公共路径为项目下的public文件夹下，项目入口文件为public/index.php，index.php会作为进入应用的HTTP请求的前端控制器。

需要注意的是PHP本地开发服务器只用于本地开发测试，生产环境一般会采用专门的Web服务器，比如Nginx来配合使用。

$ cd nirvana
$ php -S localhost:8000 -t public/

也可以采用Laravel框架自带的命令php artisan来开启本地开发服务器

$ cd nirvana
$ php artisan serve

此时在浏览器中键入 http://127.0.0.1:8000/ 可访问本地Laravel项目

远程生产服务器

生产环境以Nginx作为Web服务器为例，需为Laravel项目提供专门的虚拟主机配置。

$ vim /usr/local/nginx/conf/vhost/nirvana.conf

server {
  # 配置域名
  server_name www.nirvana.com;
  # 配置项目根目录
  root /home/wwwroot/nirvana/public;
  # 将所有请求引导至public/index.php前端控制器
  location / {
    # try_files $uri $uri/ /index.php$is_args&args;
    try_files $uri $uri/ /index.php?$query_string;
  }
  # 配置PHP-FPM
  location ~ \.php $ {
    try_files $uri = 404;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME;
    $ducment_root$fastcgi_script_name;
    include fastcgi_params;
  }
}

检测Nginx配置并重新加载配置

$ nginx -t
$ nginx -s reload

读写权限

Laravel项目中根目录下storage文件夹用于存放编译后的Blade模板、Session会话文件、缓存文件及其它框架生成的文件，比如日志等。项目运行时需不断写入数据到该目录下的文件中，因此该目录必须设置具有读写权限。

$ chmod -R nirnava/storage 0755

Laravel项目中根目录下的bootstrap文件夹中包含了引导框架的app.php文件和一个名为cache的缓存目录，cache缓存目录下存放着框架生成的用于提升性能的文件，随着项目开发会不断修改，因此此目录也需要具有读写权限。

$ chmod -R nirnava/bootstrap 0755

应用密钥

项目创建完毕后需为配置应用密钥，应用密钥默认为32位的随机字符串，用于会话即其它加密场景，因此应用密钥对应当前项目来说是相当于一个唯一的加密SALT。

若通过Composer或Laravel安装器创建的项目，项目创建成功后，应用密钥已经通过php artisan key:generate --ansi命令为你设置好。此时可以直接查看项目根目录下的.env环境配置文件中的APP_KEY选项即可发现。若APP_KEY为空或报错，可再此使用应用密钥生成命令，生成并配置。

$ cd nirvana
$ php artisan key:generate --ansi
$ vim .env
APP_KEY=base64:7nbIzLk4jgFu+fJwy97WifCg/yrwcuYB2wBkOpwkwS0=

环境配置

对于应用程序而言，不同的运行环境会对应着不同的配置文件，比如开发环境中会一般会采用名为debug或development的环境配置，产生环境一般会采用名为product的环境配置。对于不同的环境只需要切换环境配置文件即可，修改项目中所有的配置。当然，也可以创建名为.env.testing的测试环境的配置，当运行PHPUnit单元测试时，或以php artisan --env=testing为选项执行Artisan命令时，会自动覆盖默认的.env环境配置。

$ cp .env.example .env.testing

另外需要注意的是.env环境配置中的所有变量都可以被外部环境变量，比如服务器级或系统级的环境变量所覆盖。

Laravel框架采用Vance Lucas的DotEnv库来实现PHP环境配置，打开项目根目录下的composer.lock文件在packages下require选项中会发现。

$ vim composer.lock
"vlucas/phpdotenv": "^3.3"

环境变量配置位于项目根目录下.env文件内，作为全局环境配置文件。通过.env环境变量配置文件加载的环境变量可通过getenv()、$_ENV、$_SERVER自动调用。

本地配置忽略提交

因此创建Laravel框架项目后会自动在项目根目录下生成两个文件.env和.env.example文件，.env为项目当前环境下的配置文件，若不存在则可以拷贝.env.example并命名为.env。

$ cp .env.example .env

由于.env对应当前环境的配置文件，若使用Git源码仓库管理，则无需提交至远程，只需在本机本地保留即可。另外，由于每个开发人员需要的环境配置不同，若提交至远程仓库，每次拉取后都会覆盖本地。其次，若将含有生产环境的配置提交到远程，其中的关于服务器的敏感配置相当于直接暴露出来，直接会造成安全隐患。因此需将.env加入到.gitigore文件中，以忽略提交。

$ cd nirvana
$ vim .gitignore
.env

另外若本地使用IDE开发则默认会在项目根目录下会生成IDE配置文件夹的隐藏文件，比如采用PHPStorm作为开发工具时，会在项目根目录下生成名为.idea的隐藏目录，对于这种也应该忽略提交。

$ vim .gitignore
/.idea

应用配置

应用配置位于config/app.php

$ vim config.php

修改默认UTC时区为中文时区

//"timezone"=>"UTC",
"timezone"=>"PRC"

修改默认本地化英文en为中文zh

//"locale"=>"en",
"locale"=>"zh"