README

这个库解决特定问题。不是 API 的通用解决方案。有辅助类、特性和过滤器。

使用 composer 安装

composer require hkulekci/expressive-api-component

将中间件添加到您的配置文件中

    'middleware_pipeline' => [
        'always' => [
            'middleware' => [
                .....
            ],
            'priority' => 10000,
        ],
        'routing' => [
            'middleware' => [
                Zend\Expressive\Router\Middleware\RouteMiddleware::class,
                Zend\Expressive\Helper\UrlHelperMiddleware::class,
                ....
                ApiComponent\Helper\ApiMiddleware::class,
                ApiComponent\RequestDataParser::class,
                ....
                Zend\Expressive\Router\Middleware\DispatchMiddleware::class,
                \Zend\Stratigility\Middleware\NotFoundHandler::class,
            ],
            'priority' => 1,
        ],
        'notFound' => [
            'middleware' => 'Application\NotFound',
            'priority'   => -1000,
        ]
    ],

然后使用 ApiComponent\AbstractResource 类扩展您的 API 端点资源，如下所示

<?php
/**
 * @author      Haydar KULEKCI <haydarkulekci@gmail.com>
 */
namespace CoreApi\Common;

use ApiComponent\AbstractResource;
use ApiComponent\Helper\ApiResponse;
use ApiComponent\Helper\ApiResponseInterface;

class PingAction extends AbstractResource
{
    /**
     * Ping Service
     *
     * @SWG\Get(
     *     path="/ping",
     *     tags={"common"},
     *     @SWG\Response(response="200", description="Ping Service"),
     *     @SWG\Response(response="500", description="Internal Server Error"),
     * )
     *
     * @param array $data
     *
     * @return ApiResponseInterface
     */
    protected function fetchAll(array $data = []): ApiResponseInterface
    {
        return new ApiResponse(['service' => $data['service']]);
    }
}

为了过滤您的输入，创建一个路由中间件并扩展 ApiComponent\AbstractInputFilter 类，如下所示

<?php
/**
 * @author      Haydar KULEKCI <haydarkulekci@gmail.com>
 */

namespace CoreApi\Common;

use ApiComponent\AbstractInputFilter;

class PingActionInputFilter extends AbstractInputFilter
{
    protected function inputFilterSpecsForFetchAllParameters(): array
    {
        return [
            $this->string('service', true, ['min' => 3, 'max' => 255]),
        ];
    }
}

现在，您的路由配置应该如下所示

    [
        'name'            => 'coreapi.common.ping',
        'path'            => '/ping',
        'middleware'      => [
            \CoreApi\Common\PingActionInputFilter::class,
            \CoreApi\Common\PingAction::class,
        ],
        'allowed_methods' => ['GET'],
    ],