RouteTest.php 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241
  1. <?php
  2. /*
  3. * This file is part of the Symfony package.
  4. *
  5. * (c) Fabien Potencier <fabien@symfony.com>
  6. *
  7. * For the full copyright and license information, please view the LICENSE
  8. * file that was distributed with this source code.
  9. */
  10. namespace Symfony\Component\Routing\Tests;
  11. use PHPUnit\Framework\TestCase;
  12. use Symfony\Component\Routing\Route;
  13. class RouteTest extends TestCase
  14. {
  15. public function testConstructor()
  16. {
  17. $route = new Route('/{foo}', array('foo' => 'bar'), array('foo' => '\d+'), array('foo' => 'bar'), '{locale}.example.com');
  18. $this->assertEquals('/{foo}', $route->getPath(), '__construct() takes a path as its first argument');
  19. $this->assertEquals(array('foo' => 'bar'), $route->getDefaults(), '__construct() takes defaults as its second argument');
  20. $this->assertEquals(array('foo' => '\d+'), $route->getRequirements(), '__construct() takes requirements as its third argument');
  21. $this->assertEquals('bar', $route->getOption('foo'), '__construct() takes options as its fourth argument');
  22. $this->assertEquals('{locale}.example.com', $route->getHost(), '__construct() takes a host pattern as its fifth argument');
  23. $route = new Route('/', array(), array(), array(), '', array('Https'), array('POST', 'put'), 'context.getMethod() == "GET"');
  24. $this->assertEquals(array('https'), $route->getSchemes(), '__construct() takes schemes as its sixth argument and lowercases it');
  25. $this->assertEquals(array('POST', 'PUT'), $route->getMethods(), '__construct() takes methods as its seventh argument and uppercases it');
  26. $this->assertEquals('context.getMethod() == "GET"', $route->getCondition(), '__construct() takes a condition as its eight argument');
  27. $route = new Route('/', array(), array(), array(), '', 'Https', 'Post');
  28. $this->assertEquals(array('https'), $route->getSchemes(), '__construct() takes a single scheme as its sixth argument');
  29. $this->assertEquals(array('POST'), $route->getMethods(), '__construct() takes a single method as its seventh argument');
  30. }
  31. public function testPath()
  32. {
  33. $route = new Route('/{foo}');
  34. $route->setPath('/{bar}');
  35. $this->assertEquals('/{bar}', $route->getPath(), '->setPath() sets the path');
  36. $route->setPath('');
  37. $this->assertEquals('/', $route->getPath(), '->setPath() adds a / at the beginning of the path if needed');
  38. $route->setPath('bar');
  39. $this->assertEquals('/bar', $route->getPath(), '->setPath() adds a / at the beginning of the path if needed');
  40. $this->assertEquals($route, $route->setPath(''), '->setPath() implements a fluent interface');
  41. $route->setPath('//path');
  42. $this->assertEquals('/path', $route->getPath(), '->setPath() does not allow two slashes "//" at the beginning of the path as it would be confused with a network path when generating the path from the route');
  43. }
  44. public function testOptions()
  45. {
  46. $route = new Route('/{foo}');
  47. $route->setOptions(array('foo' => 'bar'));
  48. $this->assertEquals(array_merge(array(
  49. 'compiler_class' => 'Symfony\\Component\\Routing\\RouteCompiler',
  50. ), array('foo' => 'bar')), $route->getOptions(), '->setOptions() sets the options');
  51. $this->assertEquals($route, $route->setOptions(array()), '->setOptions() implements a fluent interface');
  52. $route->setOptions(array('foo' => 'foo'));
  53. $route->addOptions(array('bar' => 'bar'));
  54. $this->assertEquals($route, $route->addOptions(array()), '->addOptions() implements a fluent interface');
  55. $this->assertEquals(array('foo' => 'foo', 'bar' => 'bar', 'compiler_class' => 'Symfony\\Component\\Routing\\RouteCompiler'), $route->getOptions(), '->addDefaults() keep previous defaults');
  56. }
  57. public function testOption()
  58. {
  59. $route = new Route('/{foo}');
  60. $this->assertFalse($route->hasOption('foo'), '->hasOption() return false if option is not set');
  61. $this->assertEquals($route, $route->setOption('foo', 'bar'), '->setOption() implements a fluent interface');
  62. $this->assertEquals('bar', $route->getOption('foo'), '->setOption() sets the option');
  63. $this->assertTrue($route->hasOption('foo'), '->hasOption() return true if option is set');
  64. }
  65. public function testDefaults()
  66. {
  67. $route = new Route('/{foo}');
  68. $route->setDefaults(array('foo' => 'bar'));
  69. $this->assertEquals(array('foo' => 'bar'), $route->getDefaults(), '->setDefaults() sets the defaults');
  70. $this->assertEquals($route, $route->setDefaults(array()), '->setDefaults() implements a fluent interface');
  71. $route->setDefault('foo', 'bar');
  72. $this->assertEquals('bar', $route->getDefault('foo'), '->setDefault() sets a default value');
  73. $route->setDefault('foo2', 'bar2');
  74. $this->assertEquals('bar2', $route->getDefault('foo2'), '->getDefault() return the default value');
  75. $this->assertNull($route->getDefault('not_defined'), '->getDefault() return null if default value is not set');
  76. $route->setDefault('_controller', $closure = function () { return 'Hello'; });
  77. $this->assertEquals($closure, $route->getDefault('_controller'), '->setDefault() sets a default value');
  78. $route->setDefaults(array('foo' => 'foo'));
  79. $route->addDefaults(array('bar' => 'bar'));
  80. $this->assertEquals($route, $route->addDefaults(array()), '->addDefaults() implements a fluent interface');
  81. $this->assertEquals(array('foo' => 'foo', 'bar' => 'bar'), $route->getDefaults(), '->addDefaults() keep previous defaults');
  82. }
  83. public function testRequirements()
  84. {
  85. $route = new Route('/{foo}');
  86. $route->setRequirements(array('foo' => '\d+'));
  87. $this->assertEquals(array('foo' => '\d+'), $route->getRequirements(), '->setRequirements() sets the requirements');
  88. $this->assertEquals('\d+', $route->getRequirement('foo'), '->getRequirement() returns a requirement');
  89. $this->assertNull($route->getRequirement('bar'), '->getRequirement() returns null if a requirement is not defined');
  90. $route->setRequirements(array('foo' => '^\d+$'));
  91. $this->assertEquals('\d+', $route->getRequirement('foo'), '->getRequirement() removes ^ and $ from the path');
  92. $this->assertEquals($route, $route->setRequirements(array()), '->setRequirements() implements a fluent interface');
  93. $route->setRequirements(array('foo' => '\d+'));
  94. $route->addRequirements(array('bar' => '\d+'));
  95. $this->assertEquals($route, $route->addRequirements(array()), '->addRequirements() implements a fluent interface');
  96. $this->assertEquals(array('foo' => '\d+', 'bar' => '\d+'), $route->getRequirements(), '->addRequirement() keep previous requirements');
  97. }
  98. public function testRequirement()
  99. {
  100. $route = new Route('/{foo}');
  101. $this->assertFalse($route->hasRequirement('foo'), '->hasRequirement() return false if requirement is not set');
  102. $route->setRequirement('foo', '^\d+$');
  103. $this->assertEquals('\d+', $route->getRequirement('foo'), '->setRequirement() removes ^ and $ from the path');
  104. $this->assertTrue($route->hasRequirement('foo'), '->hasRequirement() return true if requirement is set');
  105. }
  106. /**
  107. * @dataProvider getInvalidRequirements
  108. * @expectedException \InvalidArgumentException
  109. */
  110. public function testSetInvalidRequirement($req)
  111. {
  112. $route = new Route('/{foo}');
  113. $route->setRequirement('foo', $req);
  114. }
  115. public function getInvalidRequirements()
  116. {
  117. return array(
  118. array(''),
  119. array(array()),
  120. array('^$'),
  121. array('^'),
  122. array('$'),
  123. );
  124. }
  125. public function testHost()
  126. {
  127. $route = new Route('/');
  128. $route->setHost('{locale}.example.net');
  129. $this->assertEquals('{locale}.example.net', $route->getHost(), '->setHost() sets the host pattern');
  130. }
  131. public function testScheme()
  132. {
  133. $route = new Route('/');
  134. $this->assertEquals(array(), $route->getSchemes(), 'schemes is initialized with array()');
  135. $this->assertFalse($route->hasScheme('http'));
  136. $route->setSchemes('hTTp');
  137. $this->assertEquals(array('http'), $route->getSchemes(), '->setSchemes() accepts a single scheme string and lowercases it');
  138. $this->assertTrue($route->hasScheme('htTp'));
  139. $this->assertFalse($route->hasScheme('httpS'));
  140. $route->setSchemes(array('HttpS', 'hTTp'));
  141. $this->assertEquals(array('https', 'http'), $route->getSchemes(), '->setSchemes() accepts an array of schemes and lowercases them');
  142. $this->assertTrue($route->hasScheme('htTp'));
  143. $this->assertTrue($route->hasScheme('httpS'));
  144. }
  145. public function testMethod()
  146. {
  147. $route = new Route('/');
  148. $this->assertEquals(array(), $route->getMethods(), 'methods is initialized with array()');
  149. $route->setMethods('gEt');
  150. $this->assertEquals(array('GET'), $route->getMethods(), '->setMethods() accepts a single method string and uppercases it');
  151. $route->setMethods(array('gEt', 'PosT'));
  152. $this->assertEquals(array('GET', 'POST'), $route->getMethods(), '->setMethods() accepts an array of methods and uppercases them');
  153. }
  154. public function testCondition()
  155. {
  156. $route = new Route('/');
  157. $this->assertSame('', $route->getCondition());
  158. $route->setCondition('context.getMethod() == "GET"');
  159. $this->assertSame('context.getMethod() == "GET"', $route->getCondition());
  160. }
  161. public function testCompile()
  162. {
  163. $route = new Route('/{foo}');
  164. $this->assertInstanceOf('Symfony\Component\Routing\CompiledRoute', $compiled = $route->compile(), '->compile() returns a compiled route');
  165. $this->assertSame($compiled, $route->compile(), '->compile() only compiled the route once if unchanged');
  166. $route->setRequirement('foo', '.*');
  167. $this->assertNotSame($compiled, $route->compile(), '->compile() recompiles if the route was modified');
  168. }
  169. public function testSerialize()
  170. {
  171. $route = new Route('/prefix/{foo}', array('foo' => 'default'), array('foo' => '\d+'));
  172. $serialized = serialize($route);
  173. $unserialized = unserialize($serialized);
  174. $this->assertEquals($route, $unserialized);
  175. $this->assertNotSame($route, $unserialized);
  176. }
  177. /**
  178. * Tests that the compiled version is also serialized to prevent the overhead
  179. * of compiling it again after unserialize.
  180. */
  181. public function testSerializeWhenCompiled()
  182. {
  183. $route = new Route('/prefix/{foo}', array('foo' => 'default'), array('foo' => '\d+'));
  184. $route->setHost('{locale}.example.net');
  185. $route->compile();
  186. $serialized = serialize($route);
  187. $unserialized = unserialize($serialized);
  188. $this->assertEquals($route, $unserialized);
  189. $this->assertNotSame($route, $unserialized);
  190. }
  191. /**
  192. * Tests that the serialized representation of a route in one symfony version
  193. * also works in later symfony versions, i.e. the unserialized route is in the
  194. * same state as another, semantically equivalent, route.
  195. */
  196. public function testSerializedRepresentationKeepsWorking()
  197. {
  198. $serialized = 'C:31:"Symfony\Component\Routing\Route":934:{a:8:{s:4:"path";s:13:"/prefix/{foo}";s:4:"host";s:20:"{locale}.example.net";s:8:"defaults";a:1:{s:3:"foo";s:7:"default";}s:12:"requirements";a:1:{s:3:"foo";s:3:"\d+";}s:7:"options";a:1:{s:14:"compiler_class";s:39:"Symfony\Component\Routing\RouteCompiler";}s:7:"schemes";a:0:{}s:7:"methods";a:0:{}s:8:"compiled";C:39:"Symfony\Component\Routing\CompiledRoute":569:{a:8:{s:4:"vars";a:2:{i:0;s:6:"locale";i:1;s:3:"foo";}s:11:"path_prefix";s:7:"/prefix";s:10:"path_regex";s:30:"#^/prefix(?:/(?P<foo>\d+))?$#s";s:11:"path_tokens";a:2:{i:0;a:4:{i:0;s:8:"variable";i:1;s:1:"/";i:2;s:3:"\d+";i:3;s:3:"foo";}i:1;a:2:{i:0;s:4:"text";i:1;s:7:"/prefix";}}s:9:"path_vars";a:1:{i:0;s:3:"foo";}s:10:"host_regex";s:39:"#^(?P<locale>[^\.]++)\.example\.net$#si";s:11:"host_tokens";a:2:{i:0;a:2:{i:0;s:4:"text";i:1;s:12:".example.net";}i:1;a:4:{i:0;s:8:"variable";i:1;s:0:"";i:2;s:7:"[^\.]++";i:3;s:6:"locale";}}s:9:"host_vars";a:1:{i:0;s:6:"locale";}}}}}';
  199. $unserialized = unserialize($serialized);
  200. $route = new Route('/prefix/{foo}', array('foo' => 'default'), array('foo' => '\d+'));
  201. $route->setHost('{locale}.example.net');
  202. $route->compile();
  203. $this->assertEquals($route, $unserialized);
  204. $this->assertNotSame($route, $unserialized);
  205. }
  206. }