摘要：介紹在開發(fā)后臺接口現(xiàn)在更多的企業(yè)選擇了來開發(fā)后臺接口當(dāng)然和不失為是一種不錯的選擇不過這里就以為例基于框架開發(fā)后臺這里也是如果你是從事其他方向想做一些后臺開發(fā)都可以去嘗試一下的當(dāng)然實(shí)例項(xiàng)目我會不放在我的上僅供參考地址前期準(zhǔn)備當(dāng)然前提是安裝

在開發(fā)后臺接口現(xiàn)在更多的企業(yè)選擇了PHP來開發(fā)后臺接口 當(dāng)然Python和NodeJs不失為是一種不錯的選擇

不過這里就以PHP為例 基于Laravel框架開發(fā)后臺API 這里也是如果你是從事其他方向想做一些后臺API開發(fā) 都可以去嘗試一下的

當(dāng)然實(shí)例項(xiàng)目我會不放在我的github上僅供參考   @geekGhc
github demo地址  https://github.com/GeekGhc/dingo-api-demo

當(dāng)然前提是安裝PHP的環(huán)境 因?yàn)?b>PHP7無論是從性能還是以后的推廣度都是首選

所以如果想去繁從簡的話可以安裝PHP的集成環(huán)境 這里可以XAMPP 這里給出下載地址

https://www.apachefriends.org/zh_cn/index.html 選擇7.1版本安裝即可

當(dāng)然安裝過程很簡單 但要保證將PHP設(shè)置為環(huán)境變量 這樣至少我們才可以使用php命令

安裝結(jié)束后 終端執(zhí)行

$ php --version

查看到對應(yīng)的版本即可

接下來就是安裝composer 這是PHP的安裝依賴庫 我們可以下載到我們需要的第三方依賴包

這里也給出相應(yīng)的地址 https://getcomposer.org/doc/00-intro.md#downloading-the-composer-executable

對于不同的平臺 安裝方式肯定不一樣 不過相對來說在windows環(huán)境下 可以下載完可執(zhí)行文件直接安裝即可 安裝系統(tǒng)盤就行

安裝完畢后確保composer依舊在環(huán)境變量中 在終端執(zhí)行

$ composer -V

查看到對應(yīng)的版本即可

這些關(guān)于PHP的安裝完畢之后 那么基本就可以進(jìn)入到Laravel的安裝

如果說沒有接觸過Laravel的話可以這兩種方式其實(shí)都是不錯的選擇

使用之前的composer下載Laravel安裝包

$ composer global require "laravel/installer"

請確定你已將 ~/.composer/vendor/bin 路徑加到 PATH，只有這樣系統(tǒng)才能找到 laravel 的執(zhí)行文件

一旦安裝完成，就可以使用 laravel new 命令在指定目錄創(chuàng)建一個新的 Laravel 項(xiàng)目，例如：laravel new blog

你也可以通過 Composer 在命令行運(yùn)行 create-project 命令來安裝 Laravel：

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

為了后面的演示 這里我創(chuàng)建了一個新的項(xiàng)目

$ laravel new codespace-api

這里的項(xiàng)目名隨意 這樣可以安裝到最近的版本

Sublime或者PHPStrom打開項(xiàng)目 打開.env文件
這里有一小段配置需要改下

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=codespace-api
DB_USERNAME=root
DB_PASSWORD=password

這里的后面信息就是修改我們連接的Mysql數(shù)據(jù)庫的信息 包括數(shù)據(jù)庫名 數(shù)據(jù)庫用戶名和密碼

修改為你本地或者服務(wù)器上的數(shù)據(jù)即可

啟動內(nèi)置服務(wù)器服務(wù)

$ php artisan serve

因?yàn)檫@里我們只是作為后臺開發(fā) 那么我們必須了解幾下幾點(diǎn)我們是需要學(xué)習(xí)和掌握的

1.接口的書寫規(guī)范和設(shè)計(jì)規(guī)則

2.sql語句的編寫和數(shù)據(jù)表的設(shè)計(jì)

3.有關(guān)api的用戶認(rèn)證和token的了解

首先談下第一個就是接口的書寫規(guī)范和設(shè)計(jì)風(fēng)格 這個其實(shí)在阮一峰的一個文章早就談過 盡管會有點(diǎn)爭議 對于學(xué)習(xí)

restful api的設(shè)計(jì) 還是很值得參考的

在了解了api的設(shè)計(jì)風(fēng)格后 再結(jié)合我們平常所使用的第三方的api接口其實(shí)設(shè)計(jì)起來就是這樣

不過接口的具體設(shè)計(jì)還是得根據(jù)客戶端的項(xiàng)目需求而定

對于第二個sql語句的編寫和數(shù)據(jù)表的設(shè)計(jì) 這個也就因人而異了 如果有多年的開發(fā)經(jīng)驗(yàn) 我想一些sql查詢 包括多表關(guān)聯(lián)都是很好解決的

在Laravel中只是語法的不同罷了 當(dāng)然對于多表關(guān)聯(lián) 在Laravel會有Eloquent Model對應(yīng)的關(guān)系可以很好的解決 這里只談就用原生的sql語句來編寫我們的數(shù)據(jù)信息的話

