XML Body
To get started, make change your method to POST, PUT or PATCH depending on the requirements of the API. After that, you will need to add the HasBody
interface to your request. This interface is required as it tells Saloon to look for a body()
method supplied by one of the body traits. Without this interface, Saloon will not send any request body to the HTTP client.
Next, you will need to add the HasXmlBody
trait to your request. This trait will implement the body()
method that the HasBody
interface requires. It also provides a method defaultBody()
which you can extend to provide a default body on your request.
Default Body
There are a couple of ways to interact with the request body to prepare it to be sent. You can either use the methods mentioned below to add to the body on any given instance or you can use the defaultBody
method on your request. This is recommended because you could then define any requirements as constructor arguments in your request and then standardise your request even more.
Interacting with the body() method
While you can define the default body on your request, it might be useful to add or modify the body at runtime on a per-request basis. Saloon has the following methods to allow you to modify the XML request body:
set(string $value) -> Overwrite the XML body entirely
all(): array -> Get the XML body
isEmpty(): bool -> Check if the body is empty
isNotEmpty(): bool -> Check if the body is not empty
Using Spatie's Array To XML Package
Writing out XML body can be laborious and time-consuming. In some previous integrations, we have leaned on a library to help write out the XML request bodies. This library is Spatie's "Array to XML" package. You can use this to provide a simple array of keys and values to build up XML data and then pass it through to Saloon.
Connector Body
You can add the same interface and trait to your connector. If you have the trait on both the connector and the request, the body on the request will take priority. If you have the body on just the connector but not on the request, the request will inherit the body on the connector.
Last updated