Nette Routing 使用指南

1. 项目介绍

Nette Routing 是一个用于 PHP 的路由库，它提供了一个简洁且强大的方法来处理 URL 的解析和生成。该库是 Nette 框架的一部分，但也可以独立使用。它支持双向路由，即能够将 URL 转换为参数数组，也能从参数数组构建 URL。Nette Routing 使得开发者能够轻松定义和管理应用程序的 URL 结构，同时保持 URL 的可读性和搜索引擎优化（SEO）友好性。

2. 项目快速启动

首先，确保您的环境安装了 PHP，版本至少为 8.1。

安装

可以通过 Composer 安装 Nette Routing：

composer require nette/routing

配置路由

创建一个路由列表实例，并添加您的路由规则：

use Nette\Routing\Route;
use Nette\Routing\RouteList;

$router = new RouteList();
$router->addRoute('products', ['controller' => 'Product', 'action' => 'default']);
$router->addRoute('product/<id \d+>', ['controller' => 'Product', 'action' => 'detail']);

在上面的代码中，我们定义了两个路由规则，一个用于显示产品列表，另一个用于显示特定产品的详情。

匹配 URL

使用路由器匹配当前 HTTP 请求的 URL：

$params = $router->match($httpRequest);
if ($params === null) {
    // 没有找到匹配的路由，返回 404 错误
    exit;
}

构建链接

使用路由器从参数数组构建 URL：

$params = ['controller' => 'Product', 'action' => 'detail', 'id' => 42];
$url = $router->constructUrl($params, $httpRequest->getUrl());

3. 应用案例和最佳实践

RESTful API

使用 Nette Routing 定义 RESTful API 的路由：

$router->addRoute('api/<resource>/<id \d+>', ['controller' => 'Api', 'action' => 'get']);
$router->addRoute('api/<resource>', ['controller' => 'Api', 'action' => 'index']);
$router->addRoute('api/<resource>', ['controller' => 'Api', 'action' => 'create'], Route::ONEWAY);

多语言支持

为多语言网站定义路由：

$router->addRoute('//<lang [a-z]{2}>.example.com/<controller>/<action>', ['controller' => 'Homepage', 'action' => 'default']);

4. 典型生态项目

Nette Routing 可以与 Nette 框架的其他组件配合使用，例如 Nette Application，以创建完整的 web 应用程序。以下是一些与 Nette Routing 相关的典型生态项目：

• Nette Framework：一个用于构建 web 应用程序的开源 PHP 框架。
• Nette AJAX：为 Nette Framework 提供 AJAX 支持的库。
• Nette Security：提供安全相关功能的库，例如密码加密和验证码。

通过使用这些组件，开发者可以构建出结构良好且安全的应用程序。