ControllerTest.php 35 KB

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