创建并运行一个新的 Laravel 项目

学院君

发布于 2020-10-19 09:45:08

6.7K0

发布于 2020-10-19 09:45:08

文章被收录于专栏：学院君的专栏学院君的专栏

经过 PHP 入门到实战系列的基础学习，接下来我们就可以正式开始 Laravel 框架的学习和使用了。而这一切都需要从创建一个新的 Laravel 项目开始。

注：本系列教程基于 Laravel 5.7+

1、创建一个新的 Laravel 项目

正如官方文档所言，有两种方式可以创建一个新的 Laravel 项目，这两种创建方式都是从命令行执行的：第一种是通过全局的 Laravel 安装器，另一种是通过 Composer 的 create-project 命令。

推荐使用第一种方式，比较简单，而执行这两种方式之前，都需要系统已经安装过 PHP 和 Composer（如果使用 Valet 或 Laragon 的话，则应该已经安装过了，如果使用的是 Homestead 或 Laradock 的话，宿主环境也要安装下，便于后续操作，如果未曾安装，请参考 Valet 和 Laragon 安装教程）。

使用 Laravel 安装器安装

安装 Laravel 安装器很简单，在命令行执行以下命令即可（如果已经安装过，会自动进行更新）：

composer global require laravel/installer

安装完成后，后续就可以通过 laravel new [项目名称] 来创建新的 Laravel 项目了：

laravel new blog

该命令会在当前目录下创建一个新的名为 blog 的应用：

使用 Composer create-project 命令安装

除此之外，还可以通过 Composer 自带的 create-project 命令来安装新应用：

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

效果和上面使用安装器安装的一样，使用这个方式安装的一个好处是可以安装旧版本的 Laravel 项目，比如要安装 5.6 版本的项目 blog56 ，可以这么做：

composer create-project laravel/laravel blog56 5.6.* --prefer-dist

2、Laravel 应用的目录结构

安装完成后，我们来看一下新安装 Laravel 项目 blog 的目录结构：

app：存放应用核心代码，如模型、控制器、命令、服务等
bootstrap：存放 Laravel 框架每次启动时用到的文件
config：用于存放项目所有配置文件
database：存放数据库迁移和填充类文件
public：Web 应用入口目录，用于存放入口文件 index.php 及前端资源文件（CSS、JS、图片等）
resources：用于存放与非 PHP 资源文件，如视图模板、语言文件、待编译的 Vue 模板、Sass、JS 源文件
routes：项目的所有路由文件都定义在这里
storage：用于存放缓存、日志、上传文件、已经编译过的视图模板等
tests：存放单元测试及功能测试代码
vendor：通过 Composer 安装的依赖包都存放在这里，通常该目录会放到 .gitignore 文件里以排除到版本控制系统之外

注：更多关于目录结构的信息，可参考官方文档。

文件

.env.example/.env：用于配置环境变量，.env.example 是一个示例模板，而 .env 是真正的配置文件，由于包含敏感信息，通常也将其放到 .gitignore 文件中。
artisan：允许你在项目根目录下通过 php artisan 执行 Artisan 命令
.gitignore 和 .gitattributes：Git 配置文件
composer.json 和 composer.lock：Composer 配置文件
webpack.mix.js：Laravel Mix Webpack 配置文件，用于编译和打包前端资源
package.json：配置前端资源依赖和脚本（类似于 composer.json 之于 PHP）
phpunit.xml：PHPUnit 配置文件
server.php：用于通过 php artisan serve 启动 PHP 内置服务器进行一些简单的本地预览
yarn.lock：类似于 composer.lock 之于 Composer，指定 NPM 包版本
.editorconfig：用于在不同 IDE 或编辑器中维护代码风格的一致性

3、配置

Laravel 应用的一些核心配置，比如数据库、队列、邮件等，都位于 config 目录下，通过配置文件名称就可以很直观地甄别出不同的服务配置。这些配置文件都会返回一个数组，数组中的每个值都可以通过配置键获取（配置键以配置文件名为前缀，以「.」号分隔数组层级），例如，如果你在 config/services.php 中定义了如下配置：

// config/services.php 
return [
    'sparkpost' => [
        'secret' => env('SPARKPOST_SECRET'),
    ],
];

然后，你就可以通过 config('services.sparkpost.secret') 来访问配置值。

如上例所示，所有的因环境而异的变量配置值（尤其是敏感信息）都应该存放到根目录下的 .env 环境变量文件中：

SPARKPOST_SECRET = xyj_laravelacademy.org

然后在配置文件中通过 env() 辅助函数传入键名 SPARKPOST_SECRET 来获取，这样做有两个好处：一是将敏感信息存放到版本控制系统（如 Git、Svn）之外，提高了系统的安全性；此外还可以方便我们在不同环境中（每个环境有自己独立的 .env 文件）使用不同的配置值，提高了代码的复用性和灵活性。

注：更多配置信息请参考官方文档。

4、运行

安装好 Laravel 项目，了解了目录结构及其作用，以及如何对项目进行配置后，我们就可以运行这个应用了，启动方式因开发环境而异，我们在前面的 Homestead、Laradock、Valet 以及 Laragon 中已经分别演示过了，这里不再赘述，我们以 Laradock 为例，通过配置项目域名为 blog.test，在浏览器中访问 http://blog.test，即可看到应用首页：

我会将本系列教程代码提交到 Github 仓库：https://github.com/nonfu/laravel-tutorial-code，以下是关联本地分支到 Github 项目主干并第一次提交代码的示例操作：

cd blog
git init
git remote add origin https://github.com/nonfu/laravel-tutorial-code
git add .
git commit -m '新建一个Laravel项目'
git branch --set-upstream-to=origin/master master
git pull origin master --allow-unrelated-histories
git push

这样，就可以在 Github 上看到刚刚提交的代码了：