這里可以需要閱讀Laravel 的數(shù)據(jù)庫操作文檔(給出中文為了更好的說明 可以的話還是看看官方的英文文檔比較好)

這里給出地址 http://d.laravel-china.org/docs/5.3/queries

這里可以找到關(guān)于操作數(shù)據(jù)庫的一些sql語法

在Laravel數(shù)據(jù)表的設(shè)計(jì)可以對應(yīng)著Model 也可以多帶帶創(chuàng)建 如果只是專注后臺 可以創(chuàng)建我們需要的表

所有表的設(shè)計(jì)內(nèi)容都是在database/migrations下 一開始是為我們創(chuàng)建了users和password_resets表的

這里我們再去創(chuàng)建一個posts表的話 在項(xiàng)目終端執(zhí)行

$ php artisan make:model Lesson -m

這樣就可以創(chuàng)建我們所對應(yīng)的lessons表 在這個migrations里也就是標(biāo)的遷移文件寫我們的lessons表的字段信息

php?start_inline=1
Schema::create("lessonss", function (Blueprint $table) {
    $table->increments("id");
    $table->string("title");
    $table->text("body");
    $table->boolean("free");
    $table->timestamps();
});

在Laravel中我們可以去定義個字段的測試信息 也就是我們的Seeder

在databases/factories/ModelFactory.php中加入posts表的字段

$factory->define(AppLesson::class, function (FakerGenerator $faker) {
    return [
        "title" => $faker->sentence,
        "body" => $faker->paragraph,
        "free" => $faker->boolean()
    ];
});

定義完表的結(jié)構(gòu) 那么接下來就是遷移我們的數(shù)據(jù)表 因?yàn)橹耙呀?jīng)配置過數(shù)據(jù)庫的相關(guān)信息 所以在項(xiàng)目根目錄

$ php artisan migrate

回到數(shù)據(jù)庫會看到我們的數(shù)據(jù)表

再去生成20條測試數(shù)據(jù) 打開項(xiàng)目的目錄終端打開tinker

$ php artisan thinerk;

指定命名空間

$ namespace App;

生成20條測試數(shù)據(jù)

$ factory(Lesson::class,20)->create();

回車即可生成20條測試數(shù)據(jù) 打開數(shù)據(jù)庫在lessons表就可以看到

為了方便路由處理 我們?nèi)ド梢粋€控制器 為了不和應(yīng)用混淆 我們在App目錄下 新建Api文件夾

并新建Controllers和Transformer目錄為了存放我們的控制器和處理字段返回

在Controllers目錄下也新建我們的控制器基類 可以模仿著應(yīng)用控制器里的

下面的話我們在這里的控制器就可以繼承這個基類
話不多說  生成我們的LessonsController 在命令行執(zhí)行
$ php artisan make:controller AppApiControllersLessonsController
下面的可能就是集成Dingo api和Jwt認(rèn)證了 如果沒有用過Laravel的也沒有關(guān)系  可以結(jié)合下面我的博客文章
安裝 dingo api

在composer.json文件里添加
"dingo/api": "1.0.*@dev"
接著在laravel項(xiàng)目的config的app.php去添加服務(wù)
"providers" => [
    DingoApiProviderLaravelServiceProvider::class
]
再去生成相應(yīng)的配置文件
$ php artisan vendor:publish --provider="DingoApiProviderLaravelServiceProvider"
如果需要實(shí)現(xiàn)jwt 同樣的也是去安裝頁面 安裝這個package
"require": {
    "tymon/jwt-auth": "0.5.*"
}
添加對應(yīng)的服務(wù):
"TymonJWTAuthProvidersJWTAuthServiceProvider"
當(dāng)然也是需要去配置一下他的alias
"JWTAuth" => TymonJWTAuthFacadesJWTAuth::class,
"JWTFactory" => TymonJWTAuthFacadesJWTFactory::class
生成配置文件
$ php artisan vendor:publish --provider="TymonJWTAuthProvidersJWTAuthServiceProvider"
生成一個key
$ php artisan jwt:generate
當(dāng)然在composer.json添加完依賴包 需要去下載相關(guān)的擴(kuò)展包 即在項(xiàng)目終端執(zhí)行 composer update 
使用
這個時候我們是在開發(fā)的環(huán)境下 還需對Dingo進(jìn)行相應(yīng)的配置 在.env文件里
API_STANDARDS_TREE=vnd
添加前綴
API_PREFIX=api
填寫版本 這個我們之前自己寫測試的時候也是提供的v1以此來區(qū)別版本
API_VERSION=v1
開啟Debug模式
API_DEBUG=true
關(guān)閉Script模式
API_STRICT=false 
這樣的話我們安裝就算已經(jīng)完成了  具體的業(yè)務(wù)部分在另一篇文章  Laravel從零開發(fā)后臺API（二）
文章涉及到用戶的登錄注冊  以及我們之前注冊好的Lessson Model的信息獲取
參考我的博客文章

Laravel API開發(fā)初探
Laravel API結(jié)合Dingo API和JWT