На php тоже может быть легко и быстро

На мой взгляд, язык php всегда был довольно хорошим решением для создания сложного бекэнда веб-приложений, а в девяностые и нулевые приобрел такую огромную популярность (именно огромную, сопоставимую с IE для веб-серфига того времени) в первую очередь благодаря легкости, скорости разработки и поддержки кода. Но те времена прошли. Сегодня считается, что приложения на php стали монструозны, долго и сложно запускаемы, способны работать только с подтягиванием множества зависимостей в директорию /vendor…

Зачастую все именно так, но я хочу попробовать вам показать, что может быть иначе. Попробуем сделать простое API и приложить не больше усилий чем при использовании Node.js или Go.

Под катом мой пример того, как можно быстро и без лишней головной боли сделать API на php.

Я решил использовать понравившийся мне по работе в нескольких проектах фреймворк Slim (https://www.slimframework.com/), потому что имею опыт написания/поддержки с нуля и роутера, и ORM, а также поддержки самописных CMS, и это точно не про «быстро и легко».

Для решения на фреймворке Slim не понадобится устанавливать дополнительных расширений на php. Кроме, конечно же, самого сервера (Apache 2, Nginx или другого на наш вкус), сервера баз данных и composer, но этот набор обычно уже есть и на серверах, и тем более на хостинге. Теперь начинаем кухарить (cooking app):

mkdir my-slim-api && cd my-slim-api composer init

На этом шаге нужно заполнить данные о новом приложении так, чтобы в результате получился файл composer.json примерно такого вида:

{    "name": "zhukmax/slim",    "type": "project",    "license": "MIT",    "autoload": {      "psr-4": {        "Zhukmax\\Slim\\": "src/"      }    },    "require": {} }

Устанавливаем зависимости, сам Slim, а также реализацию интерфейсов http-сообщений (PSR-7) и интерфейсов фабрик http-сообщений (PSR-17):

composer require slim/slim:"4.*" composer require slim/psr7

Теперь мы можем создать простое API в одном index-файле, возвращающее, как сейчас «модно-молодежно», json строку в теле ответа:

<?php  require __DIR__ . '/vendor/autoload.php';    use Psr\Http\Message\ResponseInterface as Response;  use Psr\Http\Message\ServerRequestInterface as Request;  use Slim\Factory\AppFactory;    $app = AppFactory::create();    $app->get('/', function (Request $request, Response $response, $args) {   $data = array('name' => 'Max', 'role' => 'web developer');   $response->getBody()->write(json_encode($data));    return $response->withHeader('Content-Type', 'application/json');  });    $app->run();

При этом укажем в composer.json информацию, что нам требуется расширение php-json (и если расширение не установлено – установим)

"require": {   "slim/slim": "4.*",   "slim/psr7": "^1.4",   "ext-json": "*" }

Работа с данными из MySQL

В Slim придется сначала установить стороннее решение для удобной работы с базой, так как сам фреймворк поставляется без ORM. Можно использовать и решение от Laravel Eloquent и популярную Doctrine, которая также подойдет и для работы с NoSQL базами. Для нашей статьи выберем Idiorm за простоту использования.

composer require j4mie/idiorm

Настраиваем подключение и запрашиваем данные:

<?php  ORM::configure([   // Обратите внимание, что localhost не работает по умолчанию,   // прежде чем паниковать попробуйте 127.0.0.1    'connection_string' => 'mysql:host=127.0.0.1;dbname=mydb',    'username' => 'root',    'password' => '124'  ]);   $app->get('/users', function (Request $request, Response $response, $args) {    $users = ORM::forTable("users")->find_array();   $response->getBody()->write(json_encode($users));    return $response; }); 

Теперь, если запустить приложение и проверить url, мы получим список всех записей в таблице users в виде json-строки.

Создать, обновить, получить и удалить

Все должно работать отлично, и теперь можно создать методы для получения одного пользователя, добавления нового пользователя, изменения и удаления. Для этого используем GET, POST, PUT и DELETE http-запросы и их обработку.

<?php  $app->post('/users', function (Request $request, Response $response, $args) {    $parsedBody = $request->getParsedBody();      $user = ORM::forTable("users")->create();    $user->name = $parsedBody['name'] ?? '';      if ($user->save()) {      $successRes = $response->withStatus(201);      $successRes->getBody()->write(json_encode([        "message" => "Success"      ]));    	  return $successRes;    } else {      $errorRes = $response->withStatus(501);      $errorRes->getBody()->write(json_encode([        "message" => "Error"      ]));          return $errorRes;    }  });

Мы, конечно же, хотим, чтобы наш код был готов к ошибкам, и поэтому пишем их обработку в теле функции. Кроме того, что мы добавили обработку ошибки сохранения нового пользователя в таблице, еще можно сделать проверку соответствия полей определенным шаблонам, например, их обязательность. Но для этого лучше подходят модели, которые могут немного по-разному создаваться в зависимости от выбранного ORM. В Idiorm нет стандарта оформления класса моделей, да и описание фильтров и шаблонов немного за рамками данной статьи, так что оставим это за скобками. Мы же хотим быстро сделать рабочее API, а доводить его до ума можно годами, как показывает практика.

Контроллеры и actions

Хранить код всех запросов и их обработки в одном index.php файле – затея не из лучших, поэтому давайте воспользуемся возможностью фреймворка по созданию контроллеров. В обработчике маршрута оставим только описание пути и ссылку на нужный нам метод в классе-контроллере.

$app->get('/users/{id}', [UserController::class, "getOne"]);

Что мне лично нравится у Slim – мы можем соблюдать негласный стандарт об использовании слова action в наименовании методов, а можем от него отойти в пользу другого локального стандарта. Теперь, когда мы используем не лямбда-функции, а полноценные классы, мы можем удобно вынести повторяющийся код в отдельный приватный метод, как и сделано в примере ниже. Либо создавать хелперы и трейты. Не то чтобы мы не могли это все делать раньше, но как же теперь мило сердцу получается.

<?php  class UserController  {    public function getOne(Request $request, Response $response, $args): Response    {      $id = (int)$args['id'] ?? 0;      $user = ORM::forTable("table1")->findOne($id);        if (!$user) {        return self::errorResponse($response, 404, "Error text");      }        $response->getBody()->write(json_encode([        "id" => $user->id,        "name" => $user->name      ]));        return $response;    }     private static function errorResponse(Response $response, int $code, string $text): Response    {      $errorRes = $response->withStatus($code);      $errorRes->getBody()->write(json_encode([        "message" => $text      ]));        return $errorRes;    } }

Итог

В первую очередь, я удовлетворил свой собственный интерес. Мне хотелось быстро набросать на php простое API, как я много раз делал на Express, когда создавал приложения на Angular и требовалось что-то поднять на backend. И я считаю, что описанный вариант более чем достоин для использования. Он предполагает возможность развиваться, увеличивать количество строк кода. При этом может быть поддерживаемым и недорогим решением, так как достаточно прост в освоении даже не очень опытным web-разработчиком.

Так как помещать весь код в статью довольно неудобно и она сильно увеличится, я сделал на github репозиторий (https://github.com/ZhukMax/slim-api), в котором можно посмотреть весь получившийся код.