Package Data | |
---|---|
Maintainer Username: | barryvdh |
Package Create Date: | 2022-02-18 |
Package Last Update: | 2024-11-19 |
Home Page: | |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2025-01-18 03:17:52 |
Package Statistics | |
---|---|
Total Downloads: | 135,522,356 |
Monthly Downloads: | 5,368,517 |
Daily Downloads: | 262,146 |
Total Stars: | 251 |
Total Watchers: | 4 |
Total Forks: | 16 |
Total Open Issues: | 3 |
Library and middleware enabling cross-origin resource sharing for your http-{foundation,kernel} using application. It attempts to implement the W3C Recommendation for cross-origin resource sharing.
Note: This is a standalone fork of https://github.com/asm89/stack-cors and is compatible with the options for CorsService.
Require fruitcake/php-cors
using composer.
This package can be used as a library. You can use it in your framework using:
| Option | Description | Default value |
|------------------------|------------------------------------------------------------|---------------|
| allowedMethods | Matches the request method. | []
|
| allowedOrigins | Matches the request origin. | []
|
| allowedOriginsPatterns | Matches the request origin with preg_match
. | []
|
| allowedHeaders | Sets the Access-Control-Allow-Headers response header. | []
|
| exposedHeaders | Sets the Access-Control-Expose-Headers response header. | []
|
| maxAge | Sets the Access-Control-Max-Age response header. | 0
|
| supportsCredentials | Sets the Access-Control-Allow-Credentials header. | false
|
The allowedMethods and allowedHeaders options are case-insensitive.
You don't need to provide both allowedOrigins and allowedOriginsPatterns. If one of the strings passed matches, it is considered a valid origin. A wildcard in allowedOrigins will be converted to a pattern.
If ['*']
is provided to allowedMethods, allowedOrigins or allowedHeaders all methods / origins / headers are allowed.
Note: Allowing a single static origin will improve cacheability.
<?php
use Fruitcake\Cors\CorsService;
$cors = new CorsService([
'allowedHeaders' => ['x-allowed-header', 'x-other-allowed-header'],
'allowedMethods' => ['DELETE', 'GET', 'POST', 'PUT'],
'allowedOrigins' => ['http://localhost', 'https://*.example.com'],
'allowedOriginsPatterns' => ['/localhost:\d/'],
'exposedHeaders' => ['Content-Encoding'],
'maxAge' => 0,
'supportsCredentials' => false,
]);
$cors->addActualRequestHeaders(Response $response, $origin);
$cors->handlePreflightRequest(Request $request);
$cors->isActualRequestAllowed(Request $request);
$cors->isCorsRequest(Request $request);
$cors->isPreflightRequest(Request $request);
Released under the MIT License, see LICENSE.
This package is split-off from https://github.com/asm89/stack-cors and developed as stand-alone library since 2022