Laravel 5.8简明教程

在这个面向初学者的教程中，我们将学习如何使用最新的PHP开发框架 Laravel 5.8，来创建一个基于MySQL数据库的Web应用，实现联系人的增删改查功能。

1、安装PHP环境

Laravel 5.8 要求PHP 7.1+,mysql>5.7.7，因此我们需要先安装最新版的PHP。在大多数系统上这个过程都很简单。

1.1 安装PHP7.1

在ubuntu上执行以下命令：

1
2
3

~$ sudo add-apt-repository ppa:ondrej/php
~$ sudo apt-get update
~$ sudo apt-get install php7.1

如果你的ubuntu版本是18.04，那么默认的软件仓里就包含了PHP7.2，因此可以直接安装：

1	~$ sudo apt-get install php

1.2 安装必要的PHP模块

Laravel 5.8需要一些扩展模块，可以使用下面的命令安装：

1	~ $ sudo apt-get install php7.1 php7.1-cli php7.1-common php7.1-json php7.1-opcache php7.1-mysql php7.1-mbstring php7.1-mcrypt php7.1-zip php7.1-fpm php7.1-xml

1.3 安装PHP Composer

现在让我们开始安装Composer，PHP的包管理器。

从官网下载安装程序然后进行安装：

1 2	~$ curl -sS https://getcomposer.org/installer -o composer-setup.php ~$ sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

使用下面的命令验证composer的安装：

1	~$ composer

应该可以看到如下输出：

  / ____/___  ____ ___  ____  ____  ________  _____/ /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_//_/
Composer version 1.8.0 2018-12-03 10:31:16Usage:command [options] [arguments]Options:-h, --help                     Display this help message-q, --quiet                    Do not output any message-V, --version                  Display this application version--ansi                     Force ANSI output--no-ansi                  Disable ANSI output-n, --no-interaction           Do not ask any interactive question--profile                  Display timing and memory usage information--no-plugins               Whether to disable plugins.-d, --working-dir=WORKING-DIR  If specified, use the given directory as working directory.-v|vv|vvv, --verbose           Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

2、初始化Laravel 5.8项目

生成一个Laravel 5.8项目非常简单，在终端输入如下命令：

1	~$ composer create-project --prefer-dist laravel/laravel crud-app

上述命令将安装laravel 5.8.3。可以使用下面的命令来验证安装的版本：

1
2
3

~$ cd crud-app
~/crud-app$ php artisan -V
Laravel Framework 5.8.19

3、安装Laravel项目的前端依赖库

在生成的Laravel项目中，package.json文件包含了前端依赖库的描述信息，例如：

axios
bootstrap
cross-env
jquery
laravel-mix
lodash
popper.js
resolve-url-loader
sass
sass-loader
vue

使用npm命令安装这些前端依赖库：

1	~/crud-app$ npm install

npm命令执行完之后，在目录中将会出现node_modules目录。

4、创建MySQL数据库

现在我们来创建一个MySQL数据库来保存数据。在终端启动mysql客户端并在提示时输入密码，然后进入mysql控制台：

1	~$ mysql -u root -p

在mysql控制台输入下面的SQL语句创建db数据库：

1	mysql> create database db;

打开.env文件来更新访问MySQL数据库的账号信息：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=db
DB_USERNAME=root
DB_PASSWORD=******

现在，可以运行migrate命令来创建Laravel需要的SQL数据表了：

1	~/crud-app$ php artisan migrate

5、创建第一个Laravel模型

Laravel使用MVC架构模式来将应用解耦为三个部分：

模型Model用来封装数据访问层
视图View用来封装表示层
控制器Controller用来封装应用控制代码并负责模型和视图的通信

现在让我们来创建第一个Laravel模型，在终端输入如下命令：

1	~/crud-app$ php artisan make:model Contact --migration

上面的命令将创建一个Contact模型以及一个迁移文件，在终端中我们得到类似下面这样的输出：

1 2	Model created successfully. Created Migration: 2019_01_27_193840_create_contacts_table

打开迁移文件database/migrations/xxxxxx_create_contacts_table进行相应的更新：

<?phpuse Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;class CreateContactsTable extends Migration
{/*** Run the migrations.** @return void*/public function up(){Schema::create('contacts', function (Blueprint $table) {$table->increments('id');$table->timestamps();$table->string('first_name');$table->string('last_name');$table->string('email');$table->string('job_title');$table->string('city');   $table->string('country');            });}/*** Reverse the migrations.** @return void*/public function down(){Schema::dropIfExists('contacts');}
}

我们再contracts表中添加这些字段：first_name、last_name、email、job_title、 city 和 country 。

现在可以使用下面的命令在数据库中创建contracts表：

1	~/crud-app$ php artisan migrate

现在让我们看一下Contract模型，我们将使用它来和contracts数据表交互。打开 app/Contact.php 并参考以下内容进行更新：

<?phpnamespace App;use Illuminate\Database\Eloquent\Model;class Contact extends Model
{protected $fillable = ['first_name','last_name','email','city','country','job_title'       ];
}

6、创建Laravel控制器和路由

