ControllerTrait
trait ControllerTrait
Common features needed in controllers.
Properties
| ContainerInterface | $container |
Methods
| bool | has(string $id) Returns true if the service id is defined. | |
| object | get(string $id) Gets a container service by its id. | |
| string | generateUrl(string $route, array $parameters = array(), int $referenceType = UrlGeneratorInterface::ABSOLUTE_PATH) Generates a URL from the given parameters. | |
| Response | forward(string $controller, array $path = array(), array $query = array()) Forwards the request to another controller. | |
| RedirectResponse | redirect(string $url, int $status = 302) Returns a RedirectResponse to the given URL. | |
| RedirectResponse | redirectToRoute(string $route, array $parameters = array(), int $status = 302) Returns a RedirectResponse to the given route with the given parameters. | |
| JsonResponse | json($data, int $status = 200, array $headers = array(), array $context = array()) Returns a JsonResponse that uses the serializer component if enabled, or json_encode. | |
| BinaryFileResponse | file($file, string $fileName = null, string $disposition = ResponseHeaderBag::DISPOSITION_ATTACHMENT) Returns a BinaryFileResponse object with original or customized file name and disposition header. | |
| addFlash(string $type, string $message) Adds a flash message to the current session for type. | ||
| bool | isGranted($attributes, $subject = null) Checks if the attributes are granted against the current authentication token and optionally supplied subject. | |
| denyAccessUnlessGranted($attributes, $subject = null, string $message = 'Access Denied.') Throws an exception unless the attributes are granted against the current authentication token and optionally supplied subject. | ||
| string | renderView(string $view, array $parameters = array()) Returns a rendered view. | |
| Response | render(string $view, array $parameters = array(), Response $response = null) Renders a view. | |
| StreamedResponse | stream(string $view, array $parameters = array(), StreamedResponse $response = null) Streams a view. | |
| NotFoundHttpException | createNotFoundException(string $message = 'Not Found', Exception $previous = null) Returns a NotFoundHttpException. | |
| AccessDeniedException | createAccessDeniedException(string $message = 'Access Denied.', Exception $previous = null) Returns an AccessDeniedException. | |
| FormInterface | createForm(string $type, $data = null, array $options = array()) Creates and returns a Form instance from the type of the form. | |
| FormBuilderInterface | createFormBuilder($data = null, array $options = array()) Creates and returns a form builder instance. | |
| ManagerRegistry | getDoctrine() Shortcut to return the Doctrine Registry service. | |
| mixed | getUser() Get a user from the Security Token Storage. | |
| bool | isCsrfTokenValid(string $id, string|null $token) Checks the validity of a CSRF token. | |
| dispatchMessage(object $message) Dispatches a message to the bus. |
Details
protected bool has(string $id)
Returns true if the service id is defined.
Parameters
| string | $id |
Return Value
| bool |
protected object get(string $id)
Gets a container service by its id.
Parameters
| string | $id |
Return Value
| object | The service |
protected string generateUrl(string $route, array $parameters = array(), int $referenceType = UrlGeneratorInterface::ABSOLUTE_PATH)
Generates a URL from the given parameters.
Parameters
| string | $route | |
| array | $parameters | |
| int | $referenceType |
Return Value
| string |
See also
| UrlGeneratorInterface |
protected Response forward(string $controller, array $path = array(), array $query = array())
Forwards the request to another controller.
Parameters
| string | $controller | |
| array | $path | |
| array | $query |
Return Value
| Response |
protected RedirectResponse redirect(string $url, int $status = 302)
Returns a RedirectResponse to the given URL.
Parameters
| string | $url | |
| int | $status |
Return Value
| RedirectResponse |
protected RedirectResponse redirectToRoute(string $route, array $parameters = array(), int $status = 302)
Returns a RedirectResponse to the given route with the given parameters.
Parameters
| string | $route | |
| array | $parameters | |
| int | $status |
Return Value
| RedirectResponse |
protected JsonResponse json($data, int $status = 200, array $headers = array(), array $context = array())
Returns a JsonResponse that uses the serializer component if enabled, or json_encode.
Parameters
| $data | ||
| int | $status | |
| array | $headers | |
| array | $context |
Return Value
| JsonResponse |
protected BinaryFileResponse file($file, string $fileName = null, string $disposition = ResponseHeaderBag::DISPOSITION_ATTACHMENT)
Returns a BinaryFileResponse object with original or customized file name and disposition header.
Parameters
| $file | ||
| string | $fileName | |
| string | $disposition |
Return Value
| BinaryFileResponse |
protected addFlash(string $type, string $message)
Adds a flash message to the current session for type.
Parameters
| string | $type | |
| string | $message |
Exceptions
| LogicException |
protected bool isGranted($attributes, $subject = null)
Checks if the attributes are granted against the current authentication token and optionally supplied subject.
Parameters
| $attributes | ||
| $subject |
Return Value
| bool |
Exceptions
| LogicException |
protected denyAccessUnlessGranted($attributes, $subject = null, string $message = 'Access Denied.')
Throws an exception unless the attributes are granted against the current authentication token and optionally supplied subject.
Parameters
| $attributes | ||
| $subject | ||
| string | $message |
Exceptions
| AccessDeniedException |
protected string renderView(string $view, array $parameters = array())
Returns a rendered view.
Parameters
| string | $view | |
| array | $parameters |
Return Value
| string |
protected Response render(string $view, array $parameters = array(), Response $response = null)
Renders a view.
Parameters
| string | $view | |
| array | $parameters | |
| Response | $response |
Return Value
| Response |
protected StreamedResponse stream(string $view, array $parameters = array(), StreamedResponse $response = null)
Streams a view.
Parameters
| string | $view | |
| array | $parameters | |
| StreamedResponse | $response |
Return Value
| StreamedResponse |
protected NotFoundHttpException createNotFoundException(string $message = 'Not Found', Exception $previous = null)
Returns a NotFoundHttpException.
This will result in a 404 response code. Usage example:
throw $this->createNotFoundException('Page not found!');
Parameters
| string | $message | |
| Exception | $previous |
Return Value
| NotFoundHttpException |
protected AccessDeniedException createAccessDeniedException(string $message = 'Access Denied.', Exception $previous = null)
Returns an AccessDeniedException.
This will result in a 403 response code. Usage example:
throw $this->createAccessDeniedException('Unable to access this page!');
Parameters
| string | $message | |
| Exception | $previous |
Return Value
| AccessDeniedException |
Exceptions
| LogicException | If the Security component is not available |
protected FormInterface createForm(string $type, $data = null, array $options = array())
Creates and returns a Form instance from the type of the form.
Parameters
| string | $type | |
| $data | ||
| array | $options |
Return Value
| FormInterface |
protected FormBuilderInterface createFormBuilder($data = null, array $options = array())
Creates and returns a form builder instance.
Parameters
| $data | ||
| array | $options |
Return Value
| FormBuilderInterface |
protected ManagerRegistry getDoctrine()
Shortcut to return the Doctrine Registry service.
Return Value
| ManagerRegistry |
Exceptions
| LogicException | If DoctrineBundle is not available |
protected mixed getUser()
Get a user from the Security Token Storage.
Return Value
| mixed |
Exceptions
| LogicException | If SecurityBundle is not available |
See also
| TokenInterface::getUser() |
protected bool isCsrfTokenValid(string $id, string|null $token)
Checks the validity of a CSRF token.
Parameters
| string | $id | The id used when generating the token |
| string|null | $token | The actual token sent with the request that should be validated |
Return Value
| bool |
protected dispatchMessage(object $message)
Dispatches a message to the bus.
Parameters
| object | $message | The message to dispatch |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Bundle/FrameworkBundle/Controller/ControllerTrait.html