前言

laravel 为我们提供便携的重定向功能，可以由门面 Redirect，或者全局函数 redirect() 来启用，本篇文章将会介绍重定向功能的具体细节及源码分析。

URI 重定向

重定向功能是由类 UrlGenerator 所实现，这个类需要 request 来进行初始化：

  1.  $url = new UrlGenerator(
  2.     $routes = new RouteCollection,
  3.     $request = Request::create('http://www.foo.com/')
  4. );

重定向到 uri

  • 当我们想要重定向到某个地址时，可以使用 to 函数：
  1. $this->assertEquals('http://www.foo.com/foo/bar', $url->to('foo/bar'));
  • 当我们想要添加额外的路径，可以将数组赋给第二个参数：
  1. $this->assertEquals('https://www.foo.com/foo/bar/baz/boom', $url->to('foo/bar', ['baz', 'boom'], true));
  2. $this->assertEquals('https://www.foo.com/foo/bar/baz?foo=bar', $url->to('foo/bar?foo=bar', ['baz'], true));

强制 https

如果我们想要重定向到 https ，我们可以设置第三个参数为 true :

  1. $this->assertEquals('https://www.foo.com/foo/bar', $url->to('foo/bar', [], true));

或者使用 forceScheme 函数：

  1. $url->forceScheme('https');
  3. $this->assertEquals('https://www.foo.com/foo/bar', $url->to('foo/bar');

强制域名

  1. $url->forceRootUrl('https://www.bar.com');
  3. $this->assertEquals('https://www.bar.com/foo/bar', $url->to('foo/bar');

路径自定义

  1. $url->formatPathUsing(function ($path) {
  2.     return '/something'.$path;
  3. });
  5. $this->assertEquals('http://www.foo.com/something/foo/bar', $url->to('foo/bar'));

路由重定向

重定向另一个非常重要的功能是重定向到路由所在的地址中去：

  1. $route = new Route(['GET'], '/named-route', ['as' => 'plain']);
  2. $routes->add($route);
  4. $this->assertEquals('http:/www.bar.com/named-route', $url->route('plain'));

非域名路径

laravel 路由重定向可以选择重定向后的地址是否仍然带有域名，这个特性由第三个参数决定：

  1. $route = new Route(['GET'], '/named-route', ['as' => 'plain']);
  2. $routes->add($route);
  4. $this->assertEquals('/named-route', $url->route('plain', [], false));

重定向端口号

路由重定向可以允许带有 request 自己的端口：

  1. $url = new UrlGenerator(
  2.     $routes = new RouteCollection,
  3.     $request = Request::create('http://www.foo.com:8080/')
  4. );
  6. $route = new Route(['GET'], 'foo/bar/{baz}', ['as' => 'bar', 'domain' => 'sub.{foo}.com']);
  7. $routes->add($route);
  9. $this->assertEquals('http://sub.taylor.com:8080/foo/bar/otwell', $url->route('bar', ['taylor', 'otwell']));

重定向路径参数绑定

如果路由中含有参数，可以将需要的参数赋给 route 第二个参数：

  1. $route = new Route(['GET'], 'foo/bar/{baz}', ['as' => 'foobar']);
  2. $routes->add($route);
  4. $this->assertEquals('http://www.foo.com/foo/bar/taylor', $url->route('foobar', 'taylor'));

也可以根据参数的命名来指定参数绑定：

  1. $route = new Route(['GET'], 'foo/bar/{baz}/breeze/{boom}', ['as' => 'bar']);
  2. $routes->add($route);
  4. $this->assertEquals('http://www.foo.com/foo/bar/otwell/breeze/taylor', $url->route('bar', ['boom' => 'taylor', 'baz' => 'otwell']));

还可以利用 defaults 函数为重定向提供默认的参数来绑定：

  1. $url->defaults(['locale' => 'en']);
  2. $route = new Route(['GET'], 'foo', ['as' => 'defaults', 'domain' => '{locale}.example.com', function () {
  3. }]);
  4. $routes->add($route);
  6. $this->assertEquals('http://en.example.com/foo', $url->route('defaults'));

重定向路由 querystring 添加

当在 route 函数中赋给的参数多于路径参数的时候，多余的参数会被添加到 querystring 中：

  1. $route = new Route(['GET'], 'foo/bar/{baz}/breeze/{boom}', ['as' => 'bar']);
  2. $routes->add($route);
  4. $this->assertEquals('http://www.foo.com/foo/bar/taylor/breeze/otwell?fly=wall', $url->route('bar', ['taylor', 'otwell', 'fly' => 'wall']));

fragment 重定向

  1. $route = new Route(['GET'], 'foo/bar#derp', ['as' => 'fragment']);
  2. $routes->add($route);
  4. $this->assertEquals('/foo/bar?baz=%C3%A5%CE%B1%D1%84#derp', $url->route('fragment', ['baz' => 'åαф'], false));

路由 action 重定向

我们不仅可以通过路由的别名来重定向，还可以利用路由的控制器方法来重定向：

  1. $route = new Route(['GET'], 'foo/bam', ['controller' => 'foo@bar']);
  2. $routes->add($route);
  4. $this->assertEquals('http://www.foo.com/foo/bam', $url->action('foo@bar'));

可以设定重定向控制器的默认命名空间：

  1. $url->setRootControllerNamespace('namespace');
  3. $route = new Route(['GET'], 'foo/bar', ['controller' => 'namespace\foo@bar']);
  4.         $routes->add($route);
  6. $route = new Route(['GET'], 'something/else', ['controller' => 'something\foo@bar']);
  7. $routes->add($route);
  9. $this->assertEquals('http://www.foo.com/foo/bar', $url->action('foo@bar'));
  10. $this->assertEquals('http://www.foo.com/something/else', $url->action('\something\foo@bar'));

UrlRoutable 参数绑定

可以为重定向传入 UrlRoutable 类型的参数，重定向会通过类方法 getRouteKey 来获取对象的某个属性，进而绑定到路由的参数中去。

  1. public function testRoutableInterfaceRoutingWithSingleParameter()
  2. {
  3.     $url = new UrlGenerator(
  4.         $routes = new RouteCollection,
  5.         $request = Request::create('http://www.foo.com/')
  6.     );
  8.     $route = new Route(['GET'], 'foo/{bar}', ['as' => 'routable']);
  9.     $routes->add($route);
  11.     $model = new RoutableInterfaceStub;
  12.     $model->key = 'routable';
  14.     $this->assertEquals('/foo/routable', $url->route('routable', $model, false));
  15. }
  17. class RoutableInterfaceStub implements UrlRoutable
  18. {
  19.     public $key;
  21.     public function getRouteKey()
  22.     {
  23.         return $this->{$this->getRouteKeyName()};
  24.     }
  26.     public function getRouteKeyName()
  27.     {
  28.         return 'key';
  29.     }
  30. }

URI 重定向源码分析

在说重定向的源码之前，我们先了解一下一般的 uri 基本组成：

scheme://domain:port/path?queryString

也就是说，一般 uri 由五部分构成。重定向实际上就是按照各种传入的参数以及属性的设置来重新生成上面的五部分：

  1. public function to($path, $extra = [], $secure = null)
  2. {
  3.     if ($this->isValidUrl($path)) {
  4.         return $path;
  5.     }
  7.     $tail = implode('/', array_map(
  8.         'rawurlencode', (array) $this->formatParameters($extra))
  9.     );
  11.     $root = $this->formatRoot($this->formatScheme($secure));
  13.     list($path, $query) = $this->extractQueryString($path);
  15.     return $this->format(
  16.         $root, '/'.trim($path.'/'.$tail, '/')
  17.     ).$query;
  18. }

重定向 scheme

重定向的 scheme 由函数 formatScheme 生成：

  1. public function formatScheme($secure)
  2. {
  3.     if (! is_null($secure)) {
  4.         return $secure ? 'https://' : 'http://';
  5.     }
  7.     if (is_null($this->cachedSchema)) {
  8.         $this->cachedSchema = $this->forceScheme ?: $this->request->getScheme().'://';
  9.     }
  11.     return $this->cachedSchema;
  12. }
  14. public function forceScheme($schema)
  15. {
  16.     $this->cachedSchema = null;
  18.     $this->forceScheme = $schema.'://';
  19. }

可以看出来， scheme 的生成存在优先级：

  • 由 to 传入的 secure 参数
  • 由 forceScheme 设置的 schema 参数
  • request 自带的 scheme

重定向 domain

重定向的 domain 由函数 formatRoot 生成：

  1. public function formatRoot($scheme, $root = null)
  2. {
  3.     if (is_null($root)) {
  4.         if (is_null($this->cachedRoot)) {
  5.             $this->cachedRoot = $this->forcedRoot ?: $this->request->root();
  6.         }
  8.         $root = $this->cachedRoot;
  9.     }
  11.     $start = Str::startsWith($root, 'http://') ? 'http://' : 'https://';
  13.     return preg_replace('~'.$start.'~', $scheme, $root, 1);
  14. }
  16. public function forceRootUrl($root)
  17. {
  18.     $this->forcedRoot = rtrim($root, '/');
  20.     $this->cachedRoot = null;
  21. }

与 scheme 类似，root 的生成也存在优先级：

  • 由 to 传入的 root 参数
  • 由 forceRootUrl 设置的 root 参数
  • request 自带的 root

重定向 path

重定向的 path 由三部分构成，一部分是 request 自带的 path，一部分是函数 to 原有的 path ，另一部分是函数 to 传入的参数：

  1. public function formatParameters($parameters)
  2. {
  3.     $parameters = array_wrap($parameters);
  5.     foreach ($parameters as $key => $parameter) {
  6.         if ($parameter instanceof UrlRoutable) {
  7.             $parameters[$key] = $parameter->getRouteKey();
  8.         }
  9.     }
  11.     return $parameters;
  12. }
  14. protected function extractQueryString($path)
  15. {
  16.     if (($queryPosition = strpos($path, '?')) !== false) {
  17.         return [
  18.             substr($path, 0, $queryPosition),
  19.             substr($path, $queryPosition),
  20.         ];
  21.     }
  23.     return [$path, ''];
  24. }

路由重定向源码分析

相对于 uri 的重定向来说，路由重定向的 scheme、root 、path、queryString 都要以路由自身的属性为第一优先级，此外还要利用额外参数来绑定路由的 uri 参数：

  1.  public function route($name, $parameters = [], $absolute = true)
  2. {
  3.     if (! is_null($route = $this->routes->getByName($name))) {
  4.         return $this->toRoute($route, $parameters, $absolute);
  5.     }
  7.     throw new InvalidArgumentException("Route [{$name}] not defined.");
  8. }
  10. public function to($route, $parameters = [], $absolute = false)
  11. {
  12.     $domain = $this->getRouteDomain($route, $parameters);
  14.     $uri = $this->addQueryString($this->url->format(
  15.         $root = $this->replaceRootParameters($route, $domain, $parameters),
  16.         $this->replaceRouteParameters($route->uri(), $parameters)
  17.     ), $parameters);
  19.     if (preg_match('/\{.*?\}/', $uri)) {
  20.         throw UrlGenerationException::forMissingParameters($route);
  21.     }
  23.     $uri = strtr(rawurlencode($uri), $this->dontEncode);
  25.     if (! $absolute) {
  26.         return '/'.ltrim(str_replace($root, '', $uri), '/');
  27.     }
  29.     return $uri;
  30. }

路由重定向 scheme

路由的重定向 scheme 需要先判断路由的 scheme 属性：

  1. protected function getRouteScheme($route)
  2. {
  3.     if ($route->httpOnly()) {
  4.         return 'http://';
  5.     } elseif ($route->httpsOnly()) {
  6.         return 'https://';
  7.     } else {
  8.         return $this->url->formatScheme(null);
  9.     }
  10. }

路由重定向 domain

  2. public function to($route, $parameters = [], $absolute = false)
  3. {
  4.     $domain = $this->getRouteDomain($route, $parameters);
  6.     $uri = $this->addQueryString($this->url->format(
  7.         $root = $this->replaceRootParameters($route, $domain, $parameters),
  8.         $this->replaceRouteParameters($route->uri(), $parameters)
  9.     ), $parameters);
  10.     ...
  11. }
  13. protected function getRouteDomain($route, &$parameters)
  14. {
  15.     return $route->domain() ? $this->formatDomain($route, $parameters) : null;
  16. }
  18. protected function formatDomain($route, &$parameters)
  19. {
  20.     return $this->addPortToDomain(
  21.         $this->getRouteScheme($route).$route->domain()
  22.     );
  23. }
  25. protected function addPortToDomain($domain)
  26. {
  27.     $secure = $this->request->isSecure();
  29.     $port = (int) $this->request->getPort();
  31.     return ($secure && $port === 443) || (! $secure && $port === 80)
  32.             ? $domain : $domain.':'.$port;
  33. }
  35. protected function replaceRootParameters($route, $domain, &$parameters)
  36. {
  37.     $scheme = $this->getRouteScheme($route);
  39.     return $this->replaceRouteParameters(
  40.         $this->url->formatRoot($scheme, $domain), $parameters
  41.     );
  42. }

可以看出路由重定向时，域名的生成主要先经过函数 getRouteDomain, 判断路由是否有 domain 属性,如果有域名属性，则将会作为 formatRoot 函数的参数传入，否则就会默认启动 1uri 重定向的域名生成方法。

路由重定向参数绑定

路由重定向可以利用函数 replaceRootParameters 在域名当中参数绑定，，也可以在路径当中利用函数 replaceRouteParameters 进行参数绑定。参数绑定分为命名参数绑定与匿名参数绑定：

  1. protected function replaceRouteParameters($path, array &$parameters)
  2. {
  3.     $path = $this->replaceNamedParameters($path, $parameters);
  5.     $path = preg_replace_callback('/\{.*?\}/', function ($match) use (&$parameters) {
  6.         return (empty($parameters) && ! Str::endsWith($match[0], '?}'))
  7.                     ? $match[0]
  8.                     : array_shift($parameters);
  9.     }, $path);
  11.     return trim(preg_replace('/\{.*?\?\}/', '', $path), '/');
  12. }

对于命名参数绑定,程序会分别从变量列表、默认变量列表中获取并替换路由参数对应的数值，若不存在该参数，则直接返回：

  1. protected function replaceNamedParameters($path, &$parameters)
  2. {
  3.     return preg_replace_callback('/\{(.*?)\??\}/', function ($m) use (&$parameters) {
  4.         if (isset($parameters[$m[1]])) {
  5.             return Arr::pull($parameters, $m[1]);
  6.         } elseif (isset($this->defaultParameters[$m[1]])) {
  7.             return $this->defaultParameters[$m[1]];
  8.         } else {
  9.             return $m[0];
  10.         }
  11.     }, $path);
  12. }

命名参数绑定结束后，剩下的未被替换的路由参数将会被未命名的变量按顺序来替换。

路由重定向 queryString

如果变量列表在绑定路由后仍然有剩余，那么变量将会作为路由的 queryString：

  1. protected function addQueryString($uri, array $parameters)
  2. {
  3.     if (! is_null($fragment = parse_url($uri, PHP_URL_FRAGMENT))) {
  4.         $uri = preg_replace('/#.*/', '', $uri);
  5.     }
  7.     $uri .= $this->getRouteQueryString($parameters);
  9.     return is_null($fragment) ? $uri : $uri."#{$fragment}";
  10. }
  12. protected function getRouteQueryString(array $parameters)
  13. {
  14.     if (count($parameters) == 0) {
  15.         return '';
  16.     }
  18.     $query = http_build_query(
  19.         $keyed = $this->getStringParameters($parameters)
  20.     );
  23.     if (count($keyed) < count($parameters)) {
  24.         $query .= '&'.implode(
  25.             '&', $this->getNumericParameters($parameters)
  26.         );
  27.     }
  29.     return '?'.trim($query, '&');
  30. }

路由重定向结束

路由 uri 构建完成后，将会继续判断是否存在违背绑定的路由参数，是否显示 absolute 的路由地址

  1. public function to($route, $parameters = [], $absolute = false)
  2. {
  3.     ...
  4.     if (preg_match('/\{.*?\}/', $uri)) {
  5.         throw UrlGenerationException::forMissingParameters($route);
  6.     }
  8.     $uri = strtr(rawurlencode($uri), $this->dontEncode);
  10.     if (! $absolute) {
  11.         return '/'.ltrim(str_replace($root, '', $uri), '/');
  12.     }
  14.     return $uri;
  15. }