CakePHP - 路由

在本章中，我们将学习与路由相关的以下主题 −

路由简介
连接路由
向路由传递参数
生成 URL
重定向 URL

路由简介

在本节中，我们将了解如何实现路由、如何将参数从 URL 传递到控制器的操作、如何生成 URL 以及如何重定向到特定 URL。通常，路由在文件 config/routes.php 中实现。路由可以通过两种方式实现 −

静态方法
作用域路由构建器

下面是一个展示这两种类型的示例。

// 使用作用域路由构建器。
Router::scope('/', function ($routes) {
   $routes->connect('/', ['controller' => 'Articles', 'action' => 'index']);
});
// 使用静态方法。
Router::connect('/', ['controller' => 'Articles', 'action' => 'index']);

这两种方法都会执行 ArticlesController 的 index 方法。在这两种方法中，scoped route builder 的性能更好。

连接路由

Router::connect() 方法用于连接路由。以下是方法的语法 −

static Cake\Routing\Router::connect($route, $defaults =[], $options =[])

Router::connect() 方法 − 有三个参数

第一个参数用于您希望匹配的 URL 模板。
第二个参数包含路由元素的默认值。
第三个参数包含路由的选项，通常包含正则表达式规则。

以下是路由的基本格式 −

$routes->connect(
   'URL template',
   ['default' => 'defaultValue'],
   ['option' => 'matchingRegex']
);

示例

在 config/routes.php 文件中进行如下更改。

config/routes.php

<?php
use Cake\Http\Middleware\CsrfProtectionMiddleware;
use Cake\Routing\Route\DashedRoute;
use Cake\Routing\RouteBuilder;
$routes->setRouteClass(DashedRoute::class);
$routes->scope('/', function (RouteBuilder $builder) {
   // Register scoped middleware for in scopes.
      $builder->registerMiddleware('csrf', new CsrfProtectionMiddleware([
      'httpOnly' => true,
   ]));
   $builder->applyMiddleware('csrf');
   $builder->connect('/', ['controller' => 'Tests', 'action' => 'show']);
   $builder->connect('/pages/*', ['controller' => 'Pages', 'action' => 'display']);
   $builder->fallbacks();
});

在 src/Controller/TestsController.php 处创建一个 TestsController.php 文件。将以下代码复制到控制器文件中。

src/Controller/TestsController.php

<?php
declare(strict_types=1);
namespace App\Controller;
use Cake\Core\Configure;
use Cake\Http\Exception\ForbiddenException;
use Cake\Http\Exception\NotFoundException;
use Cake\Http\Response;
use Cake\View\Exception\MissingTemplateException;
class TestsController extends AppController {
   public function show()
   {
   }
}

在 src/Template 下创建一个文件夹 Tests，并在该文件夹下创建一个名为 show.php 的 View 文件。将以下代码复制到该文件中。

src/Template/Tests/show.php

<h1>这是 CakePHP 教程，也是连接路由的示例。</h1>

