profesia/service-layer

Profesia service layer

v1.6.0 2025-12-16 08:50 UTC

Requires

• php: ^8.0
• guzzlehttp/guzzle: ^7.0
• nyholm/psr7: ^1.3
• psr/http-client: ^1.0
• psr/http-factory: ^1.0
• psr/http-message: ^2.0
• psr/log: ^2.0 || ^3.0
• psr/simple-cache: ^2.0 || ^3.0

Requires (Dev)

• mockery/mockery: ^1.2
• pestphp/pest: ^1.23
• phpstan/phpstan: ^1.8.0
• phpstan/phpstan-strict-rules: ^1.5.0
• squizlabs/php_codesniffer: ^3.5

MIT

• Matej Bádal

README

Library designed for SOA communication via REST with external services

Installation

Install the latest version by running the command

composer require profesia/service-layer

Requirements

• PHP 8.0+

Quick Start

For quick prototyping and testing of API endpoints, you can use the ServiceLayer facade class:

use Profesia\ServiceLayer\Facade\ServiceLayer;
use Profesia\ServiceLayer\ValueObject\HttpMethod;
use Profesia\ServiceLayer\Adapter\Config\AdapterConfig;
use Profesia\ServiceLayer\Adapter\GuzzleAdapter;
use Profesia\ServiceLayer\Transport\Gateway;
use Profesia\ServiceLayer\Transport\Logging\CommunicationLogger;
use Nyholm\Psr7\Factory\Psr17Factory;
use Nyholm\Psr7\Stream;
use Nyholm\Psr7\Uri;
use GuzzleHttp\Client;
use Psr\Log\NullLogger;

// Set up dependencies
$client = new Client();
$adapter = new GuzzleAdapter($client, AdapterConfig::createDefault());
$logger = new CommunicationLogger(new NullLogger());
$gateway = new Gateway($adapter, $logger);
$requestFactory = new Psr17Factory();

// Create a facade instance
$facade = new ServiceLayer($gateway, $requestFactory);

// Make a simple GET request
$uri = new Uri('https://api.example.com/users');
$response = $facade->sendRequest($uri, HttpMethod::createGet());

// Make a POST request with a body
$uri = new Uri('https://api.example.com/users');
$body = Stream::create(json_encode(['name' => 'John Doe']));
$response = $facade->sendRequest($uri, HttpMethod::createPost(), $body);

// Make a request with custom client options (timeout, SSL verification, etc.)
$clientOptions = ['timeout' => 10.0, 'verify' => false];
$response = $facade->sendRequest($uri, HttpMethod::createGet(), null, $clientOptions);

// Use builder pattern with custom response mapper
$response = $facade
    ->withMapperClosure(function ($endpointResponse) {
        // Custom response transformation logic
        return MyCustomResponse::fromEndpoint($endpointResponse);
    })
    ->sendRequest($uri, HttpMethod::createGet());

// Use builder pattern with client options (state is reset after each request)
$response = $facade
    ->withClientOptions(['timeout' => 10.0, 'verify' => false])
    ->executeRequest($uri, HttpMethod::createGet());

// Check the response
if ($response->isSuccessful()) {
    echo $response->getResponseBody();
}

See the examples directory for more usage examples.

Documentation

The documentation for the bundle can be found at https://profesia.github.io/service-layer

Author

Matej Bádal - [e-mail]

Alma Career Slovakia s r.o.

License

This project is licensed under the MIT License