专注于处理 PHP 跨域的 CORS 中间件 1.4.0 版本更新,添加了 Swoft 框架支持
在很早之前个人发布了一个 PHP CORS 中间件!最初的初衷是开发一个替代 /-cors 包的工具,这个包的缺点在于维护不够,然后就是代码量庞大,支持性也不多。
当然也有优势,首先专注于 框架,然后 Satr 较多使用者较多。当然大多数用来放到 中够用。
优势
PHP CORS 代码量更少(核心代码仅四个文件,每个文件拆分很精短),在 中支持模式更多,首先就是常规的全站都附加跨域信息,然后是可选仅预检,路由模式和匹配模式。
有了这几个模式支持,你可以指定特定路由跨域,也可以分配给组路透跨域等。
除了上述对 支持外,还很好了支持以下方式:
● PHP 原生数组,可以使用数组来进行跨域响应头信息的接收,开发者可以自由处理。
● 支持 PSR-7 的请求和响应
● 支持 PSR-15 中间件
● 支持 /Lumen 框架
● 支持 Swoft 框架
● 支持 Slim 框架
● 支持 5 框架
缺点
支持了太多的框架,如果你仅在 使用,代码包中还包含了其他框架的支持代码,但是总量非常低,代码强迫症者可能受不了,多余的支持代码只有在对应框架中才会生效和被加载。
本次版本更新内容
随着 PSR-15 的稳定,针对 PSR-15 中间件接口进行了重构。可以更加方便的配置 CORS 信息
增加 Swoft 框架支持见?
本次更新内容的具体使用
PSR-15 中间件
先创建一个实例:
use MedzCorsPSRCorsMiddleware;// Settings.$settings = ['allow-credentials' => false,'allow-headers' => ['*'],'expose-headers' => [],'origins' => ['*'],'methods' => ['*'],'max-age' => 0,];// $cors = new MedzCorsCors($settings); // Create CORS instance.// Create CORS middleware instance$middleware = new CorsMiddleware($settings /* $cors */ /* , true */ /* 是否仅处理预检 */);// TODO.
可以看出,新版本可以直接从中间件构造参数进行传递设置了,之前版本必须传递一个 MedzCorsCors 实例,当然,新版本也可以直接传递实例。
第二个参数可以进行配置是否仅处理预检请求cors跨域,默认是处理全部请求。
Swoft 中间件
在配置文件 //app.php 中进行如下配置:
'components' => ['custom' => ['Medz\Cors\Swoft\',],],'cors' => ['onlyPreflight' => false, // 是否仅 OPTIONS 预检请求才进行跨域信息附加'settings' => [/// ... 参考 README 中的 PSR-7],],
全局使用
打开 app//beans/base.php 配置如下:
'serverDispatcher' => ['middlewares' => [MedzCorsSwoftCorsMiddleware::class,],],
通过注解使用
通过 @ 和 @, 可以很方便的配置中间件到当前的 和 内。
● 当将此注解应用于 上,则作用域为整个
● 将此注解应用于 上,则作用域仅为当前的
use SwoftHttpServerBeanAnnotationController;use SwoftHttpMessageBeanAnnotationMiddleware;use SwoftHttpServerBeanAnnotationRequestMapping;use MedzCorsSwoftCorsMiddleware;/*** Setting Controller middleware.** @Controller("middleware")* @Middleware(CorsMiddleware::class)*/class CorsOneController{//}/*** Setting Action middleware.*/class CorsTwoController{/*** @RequestMapping()* @Middleware(CorsMiddleware::class)*/public function corsAction(): array{return ['message' => 'The action using CORS.'];}}
其他
CORS 项目地址 ,如果喜欢cors跨域,欢迎 Star 欢迎 欢迎 PR。
Seven 的代码太渣,欢迎关注我的新拓展包 medz/cors 解决 PHP 项目程序设置跨域需求。