通过访问以下 URL(网址为 http://localhost/cakephp4/)执行上述示例

输出

上述 URL 将产生以下输出。

传递的参数

传递的参数是在 URL 中传递的参数。这些参数可以传递给控制器的操作。这些传递的参数以三种方式提供给您的控制器。

作为操作方法的参数

以下示例显示了如何将参数传递给控制器的操作。访问以下 URL:http://localhost/cakephp4/tests/value1/value2

这将匹配以下路由行。

$builder->connect('tests/:arg1/:arg2', ['controller' => 'Tests', 'action' => 'show'],['pass' => ['arg1', 'arg2']]);

这里，URL 中的 value1 将被赋值给 arg1，value2 将被赋值给 arg2。

作为数字索引数组

将参数传递给控制器的操作后，您可以使用以下语句获取参数。

$args = $this->request->params['pass']

传递给控制器操作的参数将存储在 $args 变量中。

使用路由数组

也可以通过以下语句将参数传递给操作 −

$routes->connect('/', ['controller' => 'Tests', 'action' => 'show',5,6]);

上述语句将向 TestController 的 show() 方法传递两个参数 5 和 6。

示例

在 config/routes.php 文件中进行更改，如以下程序所示。

config/routes.php

<?php
use Cake\Http\Middleware\CsrfProtectionMiddleware;
use Cake\Routing\Route\DashedRoute;
use Cake\Routing\RouteBuilder;
$routes->setRouteClass(DashedRoute::class);
$routes->scope('/', function (RouteBuilder $builder) {
// 为范围内注册范围中间件。
$builder->registerMiddleware('csrf', new CsrfProtectionMiddleware([
      'httpOnly' => true,
   ]));
   $builder->applyMiddleware('csrf');
   $builder->connect('tests/:arg1/:arg2', ['controller' => 'Tests', 'action' => 'show'],['pass' => ['arg1', 'arg2']]);
   $builder->connect('/pages/*', ['controller' => 'Pages', 'action' => 'display']);
   $builder->fallbacks();
});

在 src/Controller/TestsController.php 处创建一个 TestsController.php 文件。将以下代码复制到控制器文件中。

src/Controller/TestsController.php

<?php
declare(strict_types=1);
namespace App\Controller;
use Cake\Core\Configure;
use Cake\Http\Exception\ForbiddenException;
use Cake\Http\Exception\NotFoundException;
use Cake\Http\Response;
use Cake\View\Exception\MissingTemplateException;
class TestsController extends AppController {
public function show($arg1, $arg2) {
      $this->set('argument1',$arg1);
      $this->set('argument2',$arg2);
   }
}

在 src/Template 处创建一个文件夹 Tests，并在该文件夹下创建一个名为 show.php 的 View 文件。将以下代码复制到该文件中。

src/Template/Tests/show.php.

<h1>This is CakePHP tutorial and this is an example of Passed arguments.</h1>
<?php
   echo "Argument-1:".$argument1."<br/>";
   echo "Argument-2:".$argument2."<br/>";
?>

通过访问以下 URL http://localhost/cakephp4/tests/Virat/Kunal 执行上述示例

输出

执行后，上述 URL 将产生以下输出。

生成 URL

这是 CakePHP 的一个很酷的功能。使用生成的 URL，我们可以轻松更改应用程序中 URL 的结构，而无需修改整个代码。

url( string|array|null $url null , boolean $full false )

上述函数将接受两个参数 −

第一个参数是一个数组，指定以下任意一项 - 'controller'、'action'、'plugin'。此外，您还可以提供路由元素或查询字符串参数。如果是字符串，则可以为其指定任何有效 url 字符串的名称。
如果为 true，则完整的基本 URL 将添加到结果前面。默认值为 false。

示例

按照以下程序所示，在 config/routes.php 文件中进行更改。

config/routes.php

<?php
use Cake\Http\Middleware\CsrfProtectionMiddleware;
use Cake\Routing\Route\DashedRoute;
use Cake\Routing\RouteBuilder;
$routes->setRouteClass(DashedRoute::class);
$routes->scope('/', function (RouteBuilder $builder) {
   // 在范围内注册范围中间件。
   $builder->registerMiddleware('csrf', new CsrfProtectionMiddleware([
      'httpOnly' => true,
   ]));
   $builder->applyMiddleware('csrf');
   $builder->connect('/generate',['controller'=>'Generates','action'=>'show']);
   $builder->fallbacks();
});

在 src/Controller/GeneratesController.php 处创建一个 GeneratesController.php 文件。将以下代码复制到控制器文件中。

src/Controller/GeneratesController.php

<?php
declare(strict_types=1);
namespace App\Controller;
21
use Cake\Core\Configure;
use Cake\Http\Exception\ForbiddenException;
use Cake\Http\Exception\NotFoundException;
use Cake\Http\Response;
use Cake\View\Exception\MissingTemplateException;
class GeneratesController extends AppController {
   public function show()
   {
   }
}

在 src/Template 创建一个文件夹 Generates，并在该文件夹下创建一个名为 show.php 的 View 文件。将以下代码复制到该文件中。

src/Template/Generates/show.php

<h1>This is CakePHP tutorial and this is an example of Generating URLs<h1>

通过访问以下 URL 执行上述示例 −

http://localhost/cakephp4/generate

输出

上述 URL 将产生以下输出 −

重定向路由

当我们想要通知客户端应用程序此 URL 已被移动时，重定向路由很有用。可以使用以下函数重定向 URL −

static Cake\Routing\Router::redirect($route, $url, $options =[])

上述函数有三个参数，如下所示 −

描述路由模板的字符串。
要重定向到的 URL。
将路由中的命名元素与该元素应匹配的正则表达式匹配的数组。

示例

在 config/routes.php 文件中进行更改，如下所示。在这里，我们使用了之前创建的控制器。

config/routes.php

<?php
use Cake\Http\Middleware\CsrfProtectionMiddleware;
use Cake\Routing\Route\DashedRoute;
use Cake\Routing\RouteBuilder;
$routes->setRouteClass(DashedRoute::class);
$routes->scope('/', function (RouteBuilder $builder) {
   // 在范围内注册范围中间件。
   $builder->registerMiddleware('csrf', new CsrfProtectionMiddleware([
      'httpOnly' => true,
   ]));
   $builder->applyMiddleware('csrf');
   $builder->connect('/generate',['controller'=>'Generates','action'=>'show']);
   $builder->redirect('/redirect','https://tutorialspoint.com/');
   $builder->fallbacks();
});

通过访问以下 URL 执行上述示例。

URL 1 − http://localhost/cakephp4/generate

URL 1 的输出

URL 2 − http://localhost/cakephp4/redirect

URL 2 的输出

您将被重定向到 https://tutorialspoint.com

CakePHP 教程

CakePHP 有用资源

CakePHP - 路由

路由简介

连接路由

示例

输出

传递的参数

作为操作方法的参数

作为数字索引数组

使用路由数组

示例

输出

生成 URL

示例

输出

重定向路由

示例

URL 1 的输出

URL 2 的输出

颜色选择器

读后有收获微信请站长喝咖啡

错误报告

您的建议:

感谢您的帮助！