README

在 nikic/fast-route 的基础上构建的类型安全请求路由、参数检索和链接生成，支持 PSR-7。

组件

HTTP 异常

表示 HTTP 应用中常见情况的异常类

• InternalServerError
• MethodNotAllowed
• NotFoundException

BaseRouter

一个简单的类型化请求路由器，基于 nikic/fast-route 构建。示例

<?hh // strict
/** TResponder can be whatever you want; in this case, it's a
 * callable, but classname<MyWebControllerBase> is also a
 * common choice.
 */
type TResponder = (function(ImmMap<string, string>):string);

final class BaseRouterExample extends BaseRouter<TResponder> {
  protected function getRoutes(
  ): ImmMap<HttpMethod, ImmMap<string, TResponder>> {
    return ImmMap {
      HttpMethod::GET => ImmMap {
        '/' =>
          ($_params) ==> 'Hello, world',
        '/user/{user_name}' =>
          ($params) ==> 'Hello, '.$params['user_name'],
      },
      HttpMethod::POST => ImmMap {
        '/' => ($_params) ==> 'Hello, POST world',
      },
    };
  }
}

为简洁起见进行了简化 - 请参阅 examples/BaseRouterExample.php 以获取完整的可执行示例。

UriPatterns

以一致和类型安全的方式生成 FastRoute 片段、URI（用于链接）并检索 URI 参数

<?hh // strict
final class UserPageController extends WebController {
  public static function getUriPattern(): UriPattern {
    return (new UriPattern())
      ->literal('/users/')
      ->string('user_name');
  }
  // ...
}

可以检索参数，类型检查在运行时同时针对值和定义

public function getResponse(): string {
  return 'Hello, '.$this->getUriParameters()->getString('user_name');
}

您还可以生成指向控制器的链接

$link = UserPageController::getUriBuilder()
  ->setString('user_name', 'Mr Hankey')
  ->getPath();

为简洁起见，这些示例进行了简化 - 请参阅 examples/UriPatternsExample.php 以获取完整的可执行示例。

Codegen

项目 fredemmott/hack-router-codegen 建立在当前项目之上，用于自动生成

• 基于控制器中定义的 UriPatterns 的完整请求路由对象和 URI 映射
• 每个控制器的参数类，允许使用 $params->getFoo() 而不是 $params->getString('Foo')；这允许类型检查器捕获更多错误，并支持参数的 IDE 自动完成功能。
• 每个控制器的 UriBuilder 类，具有类似的好处