Sending Requests
After you have created your request, it is ready to be sent off to the internet! 🚀
There are three ways to send requests. You can use the request class directly, send requests through your connector, or you can register requests on your connector and use method-style access to send your requests.
Just instantiate your request class and use the
send() method.<?php
$request = new GetForgeServerRequest(serverId: '123456');
$response = $request->send();
This is useful if your connector has any constructor arguments. Just instantiate your connector class and use the
send() method.<?php
$connector = new ForgeConnector($apiToken);
$request = $connector->request(new GetForgeServerRequest(serverId: '123456'));
$response = $request->send();
// or...
$connector->send(new GetForgeServerRequest(serverId: '123456'));
If your connector has a constructor inside with specific data, you should consider sending requests through the connector rather than the request. Click here to read more.
Alternatively, you can overwrite the connector that a request uses, by using the setConnector() method on the request before calling the send() method.
<?php
$connector = new ForgeConnector($apiKey);
$request = new GetForgeServerRequest(serverId: '123456');
$request->setConnector($connector);
$request->send();
As mentioned previously, you can also use methods like
addHeader() and setConfig() right before you send the request. This is useful if you have conditional headers, config or form data you need to pass in at the last minute.<?php
use Sammyjo20\Saloon\Http\SaloonConnector;
use App\Http\Saloon\Requests\GetForgeServerRequest;
$request = new GetForgeServerRequest(serverId: '123456');
$request->setHeaders($array);
$request->addConfig('debug', true);
$request->addData('my-field', 'my-value');
$response = $request->send();
// Or if you are using the connector...
$connector = new ForgeConnector;
$request = $connector->request(new GetForgeServerRequest(serverId: '123456'));
$request->setHeaders($array);
$request->addConfig('debug', true);
$request->addData('my-field', 'my-value');
$response = $request->send();
// Or if you are using method-style access
$request = ForgeConnector::getForgeServerRequest(serverId: '123456');
$request->setHeaders($array);
$request->addConfig('debug', true);
$request->addData('my-field', 'my-value');
$response = $request->send();
The addData, setData and mergeData methods will not do anything unless you attach a form data trait.
Last modified 4mo ago