using-by-laravel.md

Using by Laravel

The package only support Laravel >= 5.5.

• 中文使用教程👉 https://laravel-china.org/topics/8816

Using

The package ServiceProvider default perend to app/Http/Kernel.php $middleware, If you want to customize the order of the middleware execution, please add it to the $middleware manually:

protected $middleware => [
    // ...
    Medz\Cors\Laravel\Middleware\Cors::class,
    // ...
];

Configure

You run Laravel Artisan command:

php artisan vendor:publish --provider="Medz\Cors\Laravel\Providers\LaravelServiceProvider" --force

publish cors.php file to config dir.

There are some configurations that you can write directly in the .env file:

Name	Desc
CORS_ALLOW_CREDENTIAILS	Access-Control-Allow-Credentials
CORS_ACCESS_CONTROL_MAX_AGE	Access-Control-Max-Age
CORS_LARAVEL_ALLOW_ROUTE_PREFIX	Prefix settings for allowing cross domains.
CORS_LARAVEL_ROUTE_GROUP_MODE	Whether routing group matching is enabled, if open, only the startup routing group allows setting cross domain information.

Route Group Mode

This package allows you to configure the cross-domain routed middleware groups individually. If this mode is enabled, only routes configured with the Medz\Cors\Laravel\Middleware\ShouldGroup middleware will allow you to add cross-domain settings.

To facilitate your memory, you can set the middleware alias directly in your app/Http/Kernel.php file:

protected $routeMiddleware = [
    // ...
    'cors-should' => \Medz\Cors\Laravel\Middleware\ShouldGroup::class,
];

You can set it directly to the routing middleware:

Route::middleware('cors-should') // Route::middleware(\Medz\Cors\Laravel\Middleware\ShouldGroup::class)
    ->get('/cors-test', ...);

You can also set it to the middleware group you allow, we use the api group as an example(app/Http/Kernel.php):

protected $middlewareGroups = [
    // ...
    'api' => [
        // ...
        \Medz\Cors\Laravel\Middleware\ShouldGroup::class, // If you have aliased the middleware, you can write the middleware alias directly.
        // ...
    ],
    // ...
];

Allow group functions and route prefix matching functions to be processed together.

Route Prefix

Routing prefixes, also known as route matching, allow you to configure routing rules. Only routes that meet the rules are allowed to cross domains.

You can modify the config.cors.php laravel.allow-route-prefix value to configure, or you can use CORS_LARAVEL_ALLOW_ROUTE_PERFIX to set rules in .env.

The default setting is *.