Commit version 24.12.13800

2025-01-06 17:35:06 -05:00
parent b7f6a79c2c
commit 55d9218816
6133 changed files with 4239740 additions and 1374287 deletions
--- a/libs/flight1/net/Router.php
+++ b/libs/flight1/net/Router.php
@ -0,0 +1,117 @@
+<?php
+/**
+ * Flight: An extensible micro-framework.
+ *
+ * @copyright   Copyright (c) 2011, Mike Cao <mike@mikecao.com>
+ * @license     MIT, http://flightphp.com/license
+ */
+
+namespace flight\net;
+
+/**
+ * The Router class is responsible for routing an HTTP request to
+ * an assigned callback function. The Router tries to match the
+ * requested URL against a series of URL patterns. 
+ */
+class Router {
+    /**
+     * Mapped routes.
+     *
+     * @var array
+     */
+    protected $routes = array();
+
+    /**
+     * Pointer to current route.
+     *
+     * @var int
+     */
+    protected $index = 0;
+
+    /**
+     * Case sensitive matching.
+     *
+     * @var boolean
+     */
+    public $case_sensitive = false;
+
+    /**
+     * Gets mapped routes.
+     *
+     * @return array Array of routes
+     */
+    public function getRoutes() {
+        return $this->routes;
+    }
+
+    /**
+     * Clears all routes in the router.
+     */
+    public function clear() {
+        $this->routes = array();
+    }
+
+    /**
+     * Maps a URL pattern to a callback function.
+     *
+     * @param string $pattern URL pattern to match
+     * @param callback $callback Callback function
+     * @param boolean $pass_route Pass the matching route object to the callback
+     */
+    public function map($pattern, $callback, $pass_route = false) {
+        $url = $pattern;
+        $methods = array('*');
+
+        if (strpos($pattern, ' ') !== false) {
+            list($method, $url) = explode(' ', trim($pattern), 2);
+            $url = trim($url);
+            $methods = explode('|', $method);
+        }
+
+        $this->routes[] = new Route($url, $callback, $methods, $pass_route);
+    }
+
+    /**
+     * Routes the current request.
+     *
+     * @param Request $request Request object
+     * @return Route|bool Matching route or false if no match
+     */
+    public function route(Request $request) {
+        $url_decoded = urldecode( $request->url );
+        while ($route = $this->current()) {
+            if ($route !== false && $route->matchMethod($request->method) && $route->matchUrl($url_decoded, $this->case_sensitive)) {
+                return $route;
+            }
+            $this->next();
+        }
+
+        return false;
+    }
+
+    /**
+     * Gets the current route.
+     *
+     * @return Route
+     */
+    public function current() {
+        return isset($this->routes[$this->index]) ? $this->routes[$this->index] : false;
+    }
+
+    /**
+     * Gets the next route.
+     *
+     * @return Route
+     */
+    public function next() {
+        $this->index++;
+    }
+
+    /**
+     * Reset to the first route.
+     */
+    public  function reset() {
+        $this->index = 0;
+    }
+}
+