composer create-project tnapf/api-skeleton
Just create a new file inside Bootstrap and then require it in Bootstrap/requires.php
First create a class that extends Tnapf\Router\Interfaces\ControllerInterface inside App\Controllers and add the #[Route] attribute to the class.
By default, each URI is prefixed with /api so the route below can be access by /api/ping. You can change this by setting the API_PREFIX constant in Bootstrap/environment.php.
<?php
namespace App\Controllers;
use Core\ApiResponse;
use Core\Routing\Route;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Tnapf\Router\Interfaces\ControllerInterface;
use Tnapf\Router\Routing\RouteRunner;
#[Route('/ping', ['GET'])]
class Ping implements ControllerInterface
{
public function handle(
ServerRequestInterface $request,
ResponseInterface $response,
RouteRunner $route
): ResponseInterface {
return ApiResponse::success();
}
}Note: You can set the priority of the route to determine the order in which routes are loaded. The default priority is 0.
First create a class that extends Tnapf\Router\Interfaces\ControllerInterface inside App\Catchers and add the #[Catcher] attribute to the class.
<?php
namespace App\Catchers;
use Core\ApiResponse;
use Core\Routing\Catcher;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Tnapf\Router\Exceptions\HttpNotFound;
use Tnapf\Router\Interfaces\ControllerInterface;
use Tnapf\Router\Routing\RouteRunner;
#[Catcher(HttpNotFound::class)]
class E404 implements ControllerInterface
{
public function handle(
ServerRequestInterface $request,
ResponseInterface $response,
RouteRunner $route
): ResponseInterface {
return ApiResponse::error('Endpoint Not Found', 404);
}
}Note: You can set the priority of the catcher to determine the order in which catchers are loaded. The default priority is 0.
There is a helper class named ApiResponse that can be used to create responses.
use Core\ApiResponse;ApiResponse;
ApiResponse::success(200);
/**
* {
* "success": true
* }
*/
ApiResponse::successWithData(['foo' => 'bar']);
/**
* {
* "success": true,
* "data": {
* "foo": "bar"
* }
* }
*/
ApiResponse::error('life is pain', 500);
/**
* {
* "success": false,
* "message": "life is pain",
* "code": 500
* }
*/
ApiResponse::errorWithData('life is pain', ['foo' => 'bar'], 500);
/**
* {
* "success": false,
* "message": "life is pain",
* "code": 500,
* "data": {
* "foo": "bar"
* }
* }
*/Create a class that extends Tests\ApiTestCase inside App\Tests. This should bootstrap the application into the testing environment, so you can test your endpoints. You'll also get some additional helper methods. See Tests\PingTest.php for an example.
composer tests or composer tests:coverage to generate a coverage report.