Services

Available Services

Every class is namespaced under Derafu\Ubl\. See Formats for Serializer/Deserializer usage and Validation for SchemaValidator.

Exceptions

Every exception this package throws extends Derafu\Ubl\Exception\UblException, itself a Derafu\Translation\Exception\Core\TranslatableException:

Catching the base UblException catches any of them:

use Derafu\Ubl\Exception\UblException;

try {
    $document = (new Deserializer())->deserialize($content, 'yaml');
} catch (UblException $e) {
    // SerializationException, DeserializationException, ValidationException, ...
}

Dependency Injection

For an application using symfony/dependency-injection, resources/config/ubl-services.yaml wires every service above to its interface, ready to autowire:

imports:
    - { resource: '../vendor/derafu/ubl/resources/config/ubl-services.yaml' }

With that imported, a service can simply type-hint the interface it needs:

use Derafu\Ubl\Contract\SerializerInterface;

final class QuotationController
{
    public function __construct(
        private readonly SerializerInterface $serializer,
    ) {
    }
}