ControllerTest.php 35 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079
  1. <?php
  2. declare(strict_types=1);
  3. /**
  4. * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
  5. * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
  6. *
  7. * Licensed under The MIT License
  8. * For full copyright and license information, please see the LICENSE.txt
  9. * Redistributions of files must retain the above copyright notice.
  10. *
  11. * @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
  12. * @link https://cakephp.org CakePHP Project
  13. * @since 1.2.0
  14. * @license https://opensource.org/licenses/mit-license.php MIT License
  15. */
  16. namespace Cake\Test\TestCase\Controller;
  17. use Cake\Controller\Controller;
  18. use Cake\Core\Configure;
  19. use Cake\Event\Event;
  20. use Cake\Event\EventInterface;
  21. use Cake\Http\Response;
  22. use Cake\Http\ServerRequest;
  23. use Cake\Routing\Router;
  24. use Cake\TestSuite\TestCase;
  25. use PHPUnit\Framework\Error\Notice;
  26. use PHPUnit\Framework\Error\Warning;
  27. use TestApp\Controller\Admin\PostsController;
  28. use TestApp\Controller\TestController;
  29. use TestPlugin\Controller\TestPluginController;
  30. /**
  31. * ControllerTest class
  32. */
  33. class ControllerTest extends TestCase
  34. {
  35. /**
  36. * fixtures property
  37. *
  38. * @var array
  39. */
  40. public $fixtures = [
  41. 'core.Comments',
  42. 'core.Posts',
  43. ];
  44. /**
  45. * reset environment.
  46. *
  47. * @return void
  48. */
  49. public function setUp(): void
  50. {
  51. parent::setUp();
  52. static::setAppNamespace();
  53. Router::reload();
  54. }
  55. /**
  56. * tearDown
  57. *
  58. * @return void
  59. */
  60. public function tearDown(): void
  61. {
  62. parent::tearDown();
  63. $this->clearPlugins();
  64. }
  65. /**
  66. * test autoload modelClass
  67. *
  68. * @return void
  69. */
  70. public function testTableAutoload(): void
  71. {
  72. $request = new ServerRequest(['url' => 'controller/posts/index']);
  73. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  74. $Controller = new Controller($request, $response);
  75. $Controller->modelClass = 'SiteArticles';
  76. $this->assertFalse(isset($Controller->Articles));
  77. $this->assertInstanceOf(
  78. 'Cake\ORM\Table',
  79. $Controller->SiteArticles
  80. );
  81. unset($Controller->SiteArticles);
  82. $Controller->modelClass = 'Articles';
  83. $this->assertFalse(isset($Controller->SiteArticles));
  84. $this->assertInstanceOf(
  85. 'TestApp\Model\Table\ArticlesTable',
  86. $Controller->Articles
  87. );
  88. }
  89. /**
  90. * testUndefinedPropertyError
  91. *
  92. * @return void
  93. */
  94. public function testUndefinedPropertyError()
  95. {
  96. $controller = new Controller();
  97. $controller->Bar = true;
  98. $this->assertTrue($controller->Bar);
  99. $this->expectException(Notice::class);
  100. $this->expectExceptionMessage(sprintf(
  101. 'Undefined property: Controller::$Foo in %s on line %s',
  102. __FILE__,
  103. __LINE__ + 2
  104. ));
  105. $controller->Foo->baz();
  106. }
  107. /**
  108. * testLoadModel method
  109. *
  110. * @return void
  111. */
  112. public function testLoadModel(): void
  113. {
  114. $request = new ServerRequest(['url' => 'controller/posts/index']);
  115. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  116. $Controller = new Controller($request, $response);
  117. $this->assertFalse(isset($Controller->Articles));
  118. $result = $Controller->loadModel('Articles');
  119. $this->assertInstanceOf(
  120. 'TestApp\Model\Table\ArticlesTable',
  121. $result
  122. );
  123. $this->assertInstanceOf(
  124. 'TestApp\Model\Table\ArticlesTable',
  125. $Controller->Articles
  126. );
  127. }
  128. /**
  129. * testLoadModel method from a plugin controller
  130. *
  131. * @return void
  132. */
  133. public function testLoadModelInPlugins(): void
  134. {
  135. $this->loadPlugins(['TestPlugin']);
  136. $Controller = new TestPluginController();
  137. $Controller->setPlugin('TestPlugin');
  138. $this->assertFalse(isset($Controller->TestPluginComments));
  139. $result = $Controller->loadModel('TestPlugin.TestPluginComments');
  140. $this->assertInstanceOf(
  141. 'TestPlugin\Model\Table\TestPluginCommentsTable',
  142. $result
  143. );
  144. $this->assertInstanceOf(
  145. 'TestPlugin\Model\Table\TestPluginCommentsTable',
  146. $Controller->TestPluginComments
  147. );
  148. }
  149. /**
  150. * Test that the constructor sets modelClass properly.
  151. *
  152. * @return void
  153. */
  154. public function testConstructSetModelClass(): void
  155. {
  156. $this->loadPlugins(['TestPlugin']);
  157. $request = new ServerRequest();
  158. $response = new Response();
  159. $controller = new \TestApp\Controller\PostsController($request, $response);
  160. $this->assertInstanceOf('Cake\ORM\Table', $controller->loadModel());
  161. $this->assertInstanceOf('Cake\ORM\Table', $controller->Posts);
  162. $controller = new \TestApp\Controller\Admin\PostsController($request, $response);
  163. $this->assertInstanceOf('Cake\ORM\Table', $controller->loadModel());
  164. $this->assertInstanceOf('Cake\ORM\Table', $controller->Posts);
  165. $request = $request->withParam('plugin', 'TestPlugin');
  166. $controller = new \TestPlugin\Controller\Admin\CommentsController($request, $response);
  167. $this->assertInstanceOf('TestPlugin\Model\Table\CommentsTable', $controller->loadModel());
  168. $this->assertInstanceOf('TestPlugin\Model\Table\CommentsTable', $controller->Comments);
  169. }
  170. /**
  171. * testConstructClassesWithComponents method
  172. *
  173. * @return void
  174. */
  175. public function testConstructClassesWithComponents(): void
  176. {
  177. $this->loadPlugins(['TestPlugin']);
  178. $Controller = new TestPluginController(new ServerRequest(), new Response());
  179. $Controller->loadComponent('TestPlugin.Other');
  180. $this->assertInstanceOf('TestPlugin\Controller\Component\OtherComponent', $Controller->Other);
  181. }
  182. /**
  183. * testRender method
  184. *
  185. * @return void
  186. */
  187. public function testRender(): void
  188. {
  189. $this->loadPlugins(['TestPlugin']);
  190. $request = new ServerRequest([
  191. 'url' => 'controller_posts/index',
  192. 'params' => [
  193. 'action' => 'header',
  194. ],
  195. ]);
  196. $Controller = new Controller($request, new Response());
  197. $Controller->viewBuilder()->setTemplatePath('Posts');
  198. $result = $Controller->render('index');
  199. $this->assertRegExp('/posts index/', (string)$result);
  200. $Controller->viewBuilder()->setTemplate('index');
  201. $result = $Controller->render();
  202. $this->assertRegExp('/posts index/', (string)$result);
  203. $result = $Controller->render('/element/test_element');
  204. $this->assertRegExp('/this is the test element/', (string)$result);
  205. }
  206. /**
  207. * test view rendering changing response
  208. *
  209. * @return void
  210. */
  211. public function testRenderViewChangesResponse(): void
  212. {
  213. $request = new ServerRequest([
  214. 'url' => 'controller_posts/index',
  215. 'params' => [
  216. 'action' => 'header',
  217. ],
  218. ]);
  219. $controller = new Controller($request, new Response());
  220. $controller->viewBuilder()->setTemplatePath('Posts');
  221. $result = $controller->render('header');
  222. $this->assertStringContainsString('header template', (string)$result);
  223. $this->assertTrue($controller->getResponse()->hasHeader('X-view-template'));
  224. $this->assertSame('yes', $controller->getResponse()->getHeaderLine('X-view-template'));
  225. }
  226. /**
  227. * test that a component beforeRender can change the controller view class.
  228. *
  229. * @return void
  230. */
  231. public function testBeforeRenderCallbackChangingViewClass(): void
  232. {
  233. $Controller = new Controller(new ServerRequest(), new Response());
  234. $Controller->getEventManager()->on('Controller.beforeRender', function (EventInterface $event): void {
  235. $controller = $event->getSubject();
  236. $controller->viewBuilder()->setClassName('Json');
  237. });
  238. $Controller->set([
  239. 'test' => 'value',
  240. ]);
  241. $Controller->viewBuilder()->setOption('serialize', ['test']);
  242. $debug = Configure::read('debug');
  243. Configure::write('debug', false);
  244. $result = $Controller->render('index');
  245. $this->assertSame('{"test":"value"}', (string)$result->getBody());
  246. Configure::write('debug', $debug);
  247. }
  248. /**
  249. * test that a component beforeRender can change the controller view class.
  250. *
  251. * @return void
  252. */
  253. public function testBeforeRenderEventCancelsRender(): void
  254. {
  255. $Controller = new Controller(new ServerRequest(), new Response());
  256. $Controller->getEventManager()->on('Controller.beforeRender', function (EventInterface $event) {
  257. return false;
  258. });
  259. $result = $Controller->render('index');
  260. $this->assertInstanceOf('Cake\Http\Response', $result);
  261. }
  262. /**
  263. * Generates status codes for redirect test.
  264. *
  265. * @return array
  266. */
  267. public static function statusCodeProvider(): array
  268. {
  269. return [
  270. [300, 'Multiple Choices'],
  271. [301, 'Moved Permanently'],
  272. [302, 'Found'],
  273. [303, 'See Other'],
  274. [304, 'Not Modified'],
  275. [305, 'Use Proxy'],
  276. [307, 'Temporary Redirect'],
  277. [403, 'Forbidden'],
  278. ];
  279. }
  280. /**
  281. * testRedirect method
  282. *
  283. * @dataProvider statusCodeProvider
  284. * @return void
  285. */
  286. public function testRedirectByCode($code, $msg): void
  287. {
  288. $Controller = new Controller(null, new Response());
  289. $response = $Controller->redirect('http://cakephp.org', (int)$code);
  290. $this->assertSame($response, $Controller->getResponse());
  291. $this->assertEquals($code, $response->getStatusCode());
  292. $this->assertSame('http://cakephp.org', $response->getHeaderLine('Location'));
  293. $this->assertFalse($Controller->isAutoRenderEnabled());
  294. }
  295. /**
  296. * test that beforeRedirect callbacks can set the URL that is being redirected to.
  297. *
  298. * @return void
  299. */
  300. public function testRedirectBeforeRedirectModifyingUrl(): void
  301. {
  302. $Controller = new Controller(null, new Response());
  303. $Controller->getEventManager()->on('Controller.beforeRedirect', function (EventInterface $event, $url, Response $response): void {
  304. $controller = $event->getSubject();
  305. $controller->setResponse($response->withLocation('https://book.cakephp.org'));
  306. });
  307. $response = $Controller->redirect('http://cakephp.org', 301);
  308. $this->assertSame('https://book.cakephp.org', $response->getHeaderLine('Location'));
  309. $this->assertEquals(301, $response->getStatusCode());
  310. }
  311. /**
  312. * test that beforeRedirect callback returning null doesn't affect things.
  313. *
  314. * @return void
  315. */
  316. public function testRedirectBeforeRedirectModifyingStatusCode(): void
  317. {
  318. $response = new Response();
  319. $Controller = new Controller(null, $response);
  320. $Controller->getEventManager()->on('Controller.beforeRedirect', function (EventInterface $event, $url, Response $response): void {
  321. $controller = $event->getSubject();
  322. $controller->setResponse($response->withStatus(302));
  323. });
  324. $response = $Controller->redirect('http://cakephp.org', 301);
  325. $this->assertSame('http://cakephp.org', $response->getHeaderLine('Location'));
  326. $this->assertEquals(302, $response->getStatusCode());
  327. }
  328. public function testRedirectBeforeRedirectListenerReturnResponse(): void
  329. {
  330. $Response = $this->getMockBuilder('Cake\Http\Response')
  331. ->setMethods(['stop', 'header', 'statusCode'])
  332. ->getMock();
  333. $Controller = new Controller(null, $Response);
  334. $newResponse = new Response();
  335. $Controller->getEventManager()->on('Controller.beforeRedirect', function (EventInterface $event, $url, Response $response) use ($newResponse) {
  336. return $newResponse;
  337. });
  338. $result = $Controller->redirect('http://cakephp.org');
  339. $this->assertSame($newResponse, $result);
  340. $this->assertSame($newResponse, $Controller->getResponse());
  341. }
  342. /**
  343. * testReferer method
  344. *
  345. * @return void
  346. */
  347. public function testReferer(): void
  348. {
  349. $request = $this->getMockBuilder('Cake\Http\ServerRequest')
  350. ->setMethods(['referer'])
  351. ->getMock();
  352. $request->expects($this->any())->method('referer')
  353. ->with(true)
  354. ->will($this->returnValue('/posts/index'));
  355. $Controller = new Controller($request);
  356. $result = $Controller->referer();
  357. $this->assertSame('/posts/index', $result);
  358. $request = $this->getMockBuilder('Cake\Http\ServerRequest')
  359. ->setMethods(['referer'])
  360. ->getMock();
  361. $request->expects($this->any())->method('referer')
  362. ->with(true)
  363. ->will($this->returnValue('/posts/index'));
  364. $Controller = new Controller($request);
  365. $result = $Controller->referer(['controller' => 'posts', 'action' => 'index'], true);
  366. $this->assertSame('/posts/index', $result);
  367. $request = $this->getMockBuilder('Cake\Http\ServerRequest')
  368. ->setMethods(['referer'])
  369. ->getMock();
  370. $request->expects($this->any())->method('referer')
  371. ->with(false)
  372. ->will($this->returnValue('http://localhost/posts/index'));
  373. $Controller = new Controller($request);
  374. $result = $Controller->referer(null, false);
  375. $this->assertSame('http://localhost/posts/index', $result);
  376. $Controller = new Controller(null);
  377. $result = $Controller->referer('/', false);
  378. $this->assertSame('http://localhost/', $result);
  379. }
  380. /**
  381. * Test that the referer is not absolute if it is '/'.
  382. *
  383. * This avoids the base path being applied twice on string urls.
  384. *
  385. * @return void
  386. */
  387. public function testRefererSlash(): void
  388. {
  389. /** @var \Cake\Http\ServerRequest|\PHPUnit\Framework\MockObject\MockObject $request */
  390. $request = $this->getMockBuilder(ServerRequest::class)
  391. ->setMethods(['referer'])
  392. ->getMock();
  393. $request = $request->withAttribute('base', '/base');
  394. Router::pushRequest($request);
  395. $request->expects($this->any())->method('referer')
  396. ->will($this->returnValue(null));
  397. $controller = new Controller($request);
  398. $result = $controller->referer('/', true);
  399. $this->assertSame('/', $result);
  400. $controller = new Controller($request);
  401. $result = $controller->referer('/some/path', true);
  402. $this->assertSame('/some/path', $result);
  403. }
  404. /**
  405. * testSetAction method
  406. *
  407. * @return void
  408. */
  409. public function testSetAction(): void
  410. {
  411. $request = new ServerRequest(['url' => 'controller/posts/index']);
  412. $TestController = new TestController($request);
  413. $TestController->setAction('view', 1, 2);
  414. $expected = ['testId' => 1, 'test2Id' => 2];
  415. $this->assertSame($expected, $TestController->getRequest()->getData());
  416. $this->assertSame('view', $TestController->getRequest()->getParam('action'));
  417. }
  418. /**
  419. * Tests that the startup process calls the correct functions
  420. *
  421. * @return void
  422. */
  423. public function testStartupProcess(): void
  424. {
  425. $eventManager = $this->getMockBuilder('Cake\Event\EventManagerInterface')->getMock();
  426. $controller = new Controller(null, null, null, $eventManager);
  427. $eventManager
  428. ->expects($this->at(0))
  429. ->method('dispatch')
  430. ->with($this->callback(function (EventInterface $event) {
  431. return $event->getName() === 'Controller.initialize';
  432. }))
  433. ->will($this->returnValue(new Event('stub')));
  434. $eventManager
  435. ->expects($this->at(1))
  436. ->method('dispatch')
  437. ->with($this->callback(function (EventInterface $event) {
  438. return $event->getName() === 'Controller.startup';
  439. }))
  440. ->will($this->returnValue(new Event('stub')));
  441. $controller->startupProcess();
  442. }
  443. /**
  444. * Tests that the shutdown process calls the correct functions
  445. *
  446. * @return void
  447. */
  448. public function testShutdownProcess(): void
  449. {
  450. $eventManager = $this->getMockBuilder('Cake\Event\EventManagerInterface')->getMock();
  451. $controller = new Controller(null, null, null, $eventManager);
  452. $eventManager->expects($this->once())
  453. ->method('dispatch')
  454. ->with($this->callback(function (EventInterface $event) {
  455. return $event->getName() === 'Controller.shutdown';
  456. }))
  457. ->will($this->returnValue(new Event('stub')));
  458. $controller->shutdownProcess();
  459. }
  460. /**
  461. * test using Controller::paginate()
  462. *
  463. * @return void
  464. */
  465. public function testPaginate(): void
  466. {
  467. $request = new ServerRequest(['url' => 'controller_posts/index']);
  468. $response = $this->getMockBuilder('Cake\Http\Response')
  469. ->setMethods(['httpCodes'])
  470. ->getMock();
  471. $Controller = new Controller($request, $response);
  472. $Controller->setRequest($Controller->getRequest()->withQueryParams([
  473. 'posts' => [
  474. 'page' => 2,
  475. 'limit' => 2,
  476. ],
  477. ]));
  478. $this->assertEquals([], $Controller->paginate);
  479. $this->assertNotContains('Paginator', $Controller->viewBuilder()->getHelpers());
  480. $this->assertArrayNotHasKey('Paginator', $Controller->viewBuilder()->getHelpers());
  481. $results = $Controller->paginate('Posts');
  482. $this->assertInstanceOf('Cake\Datasource\ResultSetInterface', $results);
  483. $this->assertCount(3, $results);
  484. $results = $Controller->paginate($this->getTableLocator()->get('Posts'));
  485. $this->assertInstanceOf('Cake\Datasource\ResultSetInterface', $results);
  486. $this->assertCount(3, $results);
  487. $paging = $Controller->getRequest()->getParam('paging');
  488. $this->assertSame($paging['Posts']['page'], 1);
  489. $this->assertSame($paging['Posts']['pageCount'], 1);
  490. $this->assertFalse($paging['Posts']['prevPage']);
  491. $this->assertFalse($paging['Posts']['nextPage']);
  492. $this->assertNull($paging['Posts']['scope']);
  493. $results = $Controller->paginate($this->getTableLocator()->get('Posts'), ['scope' => 'posts']);
  494. $this->assertInstanceOf('Cake\Datasource\ResultSetInterface', $results);
  495. $this->assertCount(1, $results);
  496. $paging = $Controller->getRequest()->getParam('paging');
  497. $this->assertSame($paging['Posts']['page'], 2);
  498. $this->assertSame($paging['Posts']['pageCount'], 2);
  499. $this->assertTrue($paging['Posts']['prevPage']);
  500. $this->assertFalse($paging['Posts']['nextPage']);
  501. $this->assertSame($paging['Posts']['scope'], 'posts');
  502. }
  503. /**
  504. * test that paginate uses modelClass property.
  505. *
  506. * @return void
  507. */
  508. public function testPaginateUsesModelClass(): void
  509. {
  510. $request = new ServerRequest([
  511. 'url' => 'controller_posts/index',
  512. ]);
  513. $response = $this->getMockBuilder('Cake\Http\Response')
  514. ->setMethods(['httpCodes'])
  515. ->getMock();
  516. $Controller = new Controller($request, $response);
  517. $Controller->modelClass = 'Posts';
  518. $results = $Controller->paginate();
  519. $this->assertInstanceOf('Cake\Datasource\ResultSetInterface', $results);
  520. }
  521. /**
  522. * testMissingAction method
  523. *
  524. * @return void
  525. */
  526. public function testInvokeActionMissingAction(): void
  527. {
  528. $this->expectException(\Cake\Controller\Exception\MissingActionException::class);
  529. $this->expectExceptionMessage('Action TestController::missing() could not be found, or is not accessible.');
  530. $url = new ServerRequest([
  531. 'url' => 'test/missing',
  532. 'params' => ['controller' => 'Test', 'action' => 'missing'],
  533. ]);
  534. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  535. $Controller = new TestController($url, $response);
  536. $Controller->invokeAction();
  537. }
  538. /**
  539. * test invoking private methods.
  540. *
  541. * @return void
  542. */
  543. public function testInvokeActionPrivate(): void
  544. {
  545. $this->expectException(\Cake\Controller\Exception\MissingActionException::class);
  546. $this->expectExceptionMessage('Action TestController::private_m() could not be found, or is not accessible.');
  547. $url = new ServerRequest([
  548. 'url' => 'test/private_m/',
  549. 'params' => ['controller' => 'Test', 'action' => 'private_m'],
  550. ]);
  551. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  552. $Controller = new TestController($url, $response);
  553. $Controller->invokeAction();
  554. }
  555. /**
  556. * test invoking protected methods.
  557. *
  558. * @return void
  559. */
  560. public function testInvokeActionProtected(): void
  561. {
  562. $this->expectException(\Cake\Controller\Exception\MissingActionException::class);
  563. $this->expectExceptionMessage('Action TestController::protected_m() could not be found, or is not accessible.');
  564. $url = new ServerRequest([
  565. 'url' => 'test/protected_m/',
  566. 'params' => ['controller' => 'Test', 'action' => 'protected_m'],
  567. ]);
  568. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  569. $Controller = new TestController($url, $response);
  570. $Controller->invokeAction();
  571. }
  572. /**
  573. * test invoking controller methods.
  574. *
  575. * @return void
  576. */
  577. public function testInvokeActionBaseMethods(): void
  578. {
  579. $this->expectException(\Cake\Controller\Exception\MissingActionException::class);
  580. $this->expectExceptionMessage('Action TestController::redirect() could not be found, or is not accessible.');
  581. $url = new ServerRequest([
  582. 'url' => 'test/redirect/',
  583. 'params' => ['controller' => 'Test', 'action' => 'redirect'],
  584. ]);
  585. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  586. $Controller = new TestController($url, $response);
  587. $Controller->invokeAction();
  588. }
  589. /**
  590. * test invoking action method with mismatched casing.
  591. *
  592. * @return void
  593. */
  594. public function testInvokeActionMethodCasing(): void
  595. {
  596. $this->expectException(\Cake\Controller\Exception\MissingActionException::class);
  597. $this->expectExceptionMessage('Action TestController::RETURNER() could not be found, or is not accessible.');
  598. $url = new ServerRequest([
  599. 'url' => 'test/RETURNER/',
  600. 'params' => ['controller' => 'Test', 'action' => 'RETURNER'],
  601. ]);
  602. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  603. $Controller = new TestController($url, $response);
  604. $Controller->invokeAction();
  605. }
  606. /**
  607. * test invoking controller methods.
  608. *
  609. * @return void
  610. */
  611. public function testInvokeActionReturnValue(): void
  612. {
  613. $url = new ServerRequest([
  614. 'url' => 'test/returner/',
  615. 'params' => [
  616. 'controller' => 'Test',
  617. 'action' => 'returner',
  618. 'pass' => [],
  619. ],
  620. ]);
  621. $response = new Response();
  622. $Controller = new TestController($url, $response);
  623. $result = $Controller->invokeAction();
  624. $this->assertSame('I am from the controller.', (string)$result);
  625. $this->assertSame('I am from the controller.', (string)$Controller->getResponse());
  626. }
  627. /**
  628. * test invoking controller methods with passed params
  629. *
  630. * @return void
  631. */
  632. public function testInvokeActionWithPassedParams(): void
  633. {
  634. $url = new ServerRequest([
  635. 'url' => 'test/index/1/2',
  636. 'params' => [
  637. 'controller' => 'Test',
  638. 'action' => 'index',
  639. 'pass' => ['param1' => '1', 'param2' => '2'],
  640. ],
  641. ]);
  642. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  643. $Controller = new TestController($url, $response);
  644. $result = $Controller->invokeAction();
  645. $this->assertEquals(
  646. ['testId' => '1', 'test2Id' => '2'],
  647. $Controller->getRequest()->getData()
  648. );
  649. }
  650. /**
  651. * test invalid return value from action method.
  652. *
  653. * @return void
  654. */
  655. public function testInvokeActionException()
  656. {
  657. $this->expectException(\UnexpectedValueException::class);
  658. $this->expectExceptionMessage(
  659. 'Controller actions can only return ResponseInterface instance or null. '
  660. . 'Got string instead.'
  661. );
  662. $url = new ServerRequest([
  663. 'url' => 'test/willCauseException',
  664. 'params' => [
  665. 'controller' => 'Test',
  666. 'action' => 'willCauseException',
  667. 'pass' => [],
  668. ],
  669. ]);
  670. $response = $this->getMockBuilder(Response::class)->getMock();
  671. $Controller = new TestController($url, $response);
  672. $Controller->invokeAction();
  673. }
  674. /**
  675. * test that a classes namespace is used in the viewPath.
  676. *
  677. * @return void
  678. */
  679. public function testViewPathConventions(): void
  680. {
  681. $request = new ServerRequest([
  682. 'url' => 'admin/posts',
  683. 'params' => ['prefix' => 'admin'],
  684. ]);
  685. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  686. $Controller = new \TestApp\Controller\Admin\PostsController($request, $response);
  687. $Controller->getEventManager()->on('Controller.beforeRender', function (EventInterface $e) {
  688. return $e->getSubject()->getResponse();
  689. });
  690. $Controller->render();
  691. $this->assertSame('Admin' . DS . 'Posts', $Controller->viewBuilder()->getTemplatePath());
  692. $request = $request->withParam('prefix', 'admin/super');
  693. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  694. $Controller = new \TestApp\Controller\Admin\PostsController($request, $response);
  695. $Controller->getEventManager()->on('Controller.beforeRender', function (EventInterface $e) {
  696. return $e->getSubject()->getResponse();
  697. });
  698. $Controller->render();
  699. $this->assertSame('Admin' . DS . 'Super' . DS . 'Posts', $Controller->viewBuilder()->getTemplatePath());
  700. $request = new ServerRequest([
  701. 'url' => 'pages/home',
  702. 'params' => [
  703. 'prefix' => false,
  704. ],
  705. ]);
  706. $Controller = new \TestApp\Controller\PagesController($request, $response);
  707. $Controller->getEventManager()->on('Controller.beforeRender', function (EventInterface $e) {
  708. return $e->getSubject()->getResponse();
  709. });
  710. $Controller->render();
  711. $this->assertSame('Pages', $Controller->viewBuilder()->getTemplatePath());
  712. }
  713. /**
  714. * Test the components() method.
  715. *
  716. * @return void
  717. */
  718. public function testComponents(): void
  719. {
  720. $request = new ServerRequest(['url' => '/']);
  721. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  722. $controller = new TestController($request, $response);
  723. $this->assertInstanceOf('Cake\Controller\ComponentRegistry', $controller->components());
  724. $result = $controller->components();
  725. $this->assertSame($result, $controller->components());
  726. }
  727. /**
  728. * Test the components property errors
  729. *
  730. * @return void
  731. */
  732. public function testComponentsPropertyError(): void
  733. {
  734. $this->expectException(Warning::class);
  735. $request = new ServerRequest(['url' => '/']);
  736. $response = new Response();
  737. $controller = new TestController($request, $response);
  738. $controller->components = ['Flash'];
  739. }
  740. /**
  741. * Test the helpers property errors
  742. *
  743. * @return void
  744. */
  745. public function testHelpersPropertyError(): void
  746. {
  747. $this->expectException(Warning::class);
  748. $request = new ServerRequest(['url' => '/']);
  749. $response = new Response();
  750. $controller = new TestController($request, $response);
  751. $controller->helpers = ['Flash'];
  752. }
  753. /**
  754. * Test the components() method with the custom ObjectRegistry.
  755. *
  756. * @return void
  757. */
  758. public function testComponentsWithCustomRegistry(): void
  759. {
  760. $request = new ServerRequest(['url' => '/']);
  761. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  762. $componentRegistry = $this->getMockBuilder('Cake\Controller\ComponentRegistry')
  763. ->setMethods(['offsetGet'])
  764. ->getMock();
  765. $controller = new TestController($request, $response, null, null, $componentRegistry);
  766. $this->assertInstanceOf(get_class($componentRegistry), $controller->components());
  767. $result = $controller->components();
  768. $this->assertSame($result, $controller->components());
  769. }
  770. /**
  771. * Test adding a component
  772. *
  773. * @return void
  774. */
  775. public function testLoadComponent(): void
  776. {
  777. $request = new ServerRequest(['url' => '/']);
  778. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  779. $controller = new TestController($request, $response);
  780. $result = $controller->loadComponent('Paginator');
  781. $this->assertInstanceOf('Cake\Controller\Component\PaginatorComponent', $result);
  782. $this->assertSame($result, $controller->Paginator);
  783. $registry = $controller->components();
  784. $this->assertTrue(isset($registry->Paginator));
  785. }
  786. /**
  787. * Test adding a component that is a duplicate.
  788. *
  789. * @return void
  790. */
  791. public function testLoadComponentDuplicate(): void
  792. {
  793. $request = new ServerRequest(['url' => '/']);
  794. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  795. $controller = new TestController($request, $response);
  796. $this->assertNotEmpty($controller->loadComponent('Paginator'));
  797. $this->assertNotEmpty($controller->loadComponent('Paginator'));
  798. try {
  799. $controller->loadComponent('Paginator', ['bad' => 'settings']);
  800. $this->fail('No exception');
  801. } catch (\RuntimeException $e) {
  802. $this->assertStringContainsString('The "Paginator" alias has already been loaded', $e->getMessage());
  803. }
  804. }
  805. /**
  806. * Test the isAction method.
  807. *
  808. * @return void
  809. */
  810. public function testIsAction(): void
  811. {
  812. $request = new ServerRequest(['url' => '/']);
  813. $response = $this->getMockBuilder('Cake\Http\Response')->getMock();
  814. $controller = new TestController($request, $response);
  815. $this->assertFalse($controller->isAction('redirect'));
  816. $this->assertFalse($controller->isAction('beforeFilter'));
  817. $this->assertTrue($controller->isAction('index'));
  818. }
  819. /**
  820. * Test that view variables are being set after the beforeRender event gets dispatched
  821. *
  822. * @return void
  823. */
  824. public function testBeforeRenderViewVariables(): void
  825. {
  826. $controller = new PostsController();
  827. $controller->getEventManager()->on('Controller.beforeRender', function (EventInterface $event): void {
  828. /** @var Controller $controller */
  829. $controller = $event->getSubject();
  830. $controller->set('testVariable', 'test');
  831. });
  832. $controller->dispatchEvent('Controller.beforeRender');
  833. $view = $controller->createView();
  834. $this->assertNotEmpty('testVariable', $view->get('testVariable'));
  835. }
  836. /**
  837. * Test that render()'s arguments are available in beforeRender() through view builder.
  838. *
  839. * @return void
  840. */
  841. public function testBeforeRenderTemplateAndLayout()
  842. {
  843. $Controller = new Controller(new ServerRequest(), new Response());
  844. $Controller->getEventManager()->on('Controller.beforeRender', function ($event) {
  845. $this->assertEquals(
  846. '/Element/test_element',
  847. $event->getSubject()->viewBuilder()->getTemplate()
  848. );
  849. $this->assertEquals(
  850. 'default',
  851. $event->getSubject()->viewBuilder()->getLayout()
  852. );
  853. $event->getSubject()->viewBuilder()
  854. ->setTemplatePath('Posts')
  855. ->setTemplate('index');
  856. });
  857. $result = $Controller->render('/Element/test_element', 'default');
  858. $this->assertRegExp('/posts index/', (string)$result);
  859. }
  860. /**
  861. * Test name getter and setter.
  862. *
  863. * @return void
  864. */
  865. public function testName(): void
  866. {
  867. $controller = new PostsController();
  868. $this->assertSame('Posts', $controller->getName());
  869. $this->assertSame($controller, $controller->setName('Articles'));
  870. $this->assertSame('Articles', $controller->getName());
  871. }
  872. /**
  873. * Test plugin getter and setter.
  874. *
  875. * @return void
  876. */
  877. public function testPlugin(): void
  878. {
  879. $controller = new PostsController();
  880. $this->assertNull($controller->getPlugin());
  881. $this->assertSame($controller, $controller->setPlugin('Articles'));
  882. $this->assertSame('Articles', $controller->getPlugin());
  883. }
  884. /**
  885. * Test request getter and setter.
  886. *
  887. * @return void
  888. */
  889. public function testRequest(): void
  890. {
  891. $controller = new PostsController();
  892. $this->assertInstanceOf(ServerRequest::class, $controller->getRequest());
  893. $request = new ServerRequest([
  894. 'params' => [
  895. 'plugin' => 'Posts',
  896. 'pass' => [
  897. 'foo',
  898. 'bar',
  899. ],
  900. ],
  901. ]);
  902. $this->assertSame($controller, $controller->setRequest($request));
  903. $this->assertSame($request, $controller->getRequest());
  904. $this->assertSame('Posts', $controller->getRequest()->getParam('plugin'));
  905. $this->assertEquals(['foo', 'bar'], $controller->getRequest()->getParam('pass'));
  906. }
  907. /**
  908. * Test response getter and setter.
  909. *
  910. * @return void
  911. */
  912. public function testResponse(): void
  913. {
  914. $controller = new PostsController();
  915. $this->assertInstanceOf(Response::class, $controller->getResponse());
  916. $response = new Response();
  917. $this->assertSame($controller, $controller->setResponse($response));
  918. $this->assertSame($response, $controller->getResponse());
  919. }
  920. /**
  921. * Test autoRender getter and setter.
  922. *
  923. * @return void
  924. */
  925. public function testAutoRender(): void
  926. {
  927. $controller = new PostsController();
  928. $this->assertTrue($controller->isAutoRenderEnabled());
  929. $this->assertSame($controller, $controller->disableAutoRender());
  930. $this->assertFalse($controller->isAutoRenderEnabled());
  931. $this->assertSame($controller, $controller->enableAutoRender());
  932. $this->assertTrue($controller->isAutoRenderEnabled());
  933. }
  934. }