Source for file SimpleRouter.php

Documentation is available at SimpleRouter.php

  1. 1: <?php
  2. 2:  
  3. 3: /**
  4. 4:  * Nette Framework
  5. 5:  *
  6. 6:  * Copyright (c) 2004, 2009 David Grudl (http://davidgrudl.com)
  7. 7:  *
  8. 8:  * This source file is subject to the "Nette license" that is bundled
  9. 9:  * with this package in the file license.txt.
  10. 10:  *
  11. 11:  * For more information please see http://nettephp.com
  12. 12:  *
  13. 13:  * @copyright  Copyright (c) 2004, 2009 David Grudl
  14. 14:  * @license    http://nettephp.com/license  Nette license
  15. 15:  * @link       http://nettephp.com
  16. 16:  * @category   Nette
  17. 17:  * @package    Nette\Application
  18. 18:  */
  19. 19:  
  20. 20:  
  21. 21:  
  22. 22: require_once dirname(__FILE__'/../../Object.php';
  23. 23:  
  24. 24: require_once dirname(__FILE__'/../../Application/IRouter.php';
  25. 25:  
  26. 26:  
  27. 27:  
  28. 28: /**
  29. 29:  * The bidirectional route for trivial routing via query string.
  30. 30:  *
  31. 31:  * @author     David Grudl
  32. 32:  * @copyright  Copyright (c) 2004, 2009 David Grudl
  33. 33:  * @package    Nette\Application
  34. 34:  */
  35. 35: class SimpleRouter extends Object implements IRouter
  36. 36: {
  37. 37:     const PRESENTER_KEY = 'presenter';
  38. 38:     const MODULE_KEY = 'module';
  39. 39:  
  40. 40:     /** @var string */
  41. 41:     private $module '';
  42. 42:  
  43. 43:     /** @var array */
  44. 44:     private $defaults;
  45. 45:  
  46. 46:     /** @var int */
  47. 47:     private $flags;
  48. 48:  
  49. 49:  
  50. 50:  
  51. 51:     /**
  52. 52:      * @param  array   default values
  53. 53:      * @param  int     flags
  54. 54:      */
  55. 55:     public function __construct($defaults array()$flags 0)
  56. 56:     {
  57. 57:         if (is_string($defaults)) {
  58. 58:             $a strrpos($defaults':');
  59. 59:             $defaults array(
  60. 60:                 self::PRESENTER_KEY => substr($defaults0$a),
  61. 61:                 'action' => substr($defaults$a 1),
  62. 62:             );
  63. 63:         }
  64. 64:  
  65. 65:         if (isset($defaults[self::MODULE_KEY])) {
  66. 66:             $this->module $defaults[self::MODULE_KEY':';
  67. 67:             unset($defaults[self::MODULE_KEY]);
  68. 68:         }
  69. 69:  
  70. 70:         $this->defaults $defaults;
  71. 71:         $this->flags $flags;
  72. 72:     }
  73. 73:  
  74. 74:  
  75. 75:  
  76. 76:     /**
  77. 77:      * Maps HTTP request to a PresenterRequest object.
  78. 78:      * @param  IHttpRequest 
  79. 79:      * @return PresenterRequest|NULL
  80. 80:      */
  81. 81:     public function match(IHttpRequest $httpRequest)
  82. 82:     {
  83. 83:         // combine with precedence: get, (post,) defaults
  84. 84:         $params $httpRequest->getQuery();
  85. 85:         $params += $this->defaults;
  86. 86:  
  87. 87:         if (!isset($params[self::PRESENTER_KEY])) {
  88. 88:             throw new InvalidStateException('Missing presenter.');
  89. 89:         }
  90. 90:  
  91. 91:         $presenter $this->module $params[self::PRESENTER_KEY];
  92. 92:         unset($params[self::PRESENTER_KEY]);
  93. 93:  
  94. 94:         return new PresenterRequest(
  95. 95:             $presenter,
  96. 96:             $httpRequest->getMethod(),
  97. 97:             $params,
  98. 98:             $httpRequest->getPost(),
  99. 99:             $httpRequest->getFiles(),
  100. 100:             array(PresenterRequest::SECURED => $httpRequest->isSecured())
  101. 101:         );
  102. 102:     }
  103. 103:  
  104. 104:  
  105. 105:  
  106. 106:     /**
  107. 107:      * Constructs absolute URL from PresenterRequest object.
  108. 108:      * @param  IHttpRequest 
  109. 109:      * @param  PresenterRequest 
  110. 110:      * @return string|NULL
  111. 111:      */
  112. 112:     public function constructUrl(PresenterRequest $appRequestIHttpRequest $httpRequest)
  113. 113:     {
  114. 114:         $params $appRequest->getParams();
  115. 115:  
  116. 116:         // presenter name
  117. 117:         $presenter $appRequest->getPresenterName();
  118. 118:         if (strncasecmp($presenter$this->modulestrlen($this->module)) === 0{
  119. 119:             $params[self::PRESENTER_KEYsubstr($presenterstrlen($this->module));
  120. 120:         else {
  121. 121:             return NULL;
  122. 122:         }
  123. 123:  
  124. 124:         // remove default values; NULL values are retain
  125. 125:         foreach ($this->defaults as $key => $value{
  126. 126:             if (isset($params[$key]&& $params[$key== $value// intentionally ==
  127. 127:                 unset($params[$key]);
  128. 128:             }
  129. 129:         }
  130. 130:  
  131. 131:         $uri $httpRequest->getUri();
  132. 132:         $uri ($this->flags self::SECURED 'https://' 'http://'$uri->getAuthority($uri->getScriptPath();
  133. 133:         $sep ini_get('arg_separator.input');
  134. 134:         $query http_build_query($params''$sep $sep[0'&');
  135. 135:         if ($query != ''// intentionally ==
  136. 136:             $uri .= '?' $query;
  137. 137:         }
  138. 138:         return $uri;
  139. 139:     }
  140. 140:  
  141. 141:  
  142. 142:  
  143. 143:     /**
  144. 144:      * Returns default values.
  145. 145:      * @return array 
  146. 146:      */
  147. 147:     public function getDefaults()
  148. 148:     {
  149. 149:         return $this->defaults;
  150. 150:     }
  151. 151: