usedConsoleBackup = Console::isConsole(); $this->reset(); } /** * Restore params */ protected function tearDown() { Console::overrideIsConsole($this->usedConsoleBackup); } /** * Get the trace error flag * @return bool */ public function getTraceError() { return $this->traceError; } /** * Set the trace error flag * @param bool $traceError * @return AbstractControllerTestCase */ public function setTraceError($traceError) { $this->traceError = $traceError; return $this; } /** * Get the usage of the console router or not * @return bool $boolean */ public function getUseConsoleRequest() { return $this->useConsoleRequest; } /** * Set the usage of the console router or not * @param bool $boolean * @return AbstractControllerTestCase */ public function setUseConsoleRequest($boolean) { $this->useConsoleRequest = (bool) $boolean; return $this; } /** * Get the application config * @return array the application config */ public function getApplicationConfig() { return $this->applicationConfig; } /** * Set the application config * @param array $applicationConfig * @return AbstractControllerTestCase * @throws LogicException */ public function setApplicationConfig($applicationConfig) { if (null !== $this->application && null !== $this->applicationConfig) { throw new LogicException( 'Application config can not be set, the application is already built' ); } // do not cache module config on testing environment if (isset($applicationConfig['module_listener_options']['config_cache_enabled'])) { $applicationConfig['module_listener_options']['config_cache_enabled'] = false; } $this->applicationConfig = $applicationConfig; return $this; } /** * Get the application object * @return \Zend\Mvc\ApplicationInterface */ public function getApplication() { if ($this->application) { return $this->application; } $appConfig = $this->applicationConfig; Console::overrideIsConsole($this->getUseConsoleRequest()); $this->application = Application::init($appConfig); $events = $this->application->getEventManager(); $events->detach($this->application->getServiceManager()->get('SendResponseListener')); return $this->application; } /** * Get the service manager of the application object * @return \Zend\ServiceManager\ServiceManager */ public function getApplicationServiceLocator() { return $this->getApplication()->getServiceManager(); } /** * Get the application request object * @return \Zend\Stdlib\RequestInterface */ public function getRequest() { return $this->getApplication()->getRequest(); } /** * Get the application response object * @return ResponseInterface */ public function getResponse() { return $this->getApplication()->getMvcEvent()->getResponse(); } /** * Set the request URL * * @param string $url * @param string|null $method * @param array|null $params * @return AbstractControllerTestCase */ public function url($url, $method = HttpRequest::METHOD_GET, $params = array()) { $request = $this->getRequest(); if ($this->useConsoleRequest) { preg_match_all('/(--\S+[= ]"\S*\s*\S*")|(--\S+=\S+|--\S+\s\S+|\S+)/', $url, $matches); $params = str_replace(array(' "', '"'), array('=', ''), $matches[0]); $request->params()->exchangeArray($params); return $this; } $query = $request->getQuery()->toArray(); $post = $request->getPost()->toArray(); $uri = new HttpUri($url); $queryString = $uri->getQuery(); if ($queryString) { parse_str($queryString, $query); } if ($method == HttpRequest::METHOD_POST) { if (count($params) != 0) { $post = $params; } } elseif ($method == HttpRequest::METHOD_GET) { $query = array_merge($query, $params); } elseif ($method == HttpRequest::METHOD_PUT) { if (count($params) != 0) { array_walk($params, function (&$item, $key) { $item = $key . '=' . $item; } ); $content = implode('&', $params); $request->setContent($content); } } elseif ($params) { trigger_error( 'Additional params is only supported by GET, POST and PUT HTTP method', E_USER_NOTICE ); } $request->setMethod($method); $request->setQuery(new Parameters($query)); $request->setPost(new Parameters($post)); $request->setUri($uri); $request->setRequestUri($uri->getPath()); return $this; } /** * Dispatch the MVC with an URL * Accept a HTTP (simulate a customer action) or console route. * * The URL provided set the request URI in the request object. * * @param string $url * @param string|null $method * @param array|null $params * @throws \Exception */ public function dispatch($url, $method = null, $params = array()) { if ( !isset($method) && $this->getRequest() instanceof HttpRequest && $requestMethod = $this->getRequest()->getMethod() ) { $method = $requestMethod; } elseif (!isset($method)) { $method = HttpRequest::METHOD_GET; } $this->url($url, $method, $params); $this->getApplication()->run(); if (true !== $this->traceError) { return; } $exception = $this->getApplication()->getMvcEvent()->getParam('exception'); if ($exception instanceof \Exception) { throw $exception; } } /** * Reset the request * * @return AbstractControllerTestCase */ public function reset() { // force to re-create all components $this->application = null; // reset server datas $_SESSION = array(); $_GET = array(); $_POST = array(); $_COOKIE = array(); // reset singleton StaticEventManager::resetInstance(); return $this; } /** * Trigger an application event * * @param string $eventName * @return \Zend\EventManager\ResponseCollection */ public function triggerApplicationEvent($eventName) { $events = $this->getApplication()->getEventManager(); $event = $this->getApplication()->getMvcEvent(); if ($eventName != MvcEvent::EVENT_ROUTE && $eventName != MvcEvent::EVENT_DISPATCH) { return $events->trigger($eventName, $event); } $shortCircuit = function ($r) use ($event) { if ($r instanceof ResponseInterface) { return true; } if ($event->getError()) { return true; } return false; }; return $events->trigger($eventName, $event, $shortCircuit); } /** * Assert modules were loaded with the module manager * * @param array $modules */ public function assertModulesLoaded(array $modules) { $moduleManager = $this->getApplicationServiceLocator()->get('ModuleManager'); $modulesLoaded = $moduleManager->getModules(); $list = array_diff($modules, $modulesLoaded); if ($list) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Several modules are not loaded "%s"', implode(', ', $list) )); } $this->assertEquals(count($list), 0); } /** * Assert modules were not loaded with the module manager * * @param array $modules */ public function assertNotModulesLoaded(array $modules) { $moduleManager = $this->getApplicationServiceLocator()->get('ModuleManager'); $modulesLoaded = $moduleManager->getModules(); $list = array_intersect($modules, $modulesLoaded); if ($list) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Several modules WAS not loaded "%s"', implode(', ', $list) )); } $this->assertEquals(count($list), 0); } /** * Retrieve the response status code * * @return int */ protected function getResponseStatusCode() { $response = $this->getResponse(); if (!$this->useConsoleRequest) { return $response->getStatusCode(); } $match = $response->getErrorLevel(); if (null === $match) { $match = 0; } return $match; } /** * Assert response status code * * @param int $code */ public function assertResponseStatusCode($code) { if ($this->useConsoleRequest) { if (!in_array($code, array(0, 1))) { throw new PHPUnit_Framework_ExpectationFailedException( 'Console status code assert value must be O (valid) or 1 (error)' ); } } $match = $this->getResponseStatusCode(); if ($code != $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting response code "%s", actual status code is "%s"', $code, $match )); } $this->assertEquals($code, $match); } /** * Assert not response status code * * @param int $code */ public function assertNotResponseStatusCode($code) { if ($this->useConsoleRequest) { if (!in_array($code, array(0, 1))) { throw new PHPUnit_Framework_ExpectationFailedException( 'Console status code assert value must be O (valid) or 1 (error)' ); } } $match = $this->getResponseStatusCode(); if ($code == $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting response code was NOT "%s"', $code )); } $this->assertNotEquals($code, $match); } /** * Assert the application exception and message * * @param $type application exception type * @param $message application exception message */ public function assertApplicationException($type, $message = null) { $exception = $this->getApplication()->getMvcEvent()->getParam('exception'); if (!$exception) { throw new PHPUnit_Framework_ExpectationFailedException( 'Failed asserting application exception, exception not exist' ); } if (true === $this->traceError) { // set exception as null because we know and have assert the exception $this->getApplication()->getMvcEvent()->setParam('exception', null); } $this->setExpectedException($type, $message); throw $exception; } /** * Get the full current controller class name * * @return string */ protected function getControllerFullClassName() { $routeMatch = $this->getApplication()->getMvcEvent()->getRouteMatch(); $controllerIdentifier = $routeMatch->getParam('controller'); $controllerManager = $this->getApplicationServiceLocator()->get('ControllerLoader'); $controllerClass = $controllerManager->get($controllerIdentifier); return get_class($controllerClass); } /** * Assert that the application route match used the given module * * @param string $module */ public function assertModuleName($module) { $controllerClass = $this->getControllerFullClassName(); $match = substr($controllerClass, 0, strpos($controllerClass, '\\')); $match = strtolower($match); $module = strtolower($module); if ($module != $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting module name "%s", actual module name is "%s"', $module, $match )); } $this->assertEquals($module, $match); } /** * Assert that the application route match used NOT the given module * * @param string $module */ public function assertNotModuleName($module) { $controllerClass = $this->getControllerFullClassName(); $match = substr($controllerClass, 0, strpos($controllerClass, '\\')); $match = strtolower($match); $module = strtolower($module); if ($module == $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting module was NOT "%s"', $module )); } $this->assertNotEquals($module, $match); } /** * Assert that the application route match used the given controller class * * @param string $controller */ public function assertControllerClass($controller) { $controllerClass = $this->getControllerFullClassName(); $match = substr($controllerClass, strrpos($controllerClass, '\\')+1); $match = strtolower($match); $controller = strtolower($controller); if ($controller != $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting controller class "%s", actual controller class is "%s"', $controller, $match )); } $this->assertEquals($controller, $match); } /** * Assert that the application route match used NOT the given controller class * * @param string $controller */ public function assertNotControllerClass($controller) { $controllerClass = $this->getControllerFullClassName(); $match = substr($controllerClass, strrpos($controllerClass, '\\')+1); $match = strtolower($match); $controller = strtolower($controller); if ($controller == $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting controller class was NOT "%s"', $controller )); } $this->assertNotEquals($controller, $match); } /** * Assert that the application route match used the given controller name * * @param string $controller */ public function assertControllerName($controller) { $routeMatch = $this->getApplication()->getMvcEvent()->getRouteMatch(); $match = $routeMatch->getParam('controller'); $match = strtolower($match); $controller = strtolower($controller); if ($controller != $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting controller name "%s", actual controller name is "%s"', $controller, $match )); } $this->assertEquals($controller, $match); } /** * Assert that the application route match used NOT the given controller name * * @param string $controller */ public function assertNotControllerName($controller) { $routeMatch = $this->getApplication()->getMvcEvent()->getRouteMatch(); $match = $routeMatch->getParam('controller'); $match = strtolower($match); $controller = strtolower($controller); if ($controller == $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting controller name was NOT "%s"', $controller )); } $this->assertNotEquals($controller, $match); } /** * Assert that the application route match used the given action * * @param string $action */ public function assertActionName($action) { $routeMatch = $this->getApplication()->getMvcEvent()->getRouteMatch(); $match = $routeMatch->getParam('action'); $match = strtolower($match); $action = strtolower($action); if ($action != $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting action name "%s", actual action name is "%s"', $action, $match )); } $this->assertEquals($action, $match); } /** * Assert that the application route match used NOT the given action * * @param string $action */ public function assertNotActionName($action) { $routeMatch = $this->getApplication()->getMvcEvent()->getRouteMatch(); $match = $routeMatch->getParam('action'); $match = strtolower($match); $action = strtolower($action); if ($action == $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting action name was NOT "%s"', $action )); } $this->assertNotEquals($action, $match); } /** * Assert that the application route match used the given route name * * @param string $route */ public function assertMatchedRouteName($route) { $routeMatch = $this->getApplication()->getMvcEvent()->getRouteMatch(); $match = $routeMatch->getMatchedRouteName(); $match = strtolower($match); $route = strtolower($route); if ($route != $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting matched route name was "%s", actual matched route name is "%s"', $route, $match )); } $this->assertEquals($route, $match); } /** * Assert that the application route match used NOT the given route name * * @param string $route */ public function assertNotMatchedRouteName($route) { $routeMatch = $this->getApplication()->getMvcEvent()->getRouteMatch(); $match = $routeMatch->getMatchedRouteName(); $match = strtolower($match); $route = strtolower($route); if ($route == $match) { throw new PHPUnit_Framework_ExpectationFailedException(sprintf( 'Failed asserting route matched was NOT "%s"', $route )); } $this->assertNotEquals($route, $match); } }