composer require digitalstars/simple-api
Скрипту обязательно должен приходить параметр module с названием модуля.
-
Первый параметр - название модуля
-
Остальные параметры - необходимые данные. Если в функции params поставить ? перед параметром, то он считается необязательным
-
В массив answer добавляются необходимые данные для фронта. В конце выполнения кейса, библиотека автоматически вызывает деструктор и данные в json формате отправляются фронту.
-
если вам удобнее передавать много данный в json формате, то передавайте чистый json вместе с модулем в тело POST запроса
-
breake в кейсах ставить не надо, будет и без них нормально работать. Если не нравится инспекции в IDE о пропущенном break, то просто выключите его
-
если в answer передать массив, он автоматически конвертируется в json
-
OPTIONS запросы игнорируются(полезно если, запросы идут от react/vue/etc)
-
есть метод error, в который передается текст. Этот метод завершает скрипт и возвращает на фронт json вида:
{"error":"ваш текст"}
-
Если не указать хотя бы один из необходимых параметров, то вернется json:
{"error":"missed params"}
GET Запрос:
site.ru/api.php?module=auth&login=admin&password=admin
<?php
require_once 'lib/vendor/autoload.php';
use DigitalStars\SimpleAPI;
$api = new SimpleAPI();
switch ($api->module) {
case 'auth':
$data = $api->params(['login', 'password']); //если одного из параметров не будет, скрипт завершится с error
$api->answer['auth'] = ($data['login'] == 'admin' && $data['password'] == 'admin');
}
Ответ в json:
{"auth" : true}
GET Запрос:
site.ru/api.php?module=reg&login=admin&password=admin&name=Fedor
<?php
require_once 'lib/vendor/autoload.php';
use DigitalStars\SimpleAPI;
$api = new SimpleAPI();
switch ($api->module) {
case 'auth':
$data = $api->params(['login', 'password', '?name']);
if(isset($data['name']])) {
$api->answer['status'] = true;
$api->answer['info'] = ['login' => $data['login'], 'password' => $data['password']];
} else
$api->answer['status'] = false;
}
Ответ в json:
{"status" : true, "info":{"login":"admin", "password":"admin"}}
GET Запрос:
site.ru/api.php?module=reg&login=admin&password=admin&age=10
<?php
require_once 'lib/vendor/autoload.php';
use DigitalStars\SimpleAPI;
$api = new SimpleAPI();
switch ($api->module) {
case 'auth':
$data = $api->params(['login', 'password', 'age']);
if($data['age'] < 18)
$api->error('Извини, но тебе меньше 18 лет');
}
Ответ в json:
{"error" : "Извини, но тебе меньше 18 лет"}
Как видите, никакого различия в коде по сравнению с 1 примером
GET Запрос:
site.ru/api.php?module=auth&json_data={"login":"123","password":"123"}
<?php
require_once 'lib/vendor/autoload.php';
use DigitalStars\SimpleAPI;
$api = new SimpleAPI();
switch ($api->module) {
case 'auth':
$data = $api->params(['login', 'password']);
$api->answer['auth'] = ($data['login'] == 'admin' && $data['password'] == 'admin');
}
Ответ в json:
{"auth" : false}
POST Запрос:
site.ru/api.php
Тело запроса:
{"module":"auth", "login":"admin", "password":"admin"}
<?php
require_once 'lib/vendor/autoload.php';
use DigitalStars\SimpleAPI;
$api = new SimpleAPI();
switch ($api->module) {
case 'auth':
$data = $api->params(['login', 'password']); //если одного из параметров не будет, скрипт завершится с error
$api->answer['auth'] = ($data['login'] == 'admin' && $data['password'] == 'admin');
}
Ответ в json:
{"auth" : true}