Laravel Skir Client

Laravel package for calling SkirRPC services through generated typed clients and Saloon.

Features

• Generate typed RPC clients from Skir schemas with the client generation guide.
• Use standard PHP objects, Laravel Data, or Simple Data Objects.
• Configure Laravel container resolution and matching wire codecs with the configuration and codecs guide.
• Handle failures and test without network requests.

Quick start

Install the client and standard PHP generator:

composer require php-skir/client
npm install --save-dev skir skir-php-generator

Create skir-src/admin/users.skir:

struct GetUserRequest {
user_id: int32;
}
struct User {
user_id: int32;
name: string;
}
method GetUser(GetUserRequest): User = 3180856469;

Configure the root skir.yml:

generators:
- mod: skir-php-generatoroutDir: skir/skiroutconfig:
namespace: Skir

Skir owns the output directory and may replace its contents during generation.

Generate the client, configure Composer autoloading, and publish the Laravel config:

npx skir gen
npx skir-php-generator configure-composer
composer dump-autoload
php artisan vendor:publish --tag=skir-client-config

Configure the server endpoint and matching wire codec:

SKIR_CLIENT_BASE_URL=https://api.example.testSKIR_CLIENT_ENDPOINT=/api/skirSKIR_CLIENT_CODEC=dense_json

Call the service through the generated typed client:

useSkir\Admin\GetUserRequest;
useSkir\Admin\SkirRpcClient;
useSkir\Client\SkirClientasTransportSkirClient;
$client = newSkirRpcClient(app(TransportSkirClient::class));
$user = $client->getUser(newGetUserRequest(userId: 42));
echo$user->name;

Generator alternatives

Standard PHP is the dependency-light baseline. Use skir-laravel-data-generator for Laravel Data or skir-simple-data-objects-generator for Simple Data Objects.

Documentation

• Generating clients
• Laravel Data
• Simple Data Objects
• Configuration and codecs
• Error handling and testing