[TwigBundle] adding two global variables : environment & debug + some doc blocks

Use case : {% if app.environment == 'prod' %} {# e.g google analytics scripts #} {% endif %}

Author: benjamindulau

src/Symfony/Bundle/TwigBundle/GlobalVariables.php

@@ -27,13 +27,24 @@ public function __construct(ContainerInterface $container)
  $this->container = $container;
  }
 
+ /**
+ * Returns security context service
+ * 
+ * @return Symfony\Component\Security\Core\SecurityContext|void The security context
+ */
  public function getSecurity()
  {
  if ($this->container->has('security.context')) {
  return $this->container->get('security.context');
  }
  }
 
+ /**
+ * Returns current user
+ * 
+ * @return mixed|void
+ * @see Symfony\Component\Security\Core\Authentication\Token\TokenInterface::getUser()
+ */
  public function getUser()
  {
  if (!$security = $this->getSecurity()) {
@@ -52,17 +63,51 @@ public function getUser()
  return $user;
  }
 
+ /**
+ * Returns security context service
+ * 
+ * @return Symfony\Component\HttpFoundation\Request|void The http request object
+ */
  public function getRequest()
  {
  if ($this->container->has('request') && $request = $this->container->get('request')) {
  return $request;
  }
  }
 
+ /**
+ * Returns security context service
+ * 
+ * @return Symfony\Component\HttpFoundation\Session|void The session
+ */
  public function getSession()
  {
  if ($request = $this->getRequest()) {
  return $request->getSession();
  }
  }
+ 
+ /**
+ * Returns current app environment
+ * 
+ * @return string|void The current environment string (e.g 'dev')
+ */
+ public function getEnvironment()
+ {
+ if ($this->container->hasParameter('kernel.environment')) {
+ return $this->container->getParameter('kernel.environment');
+ }
+ }
+ 
+ /**
+ * Returns current app debug mode
+ * 
+ * @return boolean|void The current debug mode
+ */
+ public function getDebug()
+ {
+ if ($this->container->hasParameter('kernel.debug')) {
+ return (bool)$this->container->getParameter('kernel.debug');
+ }
+ }
 }