symfony · weaverryan · Mar 15, 2015 · Mar 15, 2015 · Mar 15, 2015 · Mar 15, 2015
diff --git a/src/Symfony/Bundle/FrameworkBundle/Bundle/Bundle.php b/src/Symfony/Bundle/FrameworkBundle/Bundle/Bundle.php
@@ -0,0 +1,33 @@
+<?php
+
+namespace Symfony\Bundle\FrameworkBundle\Bundle;
+
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\HttpKernel\Bundle\Bundle as BaseBundle;
+
+class Bundle extends BaseBundle
+{
+    private $twigPaths = array();
+
+    protected function addTwigPath($templateDirectory, $namespace)
+    {
+        $this->twigPaths[$namespace] = $templateDirectory;
+    }
+
+    public function build(ContainerBuilder $container)
+    {
+        foreach ($this->twigPaths as $namespace => $directory) {
+            if (!is_dir($directory)) {
+                throw new \InvalidArgumentException(sprintf(
+                    'Directory "%s" does not exist, so it cannot be added as a Twig path', $directory
+                ));
+            }
+
+            $container->prependExtensionConfig('twig', array(
+                'paths' => array($directory => $namespace)
+            ));
+        }
+    }
+
+
+}
diff --git a/src/Symfony/Bundle/FrameworkBundle/Templating/Loader/TemplateLocator.php b/src/Symfony/Bundle/FrameworkBundle/Templating/Loader/TemplateLocator.php
@@ -62,9 +62,13 @@ protected function getCacheKey($template)
      *
      * @throws \InvalidArgumentException When the template is not an instance of TemplateReferenceInterface
      * @throws \InvalidArgumentException When the template file can not be found
+     *
+     * @deprecated since version 2.8, to be removed in 3.0.
      */
     public function locate($template, $currentPath = null, $first = true)
     {
+        trigger_error('The '.__METHOD__.' is deprecated since version 2.8 and will be removed in 3.0.', E_USER_DEPRECATED);
+
         if (!$template instanceof TemplateReferenceInterface) {
             throw new \InvalidArgumentException('The template must be an instance of TemplateReferenceInterface.');
         }

diff --git a/src/Symfony/Bundle/FrameworkBundle/Templating/TemplateNameParser.php b/src/Symfony/Bundle/FrameworkBundle/Templating/TemplateNameParser.php
@@ -20,6 +20,7 @@
  * "bundle:section:template.format.engine" to TemplateReferenceInterface
  * instances.
  *
+ * @deprecated since version 2.8, to be removed in 3.0
  * @author Fabien Potencier <fabien@symfony.com>
  */
 class TemplateNameParser extends BaseTemplateNameParser
@@ -48,6 +49,8 @@ public function parse($name)
             return $this->cache[$name];
         }
 
+        trigger_error('The "bundle:section:template.format.engine" syntax is deprecated since version 2.8 and will be removed in 3.0.', E_USER_DEPRECATED);
+
         // normalize name
         $name = str_replace(':/', ':', preg_replace('#/{2,}#', '/', strtr($name, '\\', '/')));
 

diff --git a/src/Symfony/Bundle/TwigBundle/DependencyInjection/TwigExtension.php b/src/Symfony/Bundle/TwigBundle/DependencyInjection/TwigExtension.php
@@ -64,11 +64,16 @@ public function load(array $configs, ContainerBuilder $container)
             if (!$namespace) {
                 $twigFilesystemLoaderDefinition->addMethodCall('addPath', array($path));
             } else {
+                // register the "override" path
+                if (is_dir($dir = $container->getParameter('kernel.root_dir').'/Resources/'.$namespace.'/views')) {
+                    $twigFilesystemLoaderDefinition->addMethodCall('addPath', array($dir, $namespace));
+                }
+
                 $twigFilesystemLoaderDefinition->addMethodCall('addPath', array($path, $namespace));
             }
         }
 
-        // register bundles as Twig namespaces
+        // register bundles as Twig namespaces (deprecated)
         foreach ($container->getParameter('kernel.bundles') as $bundle => $class) {
             if (is_dir($dir = $container->getParameter('kernel.root_dir').'/Resources/'.$bundle.'/views')) {
                 $this->addTwigPath($twigFilesystemLoaderDefinition, $dir, $bundle);
@@ -120,6 +125,9 @@ public function load(array $configs, ContainerBuilder $container)
         ));
     }
 
+    /**
+     * @deprecated The automatic @AcmeDemo (for AcmeDemoBundle) Twig path was deprecated in 2.8 and will be removed in 3.0
+     */
     private function addTwigPath($twigFilesystemLoaderDefinition, $dir, $bundle)
     {
         $name = $bundle;

diff --git a/src/Symfony/Bundle/TwigBundle/Loader/FilesystemLoader.php b/src/Symfony/Bundle/TwigBundle/Loader/FilesystemLoader.php
@@ -78,7 +78,7 @@ protected function findTemplate($template)
         } catch (\Twig_Error_Loader $e) {
             $previous = $e;
 
-            // for BC
+            // deprecated - supports the bundle:directory:filename.format.engine format
             try {
                 $template = $this->parser->parse($template);
                 $file = $this->locator->locate($template);