开源项目 `stack-cors` 使用教程

44 0 0

开源项目 `stack-cors` 使用教程

stack-corsCross-origin resource sharing library and stack middleware.项目地址:https://gitcode.com/gh_mirrors/st/stack-cors

1. 项目的目录结构及介绍

stack-cors 是一个用于处理跨域资源共享（CORS）的库和堆栈中间件。以下是该项目的目录结构及其介绍：

stack-cors/ ├── src/ │ ├── Cors.php │ ├── CorsService.php │ └── ... ├── tests/ │ ├── CorsTest.php │ ├── CorsServiceTest.php │ └── ... ├── README.md ├── LICENSE └── composer.json

src/：包含项目的主要源代码文件，如 Cors.php 和 CorsService.php。
tests/：包含项目的测试文件，用于确保代码的正确性。
README.md：项目的说明文档，包含使用方法和配置信息。
LICENSE：项目的许可证文件，本项目使用 MIT 许可证。
composer.json：Composer 的配置文件，用于管理项目的依赖。

2. 项目的启动文件介绍

stack-cors 项目的启动文件主要是 Cors.php 和 CorsService.php。以下是这两个文件的简要介绍：

Cors.php：定义了 Cors 类，用于配置和处理 CORS 请求。
CorsService.php：定义了 CorsService 类，提供了处理 CORS 请求的方法，如 addActualRequestHeaders、handlePreflightRequest 等。

3. 项目的配置文件介绍

stack-cors 项目的配置文件主要是 composer.json 和 README.md。以下是这两个文件的简要介绍：

composer.json：包含了项目的依赖信息、脚本和配置。示例如下：


{
    "name": "asm89/stack-cors",
    "description": "Cross-origin resource sharing library and stack middleware",
    "license": "MIT",
    "require": {
        "php": ">=5.6"
    },
    "autoload": {
        "psr-4": {
            "Asm89\Stack\": "src/"
        }
    }
}

README.md：包含了项目的详细使用说明和配置示例。示例如下：

# stack-cors Cross-origin resource sharing library and stack middleware. ## Installation ```bash composer require asm89/stack-cors

Usage


use Asm89StackCorsService;
 
$cors = new CorsService([
    'allowedHeaders' => ['x-allowed-header', 'x-other-allowed-header'],
    'allowedMethods' => ['DELETE', 'GET', 'POST', 'PUT'],
    'allowedOrigins' => ['http://localhost'],
    'allowedOriginsPatterns' => ['/localhost:d/'],
    'exposedHeaders' => false,
    'maxAge' => 600,
    'supportsCredentials' => true
]);
 
$cors->addActualRequestHeaders(Response $response, $origin);
$cors->handlePreflightRequest(Request $request);
$cors->isActualRequestAllowed(Request $request);
$cors->isCorsRequest(Request $request);
$cors->isPreflightRequest(Request $request);