brzuchal / rest-client
A new synchronous HTTP REST client offering a fluent API with the infrastructure of Symfony HttpClient
Installs: 334
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Type:symfony-bundle
Requires
- psr/log: ^1|^2|^3
- symfony/http-client: ^6.3
- symfony/property-access: ^6.3
- symfony/serializer: ^6.3
Requires (Dev)
- doctrine/coding-standard: ^12.0
- laminas/laminas-code: ^4
- laravel/framework: ^10
- orchestra/testbench: ^8
- phpstan/phpstan: ^1
- phpunit/phpunit: ^10
- symfony/framework-bundle: ^6.3
- symfony/mime: ^6.3
- symfony/validator: ^6.3
- vimeo/psalm: ^5
Suggests
- laminas/laminas-code: Enable client generation from interfaces
- symfony/mime: Enable support for serialization of various media types
Conflicts
- laminas/laminas-code: <4
- laravel/framework: <10
- symfony/framework-bundle: <6.3
- symfony/mime: <6.3
This package is auto-updated.
Last update: 2024-10-27 19:53:13 UTC
README
The RestClient package is a PHP library that simplifies working with RESTful APIs. It provides an easy way to create and configure HTTP requests, handle responses, and convert JSON data into PHP objects. This documentation will guide you through the main features and usage of the RestClient package.
Whether you're building web services or powerful API clients in your applications, the RestClient package streamlines the process of interacting with RESTful APIs in PHP. It allows you to focus on your application's functionality rather than the intricacies of making HTTP requests and processing responses.
Installation
You can install the RestClient package via Composer:
composer require brzuchal/rest-client
Documentation
- Basic usage
- Builder
- Entity Classes
- Custom Handling
- Integrating with Symfony
- Integrating with Laravel
- Service Factory (Experimental)
Getting Started
To get started with the RestClient package, create a RestClient
instance. You can use the RestClient::create
method to do this:
use Brzuchal\RestClient\RestClient; $client = RestClient::create('https://api.example.com/');
Now you have a RestClient
instance ready to make HTTP requests.
Making Requests
The RestClient package allows you to create various types of HTTP requests, such as GET, POST, PUT, DELETE, etc. You can use the RestClient instance to create request objects for these methods.
$response = $client->get('/todos/1') ->retrieve(); $data = $response->toArray(); $todo = $response->toEntity(Todo::class);
Error Handling
$response = $client->get('/todos/1') ->retrieve(); $response->onStatus(404, function ($response) { throw new NotFoundException('Resource not found'); }); $response->onStatus(500, function ($response) { throw new ServerErrorException('Server error'); });
Symfony Framework
Configuration
To use the RestClient package in a Symfony application, follow these steps:
-
Register the bundle in your Symfony application by adding the
RestClientBundle
to theconfig/bundles.php
file:// config/bundles.php return [ // ... Brzuchal\RestClient\RestClientBundle::class => ['all' => true], ];
-
By default, the RestClientBundle uses Symfony configuration to define REST client services. Create a configuration file (e.g.,
rest_client.yaml
) in theconfig/packages
directory of your Symfony project. Here's an example configuration:# config/packages/rest_client.yaml rest_client: clients: my_rest_client: base_uri: 'https://api.example.com/'
In this configuration, we define a
my_rest_client
service with a base URI ofhttps://api.example.com/
. You can add more client configurations as needed.
Example Symfony Controller
Here's an example Symfony controller that uses the RestClient package to make API requests:
use Brzuchal\RestClient\RestClient; use Symfony\Bundle\FrameworkBundle\Controller\AbstractController; use Symfony\Component\DependencyInjection\Attribute\Autowire; use Symfony\Component\HttpFoundation\JsonResponse; use Symfony\Contracts\HttpClient\HttpClientInterface; class TodoController extends AbstractController { public function index( #[Autowire(service: 'rest_client.default')] RestClientInterface $client, ): JsonResponse { return $this->json($client->get('/todos')->toArray()); } }
Laravel Framework
Configuration
To use the RestClient package in a Laravel application, follow these steps:
-
Create a configuration file for the RestClient package using the following Artisan command:
php artisan vendor:publish --tag=config
This command will generate a
rest_client.php
configuration file in theconfig
directory of your Laravel project.NOTE!: Laravel 8 and later versions should automatically discover the package. For older Laravel versions, you may need to register the service provider manually.
-
The configuration for the RestClient package in Laravel is similar to Symfony. Here's an example configuration file (
config/rest_client.php
):return [ 'clients' => [ 'my_rest_client' => [ 'base_uri' => 'https://api.example.com/', ], ], ];
In this configuration, we define a
my_rest_client
service with a base URI ofhttps://api.example.com/
. You can add more client configurations as needed.
Example Laravel Controller
Here's an example Laravel controller that uses the RestClient package to make API requests:
namespace App\Http\Controllers; use Brzuchal\RestClient\RestClient; use Illuminate\Http\JsonResponse; use Illuminate\Http\Request; use Illuminate\Support\Facades\Http; class TodoController extends Controller { public function index(Request $request): JsonResponse { return response()->json( app('rest_client.default')->get('/todos')->toArray(), ); } }
License
The RestClient package is open-source software licensed under the MIT License. See the LICENSE file for more information.