mtownsend / request-xml
The missing XML support for Laravel's Request class.
Installs: 205 678
Dependents: 0
Suggesters: 0
Security: 0
Stars: 41
Watchers: 4
Forks: 12
Open Issues: 0
Requires
- php: ~7.0|~8.0
- illuminate/http: ~5.5.0|~5.6.0|~5.7.0|~5.8.0|~6.0|^7.0|^8.0|^9.0|^10.0|^11.0
- illuminate/support: ~5.5.0|~5.6.0|~5.7.0|~5.8.0|~6.0|^7.0|^8.0|^9.0|^10.0|^11.0
- mtownsend/xml-to-array: ^1.0|^2.0
Requires (Dev)
- phpunit/phpunit: ^6.4|^8.5|^9.0|^10.5
README
The missing XML support for Laravel's Request class.
This package is designed to work with the Laravel framework.
Installation
Install via composer:
composer require mtownsend/request-xml
Registering the service provider
For Laravel 5.4 and lower, add the following line to your config/app.php:
/* * Package Service Providers... */ Mtownsend\RequestXml\Providers\RequestXmlServiceProvider::class,
For Laravel 5.5 and greater, the package will auto register the provider for you.
Using Lumen
To register the service provider, add the following line to app/bootstrap/app.php:
$app->register(Mtownsend\RequestXml\Providers\RequestXmlServiceProvider::class);
Middleware
It's important to register the middleware so your application can convert an XML request and merge it into the Request object. You will then be able to run XML through Laravel's powerful validation system.
Please note:
Once you register the middleware, you do not need to do anything special to access your request xml. It will be available in the Request object like it would if it was a json or form request.
To setup the middleware, open up your app/Http/Kernel.php file.
To add the middleware globally:
protected $middleware = [ \Mtownsend\RequestXml\Middleware\XmlRequest::class, ];
To add the middleware to web routes only:
protected $middlewareGroups = [ 'web' => [ \Mtownsend\RequestXml\Middleware\XmlRequest::class, ], ];
To add the middleware to api routes only:
protected $middlewareGroups = [ 'api' => [ \Mtownsend\RequestXml\Middleware\XmlRequest::class, ], ];
Or, if you want named middleware for specific routes:
protected $routeMiddleware = [ 'xml' => \Mtownsend\RequestXml\Middleware\XmlRequest::class, ];
Quick start
Determine if the request wants an xml response
if (request()->wantsXml()) { // send xml response }
Determine if the request contains xml
if (request()->isXml()) { // do something }
Get the converted xml as an array
$data = request()->xml();
Methods
Request method
->wantsXml()
Works very similar to Laravel's ->wantsJson() method by returning a boolean. It will tell you if the incoming request would like to receive an XML response back.
Request method
->isXml()
Returns a boolean. This will tell you if the incoming request is XML.
Request method
->xml()
Returns an array. This converts the XML request into a PHP array. You are free to cast it to an object:
$xml = (object) request()->xml();
Or wrap it in a collection:
$xml = collect(request()->xml());
Exceptions
In the event invalid XML is received in a request, the application will throw an Exception containing the raw, invalid XML. If you would like to handle this exception whenever it occurs in your application, you can easily catch it and supply your own code in your applications app/Exceptions/Handler.php like so:
if ($exception instanceof \Mtownsend\RequestXml\Exceptions\CouldNotParseXml) { // do something }
Purpose
Have you ever wondered why Laravel offered useful methods for transforming data into JSON but completely forgot about XML? This package aims to add the missing XML functionality to Laravel's Request class. Your Laravel application may now detect and auto-merge incoming XML requests into the Request object. You can run an XML request through Laravel's built in validation system - it just works! XML's days of being a second class citizen in your Laravel app have come to an end.
Other packages you may be interested in
Credits
- Mark Townsend
- All Contributors
Testing
You can run the tests with:
./vendor/bin/phpunit
License
The MIT License (MIT). Please see License File for more information.