diegograssato/sf-api-problem

A Symfony compatible response for the IETF Problem Details for HTTP APIs RFC

Symfony API Problem

Introduction

This library supplies a Symfony 3 compatible Response class, that accepts an ApiProblem object and returns a JSON object compilant with the Problem Details for HTTP APIs specification., _(*1)

It is based on, and uses the ApiProblem class from, the ZF Campus zf-api-problem library for Zend Framework 2., _(*2)

Installation

Run the following command to install using composer:, _(*3)

$ composer require "diegograssato/sf-api-problem:~1.0"

Or add the following line to your composer.json:, _(*4)

"require": {
    "diegograssato/sf-api-problem": "~1.0"
}

Usage

use DTUX\ApiProblem\ApiProblem;
use DTUX\ApiProblem\ApiProblemResponse;

class FakeController
{

    public function fetch($id)
    {
        $entity = $this->service->fetch($id);

        if (!$entity) {
            return new ApiProblemResponse(new ApiProblem(404, 'Entity not found'));
        }

        return $entity;
    }
}

Configure listener, _(*5)

services:
    you_bundle.kernel.listener.api_exception:
        class: DTUX\ApiProblem\EventListener\ApiExceptionListener
        arguments:
          - '@logger'
        tags:
          - { name: kernel.event_listener, event: kernel.exception, method: onKernelException }

License

This project is released under the BSD 3-Clause license, and is based on parts of the ZF Campus zf-api-problem library for Zend Framework 2., _(*6)