ControllerTest.php 36 KB

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