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

如果希望快速掌握区块链应用的开发，推荐汇智网的区块链应用开发系列教程， 内容涵盖比特币、以太坊、eos、超级账本fabric和tendermint等多种区块链，以及 java、go、nodejs、python、php、dart等多种开发语言。

1、安装PHP环境

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

1.1 安装PHP7.1

在ubuntu上执行以下命令：

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

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

~$ sudo apt-get install php

1.2 安装必要的PHP模块

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

~ $ 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的包管理器。

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

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

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

~$ composer

应该可以看到如下输出：

 / ____/___ ____ ___ ____ ____ ________ _____
 / / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
 /_/
Composer version 1.8.0 2018-12-03 10:31:16
Usage:
 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项目非常简单，在终端输入如下命令：

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

上述命令将安装laravel 5.8.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命令安装这些前端依赖库：

~/crud-app$ npm install

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

4、创建MySQL数据库

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

~$ mysql -u root -p

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

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数据表了：

~/crud-app$ php artisan migrate

5、创建第一个Laravel模型

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

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

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

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

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

Model created successfully.
Created Migration: 2019_01_27_193840_create_contacts_table

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

<?php
use 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表：

~/crud-app$ php artisan migrate

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

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

6、创建Laravel控制器和路由

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

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

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

<?php
namespace 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模型：

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文件：

~/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文件夹：

~/crud-app/views$ mkdir contacts

然后创建模板：

~/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：

~/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文件：

~/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>

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

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

页面效果如下：

原文链接：Laravel 5.8简明教程 — 汇智网