* @author Manuel Raynaud * @author Benjamin Perche */ abstract class BaseController { use ContainerAwareTrait; const EMPTY_FORM_NAME = "thelia.empty"; protected $tokenProvider; protected $currentRouter; protected $translator; protected $templateHelper; protected $adminResources; /** @var bool Fallback on default template when setting the templateDefinition */ protected $useFallbackTemplate = true; /** * Return an empty response (after an ajax request, for example) * @param int $status * @return \Thelia\Core\HttpFoundation\Response */ protected function nullResponse($status = 200) { return new Response(null, $status); } /** * @param $jsonData * @param int $status * @return Response Return a JSON response */ protected function jsonResponse($jsonData, $status = 200) { return new Response($jsonData, $status, array('content-type' => 'application/json')); } /** * @param $pdf * @param $fileName * @param int $status * @param bool $browser * @return \Symfony\Component\HttpFoundation\Response */ protected function pdfResponse($pdf, $fileName, $status = 200, $browser = false) { return Response::create( $pdf, $status, array( 'Content-type' => "application/pdf", 'Content-Disposition' =>sprintf( '%s; filename=%s.pdf', \boolval($browser) === false ? 'attachment' : 'inline', $fileName ) ) ); } /** * Dispatch a Thelia event * * @param string $eventName a TheliaEvent name, as defined in TheliaEvents class * @param ActionEvent $event the action event, or null (a DefaultActionEvent will be dispatched) */ protected function dispatch($eventName, ActionEvent $event = null) { if ($event == null) { $event = new DefaultActionEvent(); } $this->getDispatcher()->dispatch($eventName, $event); } /** * Return the event dispatcher, * * @return \Symfony\Component\EventDispatcher\EventDispatcher */ public function getDispatcher() { return $this->container->get('event_dispatcher'); } /** * return the Translator * * @return Translator */ public function getTranslator() { if (null === $this->translator) { $this->translator = $this->container->get('thelia.translator'); } return $this->translator; } /** * Return the parser context, * * @return ParserContext */ protected function getParserContext() { return $this->container->get('thelia.parser.context'); } /** * Return the security context, by default in admin mode. * * @return \Thelia\Core\Security\SecurityContext */ protected function getSecurityContext() { return $this->container->get('thelia.securityContext'); } /** * @return \Thelia\Core\HttpFoundation\Request */ protected function getRequest() { return $this->container->get('request_stack')->getCurrentRequest(); } /** * Returns the session from the current request * * @return \Thelia\Core\HttpFoundation\Session\Session */ protected function getSession() { return $this->container->get('request_stack')->getCurrentRequest()->getSession(); } /** * @return \Thelia\Tools\TokenProvider */ protected function getTokenProvider() { if (null === $this->tokenProvider) { $this->tokenProvider = $this->container->get("thelia.token_provider"); } return $this->tokenProvider; } /** * @return \Thelia\Core\Template\TemplateHelperInterface */ protected function getTemplateHelper() { if (null === $this->templateHelper) { $this->templateHelper = $this->container->get("thelia.template_helper"); } return $this->templateHelper; } /** * @since 2.3 * @return \Thelia\Core\Security\Resource\AdminResources */ protected function getAdminResources() { if (null === $this->adminResources) { $this->adminResources = $this->container->get("thelia.admin.resources"); } return $this->adminResources; } /** * Get all errors that occurred in a form * * @param \Symfony\Component\Form\Form $form * @return string the error string */ protected function getErrorMessages(Form $form) { return $this->getTheliaFormValidator()->getErrorMessages($form); } /** * Validate a BaseForm * * @param BaseForm $aBaseForm the form * @param string $expectedMethod the expected method, POST or GET, or null for any of them * @throws FormValidationException is the form contains error, or the method is not the right one * @return \Symfony\Component\Form\Form Form the symfony form object */ protected function validateForm(BaseForm $aBaseForm, $expectedMethod = null) { $form = $this->getTheliaFormValidator()->validateForm($aBaseForm, $expectedMethod); // At this point, the form is valid (no exception was thrown). Remove it from the error context. $this->getParserContext()->clearForm($aBaseForm); return $form; } /** * @return \Thelia\Core\Form\TheliaFormValidatorInterface */ protected function getTheliaFormValidator() { return $this->container->get("thelia.form_validator"); } /** * @param int $order_id * @param string $fileName * @param bool $checkOrderStatus * @param bool $checkAdminUser * @return \Symfony\Component\HttpFoundation\Response */ protected function generateOrderPdf($order_id, $fileName, $checkOrderStatus = true, $checkAdminUser = true, $browser = false) { $order = OrderQuery::create()->findPk($order_id); // check if the order has the paid status if ($checkAdminUser && !$this->getSecurityContext()->hasAdminUser()) { if ($checkOrderStatus && !$order->isPaid(false)) { throw new NotFoundHttpException(); } } $html = $this->renderRaw( $fileName, array( 'order_id' => $order_id ), $this->getTemplateHelper()->getActivePdfTemplate() ); try { $pdfEvent = new PdfEvent($html); $this->dispatch(TheliaEvents::GENERATE_PDF, $pdfEvent); if ($pdfEvent->hasPdf()) { return $this->pdfResponse($pdfEvent->getPdf(), $order->getRef(), 200, $browser); } } catch (\Exception $e) { Tlog::getInstance()->error( sprintf( 'error during generating invoice pdf for order id : %d with message "%s"', $order_id, $e->getMessage() ) ); } throw new TheliaProcessException( $this->getTranslator()->trans( "We're sorry, this PDF invoice is not available at the moment." ) ); } /** * Search success url in a form if present, in the query string otherwise * * @param BaseForm $form * @return mixed|null|string */ protected function retrieveSuccessUrl(BaseForm $form = null) { return $this->retrieveFormBasedUrl('success_url', $form); } /** * Search error url in a form if present, in the query string otherwise * * @param BaseForm $form * @return mixed|null|string */ protected function retrieveErrorUrl(BaseForm $form = null) { return $this->retrieveFormBasedUrl('error_url', $form); } /** * Search url in a form parameter, or in a request parameter. * * @param string $parameterName the form parameter name, or request parameter name. * @param BaseForm $form the form * @return mixed|null|string */ protected function retrieveFormBasedUrl($parameterName, BaseForm $form = null) { $url = null; if ($form != null) { $url = $form->getFormDefinedUrl($parameterName); } else { $url = $this->container->get('request_stack')->getCurrentRequest()->get($parameterName); } return $url; } /** * @param $routeId * @param array $urlParameters * @param array $routeParameters * @param int $referenceType * @return string */ protected function retrieveUrlFromRouteId( $routeId, array $urlParameters = [], array $routeParameters = [], $referenceType = Router::ABSOLUTE_PATH ) { return URL::getInstance()->absoluteUrl( $this->getRoute( $routeId, $routeParameters, $referenceType ), $urlParameters ); } /** * * create an instance of RedirectResponse * * @param $url * @param int $status * @return \Symfony\Component\HttpFoundation\Response */ protected function generateRedirect($url, $status = 302) { return RedirectResponse::create($url, $status); } /** * create an instance of RedirectReponse if a success url is present, return null otherwise * * @param BaseForm $form * @return null|\Symfony\Component\HttpFoundation\Response */ protected function generateSuccessRedirect(BaseForm $form = null) { if (null !== $url = $this->retrieveSuccessUrl($form)) { return $this->generateRedirect($url); } return null; } /** * create an instance of RedirectReponse if a success url is present, return null otherwise * * @param BaseForm $form * @return null|\Symfony\Component\HttpFoundation\Response */ protected function generateErrorRedirect(BaseForm $form = null) { if (null !== $url = $this->retrieveErrorUrl($form)) { return $this->generateRedirect($url); } return null; } /** * * create an instance of RedriectResponse for a given route id. * * @param $routeId * @param array $urlParameters * @param array $routeParameters * @param int $referenceType * @return \Symfony\Component\HttpFoundation\Response */ protected function generateRedirectFromRoute( $routeId, array $urlParameters = [], array $routeParameters = [], $referenceType = Router::ABSOLUTE_PATH ) { return $this->generateRedirect( $this->retrieveUrlFromRouteId($routeId, $urlParameters, $routeParameters, $referenceType) ); } /** * Return the route path defined for the givent route ID * * @param string $routeId a route ID, as defines in Config/Resources/routing/admin.xml * @param mixed $parameters An array of parameters * @param int $referenceType The type of reference to be generated (one of the constants) * * @throws RouteNotFoundException If the named route doesn't exist * @throws MissingMandatoryParametersException When some parameters are missing that are mandatory for the route * @throws InvalidParameterException When a parameter value for a placeholder is not correct because * it does not match the requirement * @throws \InvalidArgumentException When the router doesn't exist * @return string The generated URL * * @see \Thelia\Controller\BaseController::getRouteFromRouter() */ protected function getRoute($routeId, $parameters = array(), $referenceType = Router::ABSOLUTE_URL) { return $this->getRouteFromRouter( $this->getCurrentRouter(), $routeId, $parameters, $referenceType ); } /** * Get a route path from the route id. * * @param string $routerName Router name * @param string $routeId The name of the route * @param mixed $parameters An array of parameters * @param int $referenceType The type of reference to be generated (one of the constants) * * @throws RouteNotFoundException If the named route doesn't exist * @throws MissingMandatoryParametersException When some parameters are missing that are mandatory for the route * @throws InvalidParameterException When a parameter value for a placeholder is not correct because * it does not match the requirement * @throws \InvalidArgumentException When the router doesn't exist * @return string The generated URL */ protected function getRouteFromRouter( $routerName, $routeId, $parameters = array(), $referenceType = Router::ABSOLUTE_URL ) { /** @var Router $router */ $router = $this->getRouter($routerName); if ($router == null) { throw new \InvalidArgumentException(sprintf("Router '%s' does not exists.", $routerName)); } return $router->generate($routeId, $parameters, $referenceType); } /** * @param $routerName * @return Router */ protected function getRouter($routerName) { return $this->container->get($routerName); } /** * Return a 404 error * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException */ protected function pageNotFound() { throw new NotFoundHttpException(); } /** * Check if environment is in debug mode * * @return bool */ protected function isDebug() { return $this->container->getParameter('kernel.debug'); } protected function accessDenied() { throw new AccessDeniedHttpException(); } /** * check if the current http request is a XmlHttpRequest. * * If not, send a */ protected function checkXmlHttpRequest() { if (false === $this->container->get('request_stack')->getCurrentRequest()->isXmlHttpRequest() && false === $this->isDebug()) { $this->accessDenied(); } } /** * * return an instance of \Swift_Mailer with good Transporter configured. * * @return MailerFactory */ public function getMailer() { return $this->container->get('mailer'); } protected function getCurrentRouter() { return $this->currentRouter; } protected function setCurrentRouter($routerId) { $this->currentRouter = $routerId; } /** * @param $name * @param $type * @param array $data * @param array $options * @return BaseForm * * This method builds a thelia form with its name */ public function createForm($name, $type = "form", array $data = array(), array $options = array()) { if (empty($name)) { $name = static::EMPTY_FORM_NAME; } return $this->getTheliaFormFactory()->createForm($name, $type, $data, $options); } /** * @return \Thelia\Core\Form\TheliaFormFactoryInterface */ protected function getTheliaFormFactory() { return $this->container->get("thelia.form_factory"); } /** * @return \Symfony\Component\DependencyInjection\ContainerInterface */ public function getContainer() { return $this->container; } /** * Return controller type * * @return string */ abstract public function getControllerType(); /** * @param null|mixed $template * @return \Thelia\Core\Template\ParserInterface instance parser */ abstract protected function getParser($template = null); /** * Render the given template, and returns the result as an Http Response. * * @param string $templateName the complete template name, with extension * @param array $args the template arguments * @param int $status http code status * @return \Thelia\Core\HttpFoundation\Response */ abstract protected function render($templateName, $args = array(), $status = 200); /** * Render the given template, and returns the result as a string. * * @param string $templateName the complete template name, with extension * @param array $args the template arguments * @param null $templateDir * * @return string */ abstract protected function renderRaw($templateName, $args = array(), $templateDir = null); }