如何使用 Cakephp 4 访问 REST 控制器

Question

我正在尝试设置一个简单的 REST GET API，该 API 将使用 CakePHP4 提供我的“层次结构”表中的所有数据，遵循 https://book.cakephp.org/4/en/development/rest.html

这是我的 /config/routes.php 文件

$routes->setRouteClass(DashedRoute::class);
$routes->scope('/', function (RouteBuilder $builder) {
    $builder->connect('/', ['controller' => 'Accueil', 'action' => 'index', 'index']);
    $builder->connect('/pages/*', 'Pages::display');
    $builder->fallbacks();
});
$routes->scope('/api', function (RouteBuilder $routes) {
    $routes->setExtensions(['xml', 'json']);
    $routes->resources('Hierarchies');
});

这是我的 Controller/HierarchiesController.php

class HierarchiesController extends AppController
{
    public function initialize(): void
    {
        parent::initialize();
        $this->loadComponent('RequestHandler');
    }

    public function index(){
        $recipes = $this->Hierarchies->find('all');
        $this->set([
            'recipes' => $recipes,
            '_serialize' => ['recipes']
        ]);
    }
}

1. routes.php 上的顺序是否有意义？没事吧？
2. Template/Hierarchies/index.php 中是否需要某些内容？
3. 测试端点的 url 是什么？

谢谢

Answer 1

在路由/config/routes.php中使用

$routes->scope('/api', function (RouteBuilder $routes) {
  $routes->setExtensions(['xml', 'json']);
  $builder->connect('/hierarchies/index', ['controller' => 'Hierarchies','action' => 'index']);
});

在控制器 Controller/HierarchiesController.php 中添加以下代码：-

use Cake\Event\EventInterface;

public function beforeFilter(EventInterface $event)
    {
        parent::beforeFilter($event);
        $this->Security->setConfig('unlockedActions', ['index']);
    }

在 src/Application.php 中替换中间件函数。

public function middleware(MiddlewareQueue $middlewareQueue): MiddlewareQueue
    { 
        $csrf = new CsrfProtectionMiddleware([
                'httponly' => true,
            ]);
        $csrf->whitelistCallback(function (ServerRequest $request) { 
            // skip controllers 
            $skipedControllers = ['Hierarchies']; // EDIT THIS
            if(in_array($request->getParam('controller'),$skipedControllers)) {
                return true;
            }
            return $request;
        });

        $middlewareQueue
            // Catch any exceptions in the lower layers,
            // and make an error page/response
            ->add(new ErrorHandlerMiddleware(Configure::read('Error')))

            // Handle plugin/theme assets like CakePHP normally does.
            ->add(new AssetMiddleware([
                'cacheTime' => Configure::read('Asset.cacheTime'),
            ]))

            // Add routing middleware.
            // If you have a large number of routes connected, turning on routes
            // caching in production could improve performance. For that when
            // creating the middleware instance specify the cache config name by
            // using it's second constructor argument:
            // `new RoutingMiddleware($this, '_cake_routes_')`
            ->add(new RoutingMiddleware($this))

            // Parse various types of encoded request bodies so that they are
            // available as array through $request->getData()
            // https://book.cakephp.org/4/en/controllers/middleware.html#body-parser-middleware
            ->add(new BodyParserMiddleware())
            
            // Cross Site Request Forgery (CSRF) Protection Middleware
            // https://book.cakephp.org/4/en/controllers/middleware.html#cross-site-request-forgery-csrf-middleware
            /*->add(new CsrfProtectionMiddleware([
                'httponly' => true,
            ]));*/
            ->add($csrf);

        return $middlewareQueue;
    }

你的网址：-{Server url}/{Project Name}/hierarchies/index.json