Download the PHP package jenky/transmit without Composer

Transmit

This package allows you to quickly create Http client with pre-defined configurations.

Install

You may use Composer to install Transmit into your Laravel project:

After installing Transmit, publish its assets using the vendor:publish Artisan command.

or

Configuration

After publishing Transmit's assets, its primary configuration file will be located at config/transmit.php. This configuration file allows you to configure your guzzle client options and each configuration option includes a description of its purpose, so be sure to thoroughly explore this file.

Client configuration

A client is simply a HTTP client instance with its own configuration. This allows you to create a HTTP client on the fly and reuse anytime, anywhere you want.

Configure the options

Set guzzle request options within the channel. Please visit Request Options for more information.

Then uses it in your code:

Customizing the client Pending Request

To get started, define a tap array on the channel's configuration. The tap array should contain a list of classes that should have an opportunity to customize (or "tap" into) the pending request instance after it is created:

Once you have configured the tap option on your client, you're ready to define the class that will customize your client factory instance. This class only needs a single method: __invoke, which receives an Illuminate\Http\Client\PendingRequest instance.

All of your "tap" classes are resolved by the service container, so any constructor dependencies they require will automatically be injected.

"Tap" class parameters

"Tap" class can also receive additional parameters. For example, if your handler needs to log the Guzzle request and response by using a specific Laravel logger channel, you could create a UseLogger class that receives a channel name as an additional argument.

Additional parameters will be passed to the class after the $request argument:

"Tap" class parameters may be specified in transmit config by separating the class name and parameters with a :. Multiple parameters should be delimited by commas:

You can also use closure if you don't want to use class base method:

Caveats

Inspecting faking requests

All the assert* methods should be called from HTTP client instance instead of the Http facade if requests are made from specific client.

Change log

Please see CHANGELOG for more information on what has changed recently.

Testing

Contributing

Please see CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• Lynh
• All Contributors

License

The MIT License (MIT). Please see License File for more information.