小白的边学边写，一个基于laravel的APP接口【API】（一）

前期准备

原文地址
前言，为何作以及要作个啥
本人姓小名白，彻彻底底编程届小白一名，可是自从大一那会儿接触到编程这件奇妙的事情，就完彻底全的陷入的程序的世界。
这不，最近又开始折腾APP了，话说如今开发一款APP真是容易，只用JavaScript和一点点HTML+css技术就能够完成。可是作APP的后台就不同了。开发了APP，想让读点数据进去，那咱们就要去开发个后台了。
laravel框架，是我最喜欢的PHP框架了，没有之一。去年就曾经用laravel写了个人我的网站但粗糙程度让我十分脸红，好了不扯了，让咱们直接进入主题——先安装laravel吧！

基础环境配置

具体的步骤直接看文档吧laravel5.2安装
我本身的环境是win10上面安装了wampsrver2.5，可是这里值得好好注意一下，用wampsrver2.5了话，这几个地方要改动一下。关于这个请看个人笔记
工具：sublime
浏览器：chrome（要用到的插件postman）

关于API

API（Application Programming Interface,应用程序编程接口）是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工做机制的细节。
须要注意的是：API有它的具体用途，咱们应该清楚它是干啥的。访问API的时候应该输入什么。访问过API事后应该获得什么。

在开始设计API时，咱们应该注意这8点

这里的内容摘抄自大神的博客
后续的开发计划就围绕着这个进行了。（真心好棒的总结）

1.Restful设计原则
2.API的命名
3.API的安全性
4.API返回数据
5.图片的处理
6.返回的提示信息
7.在线API测试文档
8.在app启动时，调用一个初始化API获取必要的信息

用laravel开发API

就在我上愁着要不要从零开始学习的时候，找到了这个插件dingo/api那么如今就来安装吧！
首先必定是下载的没错
在新安装好的laravel的composer.json加入以下内容

"require": {
    "php": ">=5.5.9",
    "laravel/framework": "5.2.*",
    "dingo/api": "1.0.*dev",
    "lucadegasperi/oauth2-server-laravel": "5.1.*"
},

而后打开cmd执行

composer update

在config/app.php中的providers里添加

App\Providers\OAuthServiceProvider::class,
Dingo\Api\Provider\LaravelServiceProvider::class,
LucaDegasperi\OAuth2Server\Storage\FluentStorageServiceProvider::class,
LucaDegasperi\OAuth2Server\OAuth2ServerServiceProvider::class,

在aliases里添加

'Authorizer' => LucaDegasperi\OAuth2Server\Facades\Authorizer::class,

修改app/Http/Kernel.php文件里的内容

protected $middleware = [\LucaDegasperi\OAuth2Server\Middleware\OAuthExceptionHandlerMiddleware::class,
];
protected $routeMiddleware = [
    'oauth' => \LucaDegasperi\OAuth2Server\Middleware\OAuthMiddleware::class,
    'oauth-user' => \LucaDegasperi\OAuth2Server\Middleware\OAuthUserOwnerMiddleware::class,
    'oauth-client' => \LucaDegasperi\OAuth2Server\Middleware\OAuthClientOwnerMiddleware::class,
    'check-authorization-params' => \LucaDegasperi\OAuth2Server\Middleware\CheckAuthCodeRequestMiddleware::class,
    'csrf' => \App\Http\Middleware\VerifyCsrfToken::class,
];

而后执行

php artisan vendor:publish 
php artisan migrate

在.env文件里添加这些配置

API_STANDARDS_TREE=x
API_SUBTYPE=rest
API_NAME=REST
API_PREFIX=api
API_VERSION=v1
API_CONDITIONAL_REQUEST=true
API_STRICT=false
API_DEBUG=true
API_DEFAULT_FORMAT=json

修改config\oauth2.php文件

'grant_types' => [
    'password' => [
        'class' => 'League\OAuth2\Server\Grant\PasswordGrant',
        'access_token_ttl' => 604800,
        'callback' => '\App\Http\Controllers\Auth\PasswordGrantVerifier@verify',
    ],
],

新建一个服务提供者，在app/Providers下新建OAuthServiceProvider.php文件内容以下

namespace App\Providers;

use Dingo\Api\Auth\Auth;
use Dingo\Api\Auth\Provider\OAuth2;
use Illuminate\Support\ServiceProvider;

class OAuthServiceProvider extends ServiceProvider
{
    public function boot()
    {
        $this->app[Auth::class]->extend('oauth', function ($app) {
            $provider = new OAuth2($app['oauth2-server.authorizer']->getChecker());

            $provider->setUserResolver(function ($id) {
                // Logic to return a user by their ID.
            });

            $provider->setClientResolver(function ($id) {
                // Logic to return a client by their ID.
            });

            return $provider;
        });
    }

    public function register()
    {
        //
    }
}

而后打开routes.php添加相关路由

//Get access_token
Route::post('oauth/access_token', function() {
     return Response::json(Authorizer::issueAccessToken());
});

//Create a test user, you don't need this if you already have.
Route::get('/register',function(){
    $user = new App\User();
     $user->name="tester";
     $user->email="test@test.com";
     $user->password = \Illuminate\Support\Facades\Hash::make("password");
     $user->save();
});
$api = app('Dingo\Api\Routing\Router');

//Show user info via restful service.
$api->version('v1', ['namespace' => 'App\Http\Controllers'], function ($api) {
    $api->get('users', 'UsersController@index');
    $api->get('users/{id}', 'UsersController@show');
});

//Just a test with auth check.
$api->version('v1', ['middleware' => 'api.auth'] , function ($api) {
    $api->get('time', function () {
        return ['now' => microtime(), 'date' => date('Y-M-D',time())];
    });
});

分别建立BaseController.php和UsersController.php内容以下

//BaseController
namespace App\Http\Controllers;

use Dingo\Api\Routing\Helpers;
use Illuminate\Routing\Controller;

class BaseController extends Controller
{
    use Helpers;
}

//UsersController
namespace App\Http\Controllers;

use App\User;
use App\Http\Controllers\Controller;

class UsersController extends BaseController
{

    public function index()
    {
        return User::all();
    }

    public function show($id)
    {
        $user = User::findOrFail($id);
        // 数组形式
        return $this->response->array($user->toArray());
    }
}

随后在app/Http/Controllers/Auth/下建立PasswordGrantVerifier.php内容以下

namespace App\Http\Controllers\Auth;
use Illuminate\Support\Facades\Auth;

class PasswordGrantVerifier
{
    public function verify($username, $password)
    {
         $credentials = [
            'email'    => $username,
            'password' => $password,
          ];

          if (Auth::once($credentials)) {
              return Auth::user()->id;
          }

          return false;
    }
}

打开数据库的oauth_client表新增一条client数据

INSERT INTO 'oauth_clients' ('id', 'secret', 'name', 'created_at', 'updated_at') VALUES ('1', '2', 'Main website', '2016–03–13 23:00:00', '0000–00–00 00:00:00');

随后的就是去愉快的测试了，这里要测试的API有
新增一个用户

http://localhost/register

读取全部用户信息

http://localhost/api/users

只返回用户id为4的信息

http://localhost/api/users/4

获取access_token

http://localhost/oauth/access_token

利用token值得到时间，token值正确才能返回正确值

http://localhost/api/time

打开PostMan

---

---

---

---

以上的全部内容不少是来自于其余大牛的博客，很是的感谢dingo/api、Laravel 5 token based Authentication (OAuth 2.0)、phphub的文章