Documenting createAccessDeniedException() method

klaussilveira · klaussilveira · commit 6fd3f93201ec · 2014-01-17T10:51:53.000-02:00
Updating documentation to reflect the changes added in symfony/symfony#9405.
diff --git a/book/security.rst b/book/security.rst
@@ -1072,19 +1072,21 @@ fine-grained enough in certain cases. When necessary, you can easily force
 authorization from inside a controller::
 
     // ...
-    use Symfony\Component\Security\Core\Exception\AccessDeniedException;
 
     public function helloAction($name)
     {
         if (false === $this->get('security.context')->isGranted('ROLE_ADMIN')) {
-            throw new AccessDeniedException();
+            throw $this->createAccessDeniedException('Unable to access this page!');
         }
 
         // ...
     }
 
 .. _book-security-securing-controller-annotations:
 
+The ``createAccessDeniedException()`` method creates a special ``AccessDeniedException``
+object, which ultimately triggers a 403 HTTP response inside Symfony.
+
 Thanks to the SensioFrameworkExtraBundle, you can also secure your controller using annotations::
 
     // ...

Original file line number	Diff line number	Diff line change
`@@ -1072,19 +1072,21 @@ fine-grained enough in certain cases. When necessary, you can easily force`
`1072`	`1072`	`authorization from inside a controller::`
`1073`	`1073`
`1074`	`1074`	`// ...`
`1075`		`- use Symfony\Component\Security\Core\Exception\AccessDeniedException;`
`1076`	`1075`
`1077`	`1076`	`public function helloAction($name)`
`1078`	`1077`	`{`
`1079`	`1078`	`if (false === $this->get('security.context')->isGranted('ROLE_ADMIN')) {`
`1080`		`- throw new AccessDeniedException();`
	`1079`	`+ throw $this->createAccessDeniedException('Unable to access this page!');`
`1081`	`1080`	`}`
`1082`	`1081`
`1083`	`1082`	`// ...`
`1084`	`1083`	`}`
`1085`	`1084`
`1086`	`1085`	`.. _book-security-securing-controller-annotations:`
`1087`	`1086`
	`1087`	+The ``createAccessDeniedException()`` method creates a special ``AccessDeniedException``
	`1088`	`+object, which ultimately triggers a 403 HTTP response inside Symfony.`
	`1089`	`+`
`1088`	`1090`	`Thanks to the SensioFrameworkExtraBundle, you can also secure your controller using annotations::`
`1089`	`1091`
`1090`	`1092`	`// ...`