romchik38/php-api

Framework-independent PHP library for standardized API responses

v1.0.0 2026-05-12 16:58 UTC

Requires

• php: >=8.1

Requires (Dev)

• laminas/laminas-coding-standard: *
• phpstan/phpstan: *
• phpunit/phpunit: ^13.1

MIT

• Romchik38

README

Framework-independent PHP library for standardized API responses.

Requirements

• PHP 8.1+

Installation

composer require romchik38/php-api

Usage

Error response

use Romchik38\Api\ErrorDto;

$dto = new ErrorDto('Resource not found');
echo json_encode($dto);
// {"status":"error","result":"Resource not found"}

Success response

use JsonSerializable;
use Romchik38\Api\SuccessDto;

class UserView implements JsonSerializable
{
    public function __construct(
        public readonly int $id,
        public readonly string $name,
    ) {}

    public function jsonSerialize(): mixed
    {
        return ['id' => $this->id, 'name' => $this->name];
    }
}

$dto = new SuccessDto(new UserView(1, 'Alice'));
echo json_encode($dto);
// {"status":"success","result":{"id":1,"name":"Alice"}}

Development

composer tests     # phpunit + phpstan + phpcs
composer cs-check  # coding standard check
composer cs-fix    # auto-fix coding standard