Stars: 179
Forks: 12
Pull Requests: 50
Issues: 17
Watchers: 5
Last Updated: 2021-10-29 02:07:22
HTTP Request Migrations for API Versioning like Stripe
License: MIT License
Languages: PHP
This package is based on the API versioning scheme used at Stripe. Users pass a version header and you automatically migrate the request & response data to match the current version of your code.
You can install the package via composer:
composer require tomschlick/request-migrations
This package supports Laravel 5.5 autoloading so the service provider and facade will be loaded automatically.
If you are using an earlier version of Laravel or have autoloading disabled you need to add the service provider and facade to config/app.php
.
'providers' => [
\TomSchlick\RequestMigrations\RequestMigrationsServiceProvider.php,
]
'aliases' => [
'RequestMigrations' => \TomSchlick\RequestMigrations\Facades\RequestMigrations::class,
]
Add the middleware to your Http Kernel app/Http/Kernel.php
.
protected $middleware = [
\TomSchlick\RequestMigrations\RequestMigrationsMiddleware::class,
];
Run the following Artisan command to publish the package configuration to config/request-migrations.php
.
php artisan vendor:publish --provider="TomSchlick\RequestMigrations\RequestMigrationsServiceProvider"
You can generate a new request migration using the Artisan CLI.
php artisan make:request-migration ExampleMigration
The command will generate a request migration and publish it to App/Http/Migrations/*
.
It will generate a migration, you can modify it like this:
class GroupNameMigration extends RequestMigration
{
/**
* Migrate the request for the application to "read".
*
* @param \Illuminate\Http\Request $request
*
* @return \Illuminate\Http\Request
*/
public function migrateRequest(Request $request) : Request
{
return $request;
}
/**
* Migrate the response to display to the client.
*
* @param \Symfony\Component\HttpFoundation\Response $response
*
* @return \Symfony\Component\HttpFoundation\Response
*/
public function migrateResponse(Response $response) : Response
{
$content = json_decode($response->getContent(), true);
$content['firstname'] = array_get($content, 'name.firstname');
$content['lastname'] = array_get($content, 'name.lastname');
unset($content['name']);
return $response->setContent(json_encode($content));
}
/**
* Define which named paths should this migration modify.
*
* @return array
*/
public function paths() : array
{
return [
'users/show',
];
}
}
use TomSchlick\RequestMigrations\Facades\RequestMigrations;
// set both response & request versions
RequestMigrations::setVersion('2017-01-01')
// set the request version
RequestMigrations::setRequestVersion('2017-01-01')
// set the response version
RequestMigrations::setResponseVersion('2017-01-01')
This can be useful if you are pinning the version to a user.
RequestMigrations::setVersion(auth()->user()->api_version);
Please see CHANGELOG for more information what has changed recently.
composer test
Please see CONTRIBUTING for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.