В предыдущей статье мы говорили о микросервисной архитектуре как о подходе к разработке. В этой части предлагаю поговорить о варианте реализации API сервиса на языке PHP.

Основное требования к нашему сервису это изолированность от других сервисов — наличие собственной базы данных, работа на собственном веб-сервере.

Для примера напишем Rest API, который будет хранить и управлять нашими пользователями. Он будет иметь одну точку входа (файл index.php), а методы для работы и параметры мы будем передавать в качестве GET параметров.

Мы хотим чтобы он умел делать следующие вещи:

1. По маршруту index.php?method=users.get&id=some_id — мы должны уметь получать пользователя.
2. По маршруту index.php?method=users.create&name=some_name&login=some_login&password=some_password мы должны иметь возможность создать пользователя
3. По маршруту index.php?method=users.update&id=some_id&name=some_name&login=some_login&password=some_password мы должны иметь возможность обновить информацию о нем
4. По маршруту index.php?method=users.delete?id=some_id мы сможем удалять нашего пользователя.

Все эти вещи мы рассматриваем пока вне контекста о безопасности, о ней мы поговорим позже.

Начнем реализацию с нашего index.php, который в базовом представлении будем содержать следующую заготовку:

$method = $_GET['method'];
switch ($method){
    case "users.get":{
        break;
    }
    case "users.create":{
        break;
    }
    case "users.update":{
        break;
    }

    case "users.delete":{
        break;
    }
}

Затем нам необходимо реализовать нашу модель данных, в данном случае User

 <?php

namespace Users;


use Jsonable;

class User implements Jsonable
{
    private $id;
    private $password;
    private $login;
    
    public function __construct()
    {

    }

    public function toJson()
    {
        return json_encode(array("id" => $this->id, "password" => $this->password, "login" => $this->login));

    }

    public function getId()
    {
        return $this->id;
    }
    public function setId($id)
    {
        $this->id = $id;
    }

 
    public function getPassword()
    {
        return $this->password;
    }

    public function setPassword($password)
    {
        $this->password = $password;
    }

 
    public function getLogin()
    {
        return $this->login;
    }

    
    public function setLogin($login)
    {
        $this->login = $login;
    }

    public function __toString()
    {
         return $this->toJson();
    }


}

Это обыкновенный класс, который наследует интерфейс Jsonable, гарантирующий в классе наличие метода toJson(), содержит геттеры и сеттеры для работы с приватными полями.

<?php

interface Jsonable
{
    public function toJson();
}

Затем реализуется класс UserFactory. Его назначение — прослойка между нашим классом User (сущности) и базой данных MySQL. Суть этой прослойки в изоляции нашей сущности от того где она и как хранится.

<?php

namespace Users;
use Users\User;

/**
 * Created by PhpStorm.
 * User: kda
 * Date: 01.07.2019
 * Time: 15:28
 */

class UserFactory
{

   public static function getByID($id){
       /* @var Mysqli $mysqli*/
       $mysqli = $GLOBALS['mysqli'];
       $model =  $mysqli->query("SELECT * FROM `users` WHERE `id` = '{$id}'")->fetch_object();
       $user = new User();
       $user->setId($model->id);
       $user->setPassword($model->password);
       $user->setLogin($model->login);
       return $user;
   }
    public static function delete($user){
        /* @var Mysqli $mysqli*/
        $mysqli = $GLOBALS['mysqli'];
        if($user->getId() != null){
            $mysqli->query("DELETE FROM `users` WHERE `id` = '{$user->getId()}'");
        }
        return null;
    }


}

Ну и последнее — интеграция с нашим index.php сервиса:

<?php
require_once '../../vendor/autoload.php';

use Users\User;
use Users\UserFactory;

/*
 * PRIVATE:
 * GET: /services/users?method=users.get&id=1
 * GET: /services/users?method=users.create&name=somename&password=123456
 * GET: /services/users?method=users.save&id=1&name=somename&password=123456
 * GET: /services/users?method=users.delete&id=1
 *  *
 * */

$method = $_GET['method'];
switch($method){
    case "users.get":{
        $id = $_GET['id'];
        echo UserFactory::getByID($id);
        break;
    }

    case "users.create":{
        $user = new User();
        $user->setLogin($_GET['login']);
        $user->setPassword($_GET['password']);
        $user = UserFactory::save($user);
        echo $user;
        break;
    }

    case "users.save":{
        $user = new User();
        $user->setLogin($_GET['login']);
        $user->setPassword($_GET['password']);
        $user->setId($_GET['id']);
        $user = UserFactory::save($user);
        echo $user;
        break;
    }
    case "users.delete":{
        $id = $_GET['id'];
        $user = UserFactory::getByID($id);
        echo UserFactory::delete($user);
        break;
    }
}