first commit

var/Typecho/Router.php

@@ -0,0 +1,191 @@
+<?php
+
+namespace Typecho;
+
+use Typecho\Router\ParamsDelegateInterface;
+use Typecho\Router\Parser;
+use Typecho\Router\Exception as RouterException;
+
+/**
+ * Typecho组件基类
+ *
+ * @package Router
+ */
+class Router
+{
+    /**
+     * 当前路由名称
+     *
+     * @var string
+     */
+    public static string $current;
+
+    /**
+     * 已经解析完毕的路由表配置
+     *
+     * @var array
+     */
+    private static array $routingTable = [];
+
+    /**
+     * 是否已经匹配过，防止递归匹配
+     *
+     * @var bool
+     */
+    private static bool $matched = false;
+
+    /**
+     * 解析路径
+     *
+     * @param string $pathInfo 全路径
+     * @param mixed $parameter 输入参数
+     * @param bool $once 是否只匹配一次
+     * @return false|Widget
+     * @throws \Exception
+     */
+    public static function match(string $pathInfo, $parameter = null, bool $once = true)
+    {
+        if ($once && self::$matched) {
+            throw new RouterException("Path '{$pathInfo}' not found", 404);
+        }
+
+        self::$matched = true;
+
+        foreach (self::route($pathInfo) as $result) {
+            [$route, $params] = $result;
+            try {
+                return Widget::widget($route['widget'], $parameter, $params);
+            } catch (\Exception $e) {
+                if (404 == $e->getCode()) {
+                    Widget::destroy($route['widget']);
+                    continue;
+                }
+
+                throw $e;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * 路由分发函数
+     *
+     * @throws RouterException|\Exception
+     */
+    public static function dispatch()
+    {
+        /** 获取PATHINFO */
+        $pathInfo = Request::getInstance()->getPathInfo();
+
+        foreach (self::route($pathInfo) as $result) {
+            [$route, $params] = $result;
+
+            try {
+                $widget = Widget::widget($route['widget'], null, $params);
+
+                if (isset($route['action'])) {
+                    $widget->{$route['action']}();
+                }
+
+                return;
+            } catch (\Exception $e) {
+                if (404 == $e->getCode()) {
+                    Widget::destroy($route['widget']);
+                    continue;
+                }
+
+                throw $e;
+            }
+        }
+
+        /** 载入路由异常支持 */
+        throw new RouterException("Path '{$pathInfo}' not found", 404);
+    }
+
+    /**
+     * 路由反解析函数
+     *
+     * @param string $name 路由配置表名称
+     * @param mixed $value 路由填充值
+     * @param string|null $prefix 最终合成路径的前缀
+     * @return string
+     */
+    public static function url(
+        string $name,
+        $value = null,
+        ?string $prefix = null
+    ): string {
+        if (!isset(self::$routingTable[$name])) {
+            return '#';
+        }
+
+        $route = self::$routingTable[$name];
+
+        //交换数组键值
+        $pattern = [];
+        foreach ($route['params'] as $param) {
+            if (is_array($value) && isset($value[$param])) {
+                $pattern[$param] = $value[$param];
+            } elseif ($value instanceof ParamsDelegateInterface) {
+                $pattern[$param] = $value->getRouterParam($param);
+            } else {
+                $pattern[$param] = '{' . $param . '}';
+            }
+        }
+
+        return Common::url(vsprintf($route['format'], $pattern), $prefix);
+    }
+
+    /**
+     * 设置路由器默认配置
+     *
+     * @param mixed $routes 配置信息
+     * @return void
+     */
+    public static function setRoutes($routes)
+    {
+        if (isset($routes[0])) {
+            self::$routingTable = $routes[0];
+        } else {
+            /** 解析路由配置 */
+            $parser = new Parser($routes);
+            self::$routingTable = $parser->parse();
+        }
+    }
+
+    /**
+     * 获取路由信息
+     *
+     * @param string $routeName 路由名称
+     * @return mixed
+     */
+    public static function get(string $routeName)
+    {
+        return self::$routingTable[$routeName] ?? null;
+    }
+
+    /**
+     * @param string $pathInfo
+     * @return \Generator
+     * @throws \Exception
+     */
+    private static function route(string $pathInfo): \Generator
+    {
+        foreach (self::$routingTable as $key => $route) {
+            if (preg_match($route['regx'], $pathInfo, $matches)) {
+                self::$current = $key;
+
+                /** 载入参数 */
+                $params = null;
+
+                if (!empty($route['params'])) {
+                    unset($matches[0]);
+                    $params = array_combine($route['params'], $matches);
+                }
+
+                yield [$route, $params];
+            }
+        }
+    }
+}