Download the PHP package wendelladriel/laravel-caller without Composer
On this page you can find all versions of the php package wendelladriel/laravel-caller. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wendelladriel/laravel-caller
More information about wendelladriel/laravel-caller
Files in wendelladriel/laravel-caller
Package laravel-caller
Short Description Create HTTP Clients for external services easily
License MIT
Informations about the package laravel-caller
Laravel Caller
Create HTTP Clients for external services easily
Installation
Publish the config file with:
Usage
This package provides a wrapper to the HTTP Client from Laravel to create clients for external services in an easy way.
First you need to configure one or more services in the config/caller.php
file, the default file has an example
of a default
service that you configure to use or create new ones based on that:
After you configure your service(s) you just need to create a Caller
class with the service name/key
in the config
file.
For example to create a client to a Twitter service you can use:
If you want to create a Caller
class for the default
service you don't need to pass any params:
Making Requests
With the Caller class you have access to the same methods of the HTTP client from Laravel:
head
, get
, post
, put
, patch
and delete
. All of them have the same signature. Check the
get method signature below as an example:
Updating the service
If you want to use the same Caller
object with different services before doing a new request you can call
the setService
method with the name/key
of the service you want:
Using different Auth credentials
By default, the Caller
object will use the auth type
and credentials
set in the config
file. If you need to use
different auth credentials per example based on the logged user, you can overwrite those with the methods:
setAuthUser
, setAuthPassword
, setAuthToken
Sending Attachments
If you need to send an attachment
on your request, before calling the request use the setAttachment
method. This will add
the attachment to your next request only. The setAttachment
method receives a CallerAttachment
object:
TO DO
- Create tests
Credits
- Wendell Adriel
- All Contributors
Contributing
All PRs are welcome.
For major changes, please open an issue first describing what you want to add/change.