在创建模型并执行数据迁移后，现在我们创建与Contract模型协同工作的控制器和路由。在终端运行下面的命令：

1	~/crud-app$ php artisan make:controller ContactController --resource

打开app/Http/Controllers/ContactController.php，初始内容如下：

<?phpnamespace App\Http\Controllers;use Illuminate\Http\Request;class ContactController extends Controller
{/*** Display a listing of the resource.** @return \Illuminate\Http\Response*/public function index(){//}/*** Show the form for creating a new resource.** @return \Illuminate\Http\Response*/public function create(){//}/*** Store a newly created resource in storage.** @param  \Illuminate\Http\Request  $request* @return \Illuminate\Http\Response*/public function store(Request $request){//}/*** Display the specified resource.** @param  int  $id* @return \Illuminate\Http\Response*/public function show($id){//}/*** Show the form for editing the specified resource.** @param  int  $id* @return \Illuminate\Http\Response*/public function edit($id){//}/*** Update the specified resource in storage.** @param  \Illuminate\Http\Request  $request* @param  int  $id* @return \Illuminate\Http\Response*/public function update(Request $request, $id){//}/*** Remove the specified resource from storage.** @param  int  $id* @return \Illuminate\Http\Response*/public function destroy($id){//}
}

ContractController类继承自Laravel的Controller类，并且定义了一组方法用于对Contact模型的CRUD操作。现在我们需要实现这些方法。不过在实现这些方法之前，让我们先添加路由。

打开routes/web.php，参考如下内容进行修改：

<?php
Route::get('/', function () {return view('welcome');
});Route::resource('contacts', 'ContactController');

使用Route的resource()静态方法，你可以创建多个路由来暴露资源的多种访问操作。这些路由都映射到ContactController的不同方法上（我们随后将实现这些方法）：

GET/contacts：映射到index()方法
GET /contacts/create：映射到create()方法
POST /contacts：映射到store() 方法
GET /contacts/{contact}：映射到show()方法
GET /contacts/{contact}/edit：映射到edit()方法
PUT/PATCH /contacts/{contact}：映射到update()方法
DELETE /contacts/{contact}：映射到destroy()方法

这些路由用于提供HTML模板，同时也用作Contract模型的API端结点。

7、实现CRUD操作

现在让我们实现控制器的方法。

7.1 C - Create/创建操作

ContactController包含了映射到POST /contracts端结点的store()方法，该方法将用来在数据库中创建一个联系人/contact，映射到GET / contracts/create 的create()方法将用来提供HTML表单。仙子我们来实现这两个方法。

首先重新打开app/Http/Controllers/ContactController.php ，导入Contact模型：

1	use App\Contact;

接下来，找到store()方法进行如下修改：

public function store(Request $request)
{$request->validate(['first_name'=>'required','last_name'=>'required','email'=>'required']);$contact = new Contact(['first_name' => $request->get('first_name'),'last_name' => $request->get('last_name'),'email' => $request->get('email'),'job_title' => $request->get('job_title'),'city' => $request->get('city'),'country' => $request->get('country')]);$contact->save();return redirect('/contacts')->with('success', 'Contact saved!');
}

然后，找到create()方法进行如下修改：

public function create()
{return view('contacts.create');
}

create()函数使用view()方法来返回reousrces/view目录中的create.blade.php模板。

在创建create.blade.php模板之前，我们需要创建一个基础模板，create以及本教程中的其他模板都将继承这个基础模板。

在resources/views目录中，创建base.blade.php文件：

1 2	~/crud-app$ cd resources/views ~/crud-app$ touch base.blade.php

打开resources/views/base.blade.php，添加如下模板：

<!DOCTYPE html>
<html lang="en">
<head><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Laravel 5.8 & MySQL CRUD Tutorial</title><link href="{{ asset('css/app.css') }}" rel="stylesheet" type="text/css" />
</head>
<body><div class="container">@yield('main')</div><script src="{{ asset('js/app.js') }}" type="text/js"></script>
</body>
</html>

现在我们创建create.blade.php模板。首先在views目录创建一个contracts文件夹：

1	~/crud-app/views$ mkdir contacts

然后创建模板：

1 2	~/crud-app/views$ cd contacts ~/crud-app/views/contacts$ touch create.blade.php

打开resources/views/contacts/create.blade.php，添加如下代码：

@extends('base')@section('main')
<div class="row"><div class="col-sm-8 offset-sm-2"><h1 class="display-3">Add a contact</h1><div>@if ($errors->any())<div class="alert alert-danger"><ul>@foreach ($errors->all() as $error)<li>{{ $error }}</li>@endforeach</ul></div><br />@endif<form method="post" action="{{ route('contacts.store') }}">@csrf<div class="form-group">    <label for="first_name">First Name:</label><input type="text" class="form-control" name="first_name"/></div><div class="form-group"><label for="last_name">Last Name:</label><input type="text" class="form-control" name="last_name"/></div><div class="form-group"><label for="email">Email:</label><input type="text" class="form-control" name="email"/></div><div class="form-group"><label for="city">City:</label><input type="text" class="form-control" name="city"/></div><div class="form-group"><label for="country">Country:</label><input type="text" class="form-control" name="country"/></div><div class="form-group"><label for="job_title">Job Title:</label><input type="text" class="form-control" name="job_title"/></div>                         <button type="submit" class="btn btn-primary-outline">Add contact</button></form></div>
</div>
</div>
@endsection

表单效果如下：

7.2R - Read/读取操作

现在让我们读取并显示MySQL数据库中的联系人信息。

打开app/Http/Controllers/ContactController.php文件，找到index()方法并进行如下修改：

public function index()
{$contacts = Contact::all();return view('contacts.index', compact('contacts'));
}

接下来创建index模板resources/views/contacts.index.blade.php：

1	~/crud-app/views/contacts$ touch index.blade.php

打开resources/views/contacts/index.blade.php 添加如下代码：

@extends('base')@section('main')
<div class="row">
<div class="col-sm-12"><h1 class="display-3">Contacts</h1>    <table class="table table-striped"><thead><tr><td>ID</td><td>Name</td><td>Email</td><td>Job Title</td><td>City</td><td>Country</td><td colspan = 2>Actions</td></tr></thead><tbody>@foreach($contacts as $contact)<tr><td>{{$contact->id}}</td><td>{{$contact->first_name}} {{$contact->last_name}}</td><td>{{$contact->email}}</td><td>{{$contact->job_title}}</td><td>{{$contact->city}}</td><td>{{$contact->country}}</td><td><a href="{{ route('contacts.edit',$contact->id)}}" class="btn btn-primary">Edit</a></td><td><form action="{{ route('contacts.destroy', $contact->id)}}" method="post">@csrf@method('DELETE')<button class="btn btn-danger" type="submit">Delete</button></form></td></tr>@endforeach</tbody></table>
<div>
</div>
@endsection

7.3 U - Update/更新操作

现在我们实现数据更新操作。打开app/Http/Controllers/ContactController.php 文件，找到edit($id)方法进行如下更新：

public function edit($id)
{$contact = Contact::find($id);return view('contacts.edit', compact('contact'));
}

接下来我们实现update()方法：

public function update(Request $request, $id)
{$request->validate(['first_name'=>'required','last_name'=>'required','email'=>'required']);$contact = Contact::find($id);$contact->first_name =  $request->get('first_name');$contact->last_name = $request->get('last_name');$contact->email = $request->get('email');$contact->job_title = $request->get('job_title');$contact->city = $request->get('city');$contact->country = $request->get('country');$contact->save();return redirect('/contacts')->with('success', 'Contact updated!');
}

现在需要添加edit模板，在resources/views/contacts/目录中创建edit.blade.php文件：

1	~/crud-app/views/contacts$ touch edit.blade.php

打开文件resources/views/contacts/edit.blade.php，添加如下代码：

@extends('base')
@section('main')
<div class="row"><div class="col-sm-8 offset-sm-2"><h1 class="display-3">Update a contact</h1>@if ($errors->any())<div class="alert alert-danger"><ul>@foreach ($errors->all() as $error)<li>{{ $error }}</li>@endforeach</ul></div><br /> @endif<form method="post" action="{{ route('contacts.update', $contact->id) }}">@method('PATCH') @csrf<div class="form-group"><label for="first_name">First Name:</label><input type="text" class="form-control" name="first_name" value={{ $contact->first_name }} /></div><div class="form-group"><label for="last_name">Last Name:</label><input type="text" class="form-control" name="last_name" value={{ $contact->last_name }} /></div><div class="form-group"><label for="email">Email:</label><input type="text" class="form-control" name="email" value={{ $contact->email }} /></div><div class="form-group"><label for="city">City:</label><input type="text" class="form-control" name="city" value={{ $contact->city }} /></div><div class="form-group"><label for="country">Country:</label><input type="text" class="form-control" name="country" value={{ $contact->country }} /></div><div class="form-group"><label for="job_title">Job Title:</label><input type="text" class="form-control" name="job_title" value={{ $contact->job_title }} /></div><button type="submit" class="btn btn-primary">Update</button></form></div>
</div>
@endsection

7.4 D - Delete/删除操作

最后我们要实现删除操作。打开app/Http/Controllers/ContactController.php文件，找到destroy() 方法，然后进行如下的更新：

public function destroy($id)
{$contact = Contact::find($id);$contact->delete();return redirect('/contacts')->with('success', 'Contact deleted!');
}

容易注意到CRUD API方法中重定向到/contacts路由时，传入了一个index模板中没有的消息，现在让我们来修改。

打开resources/views/contacts/index.blade.php文件，找到如下代码：

<div class="col-sm-12">@if(session()->get('success'))<div class="alert alert-success">{{ session()->get('success') }}  </div>@endif
</div>

我们还需要添加一个按钮：

1
2
3

<div><a style="margin: 19px;" href="{{ route('contacts.create')}}" class="btn btn-primary">New contact</a>
</div>

页面效果如下：

原文链接：Laravel 5.8 Tutorial: Build your First CRUD App with Laravel and MySQL (PHP 7.1+)