symfony · dunglas · Dec 23, 2016 · nicolas-grekas · Feb 11, 2017
diff --git a/src/Symfony/Component/Templating/DelegatingEngine.php b/src/Symfony/Component/Templating/DelegatingEngine.php
@@ -11,10 +11,14 @@

 namespace Symfony\Component\Templating;

+@trigger_error('The '.DelegatingEngine::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * DelegatingEngine selects an engine for a given template.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The DelegatingEngine class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class DelegatingEngine implements EngineInterface, StreamingEngineInterface
 {

diff --git a/src/Symfony/Component/Templating/EngineInterface.php b/src/Symfony/Component/Templating/EngineInterface.php
@@ -11,6 +11,8 @@

 namespace Symfony\Component\Templating;

+@trigger_error('The '.EngineInterface::class.' interface is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * EngineInterface is the interface each engine must implement.
 *
@@ -27,6 +29,8 @@
 * the template.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The EngineInterface interface will be removed in Symfony 4.0. You should use Twig instead.
 */
 interface EngineInterface
 {

diff --git a/src/Symfony/Component/Templating/Helper/Helper.php b/src/Symfony/Component/Templating/Helper/Helper.php
@@ -11,13 +11,17 @@

 namespace Symfony\Component\Templating\Helper;

+@trigger_error('The '.Helper::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * Helper is the base class for all helper classes.
 *
 * Most of the time, a Helper is an adapter around an existing
 * class that exposes a read-only interface for templates.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The Helper class will be removed in Symfony 4.0. You should use Twig instead.
 */
 abstract class Helper implements HelperInterface
 {

diff --git a/src/Symfony/Component/Templating/Helper/HelperInterface.php b/src/Symfony/Component/Templating/Helper/HelperInterface.php
@@ -11,10 +11,14 @@

 namespace Symfony\Component\Templating\Helper;

+@trigger_error('The '.HelperInterface::class.' interface is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * HelperInterface is the interface all helpers must implement.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The HelperInterface interface will be removed in Symfony 4.0. You should use Twig instead.
 */
 interface HelperInterface
 {

diff --git a/src/Symfony/Component/Templating/Helper/SlotsHelper.php b/src/Symfony/Component/Templating/Helper/SlotsHelper.php
@@ -11,10 +11,14 @@

 namespace Symfony\Component\Templating\Helper;

+@trigger_error('The '.SlotsHelper::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * SlotsHelper manages template slots.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The SlotsHelper class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class SlotsHelper extends Helper
 {

diff --git a/src/Symfony/Component/Templating/Loader/CacheLoader.php b/src/Symfony/Component/Templating/Loader/CacheLoader.php
@@ -11,6 +11,8 @@

 namespace Symfony\Component\Templating\Loader;

+@trigger_error('The '.CacheLoader::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 use Symfony\Component\Templating\Storage\Storage;
 use Symfony\Component\Templating\Storage\FileStorage;
 use Symfony\Component\Templating\TemplateReferenceInterface;
@@ -23,6 +25,8 @@
 * All other mechanism would imply the use of `eval()`.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The CacheLoader class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class CacheLoader extends Loader
 {

diff --git a/src/Symfony/Component/Templating/Loader/ChainLoader.php b/src/Symfony/Component/Templating/Loader/ChainLoader.php
@@ -11,13 +11,17 @@

 namespace Symfony\Component\Templating\Loader;

+@trigger_error('The '.ChainLoader::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 use Symfony\Component\Templating\Storage\Storage;
 use Symfony\Component\Templating\TemplateReferenceInterface;

 /**
 * ChainLoader is a loader that calls other loaders to load templates.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The ChainLoader class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class ChainLoader extends Loader
 {

diff --git a/src/Symfony/Component/Templating/Loader/FilesystemLoader.php b/src/Symfony/Component/Templating/Loader/FilesystemLoader.php
@@ -11,6 +11,8 @@

 namespace Symfony\Component\Templating\Loader;

+@trigger_error('The '.FilesystemLoader::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 use Symfony\Component\Templating\Storage\Storage;
 use Symfony\Component\Templating\Storage\FileStorage;
 use Symfony\Component\Templating\TemplateReferenceInterface;
@@ -19,6 +21,8 @@
 * FilesystemLoader is a loader that read templates from the filesystem.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The FilesystemLoader class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class FilesystemLoader extends Loader
 {

diff --git a/src/Symfony/Component/Templating/Loader/Loader.php b/src/Symfony/Component/Templating/Loader/Loader.php
@@ -11,12 +11,16 @@

 namespace Symfony\Component\Templating\Loader;

+@trigger_error('The '.Loader::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 use Psr\Log\LoggerInterface;

 /**
 * Loader is the base class for all template loader classes.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The Loader class will be removed in Symfony 4.0. You should use Twig instead.
 */
 abstract class Loader implements LoaderInterface
 {

diff --git a/src/Symfony/Component/Templating/Loader/LoaderInterface.php b/src/Symfony/Component/Templating/Loader/LoaderInterface.php
@@ -11,13 +11,17 @@

 namespace Symfony\Component\Templating\Loader;

+@trigger_error('The '.LoaderInterface::class.' interface is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 use Symfony\Component\Templating\TemplateReferenceInterface;
 use Symfony\Component\Templating\Storage\Storage;

 /**
 * LoaderInterface is the interface all loaders must implement.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The LoaderInterface interface will be removed in Symfony 4.0. You should use Twig instead.
 */
 interface LoaderInterface
 {

diff --git a/src/Symfony/Component/Templating/PhpEngine.php b/src/Symfony/Component/Templating/PhpEngine.php
@@ -11,6 +11,8 @@

 namespace Symfony\Component\Templating;

+@trigger_error('The '.PhpEngine::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 use Symfony\Component\Templating\Storage\Storage;
 use Symfony\Component\Templating\Storage\FileStorage;
 use Symfony\Component\Templating\Storage\StringStorage;
@@ -21,6 +23,8 @@
 * PhpEngine is an engine able to render PHP templates.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The PhpEngine class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class PhpEngine implements EngineInterface, \ArrayAccess
 {

diff --git a/src/Symfony/Component/Templating/Storage/FileStorage.php b/src/Symfony/Component/Templating/Storage/FileStorage.php
@@ -11,10 +11,14 @@

 namespace Symfony\Component\Templating\Storage;

+@trigger_error('The '.FileStorage::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * FileStorage represents a template stored on the filesystem.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The FileStorage class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class FileStorage extends Storage
 {

diff --git a/src/Symfony/Component/Templating/Storage/Storage.php b/src/Symfony/Component/Templating/Storage/Storage.php
@@ -11,10 +11,14 @@

 namespace Symfony\Component\Templating\Storage;

+@trigger_error('The '.Storage::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * Storage is the base class for all storage classes.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The Storage class will be removed in Symfony 4.0. You should use Twig instead.
 */
 abstract class Storage
 {

diff --git a/src/Symfony/Component/Templating/Storage/StringStorage.php b/src/Symfony/Component/Templating/Storage/StringStorage.php
@@ -11,10 +11,14 @@

 namespace Symfony\Component\Templating\Storage;

+@trigger_error('The '.StringStorage::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * StringStorage represents a template stored in a string.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The StringStorage class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class StringStorage extends Storage
 {

diff --git a/src/Symfony/Component/Templating/StreamingEngineInterface.php b/src/Symfony/Component/Templating/StreamingEngineInterface.php
@@ -11,10 +11,14 @@

 namespace Symfony\Component\Templating;

+@trigger_error('The '.StreamingEngineInterface::class.' interface is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * StreamingEngineInterface provides a method that knows how to stream a template.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The StreamingEngineInterface interface will be removed in Symfony 4.0. You should use Twig instead.
 */
 interface StreamingEngineInterface
 {

diff --git a/src/Symfony/Component/Templating/TemplateNameParser.php b/src/Symfony/Component/Templating/TemplateNameParser.php
@@ -11,13 +11,17 @@

 namespace Symfony\Component\Templating;

+@trigger_error('The '.TemplateNameParser::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * TemplateNameParser is the default implementation of TemplateNameParserInterface.
 *
 * This implementation takes everything as the template name
 * and the extension for the engine.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The TemplateNameParser class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class TemplateNameParser implements TemplateNameParserInterface
 {

diff --git a/src/Symfony/Component/Templating/TemplateNameParserInterface.php b/src/Symfony/Component/Templating/TemplateNameParserInterface.php
@@ -11,11 +11,15 @@

 namespace Symfony\Component\Templating;

+@trigger_error('The '.TemplateNameParserInterface::class.' interface is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * TemplateNameParserInterface converts template names to TemplateReferenceInterface
 * instances.
 *
 * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @deprecated The TemplateNameParserInterface interface will be removed in Symfony 4.0. You should use Twig instead.
 */
 interface TemplateNameParserInterface
 {

diff --git a/src/Symfony/Component/Templating/TemplateReference.php b/src/Symfony/Component/Templating/TemplateReference.php
@@ -11,10 +11,14 @@

 namespace Symfony\Component\Templating;

+@trigger_error('The '.TemplateReference::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * Internal representation of a template.
 *
 * @author Victor Berchet <victor@suumit.com>
+ *
+ * @deprecated The TemplateReference class will be removed in Symfony 4.0. You should use Twig instead.
 */
 class TemplateReference implements TemplateReferenceInterface
 {

diff --git a/src/Symfony/Component/Templating/TemplateReferenceInterface.php b/src/Symfony/Component/Templating/TemplateReferenceInterface.php
@@ -11,10 +11,14 @@

 namespace Symfony\Component\Templating;

+@trigger_error('The '.TemplateReferenceInterface::class.' interface is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
+
 /**
 * Interface to be implemented by all templates.
 *
 * @author Victor Berchet <victor@suumit.com>
+ *
+ * @deprecated The TemplateReferenceInterface interface will be removed in Symfony 4.0. You should use Twig instead.
 */
 interface TemplateReferenceInterface
 {

diff --git a/src/Symfony/Component/Templating/Tests/DelegatingEngineTest.php b/src/Symfony/Component/Templating/Tests/DelegatingEngineTest.php
@@ -15,6 +15,9 @@
 use Symfony\Component\Templating\StreamingEngineInterface;
 use Symfony\Component\Templating\EngineInterface;

+/**
+ * @group legacy
+ */
 class DelegatingEngineTest extends \PHPUnit_Framework_TestCase
 {
    public function testRenderDelegatesToSupportedEngine()

diff --git a/src/Symfony/Component/Templating/Tests/Helper/HelperTest.php b/src/Symfony/Component/Templating/Tests/Helper/HelperTest.php
@@ -13,6 +13,9 @@

 use Symfony\Component\Templating\Helper\Helper;

+/**
+ * @group legacy
+ */
 class HelperTest extends \PHPUnit_Framework_TestCase
 {
    public function testGetSetCharset()

diff --git a/src/Symfony/Component/Templating/Tests/Helper/SlotsHelperTest.php b/src/Symfony/Component/Templating/Tests/Helper/SlotsHelperTest.php
@@ -13,6 +13,9 @@

 use Symfony\Component\Templating\Helper\SlotsHelper;

+/**
+ * @group legacy
+ */
 class SlotsHelperTest extends \PHPUnit_Framework_TestCase
 {
    public function testHasGetSet()

diff --git a/src/Symfony/Component/Templating/Tests/Loader/CacheLoaderTest.php b/src/Symfony/Component/Templating/Tests/Loader/CacheLoaderTest.php
@@ -17,6 +17,9 @@
 use Symfony\Component\Templating\TemplateReferenceInterface;
 use Symfony\Component\Templating\TemplateReference;

+/**
+ * @group legacy
+ */
 class CacheLoaderTest extends \PHPUnit_Framework_TestCase
 {
    public function testConstructor()

diff --git a/src/Symfony/Component/Templating/Tests/Loader/ChainLoaderTest.php b/src/Symfony/Component/Templating/Tests/Loader/ChainLoaderTest.php
@@ -15,6 +15,9 @@
 use Symfony\Component\Templating\Loader\FilesystemLoader;
 use Symfony\Component\Templating\TemplateReference;

+/**
+ * @group legacy
+ */
 class ChainLoaderTest extends \PHPUnit_Framework_TestCase
 {
    protected $loader1;

diff --git a/src/Symfony/Component/Templating/Tests/Loader/FilesystemLoaderTest.php b/src/Symfony/Component/Templating/Tests/Loader/FilesystemLoaderTest.php
@@ -14,6 +14,9 @@
 use Symfony\Component\Templating\Loader\FilesystemLoader;
 use Symfony\Component\Templating\TemplateReference;

+/**
+ * @group legacy
+ */
 class FilesystemLoaderTest extends \PHPUnit_Framework_TestCase
 {
    protected static $fixturesPath;

diff --git a/src/Symfony/Component/Templating/Tests/Loader/LoaderTest.php b/src/Symfony/Component/Templating/Tests/Loader/LoaderTest.php
@@ -14,6 +14,9 @@
 use Symfony\Component\Templating\Loader\Loader;
 use Symfony\Component\Templating\TemplateReferenceInterface;

+/**
+ * @group legacy
+ */
 class LoaderTest extends \PHPUnit_Framework_TestCase
 {
    public function testGetSetLogger()

diff --git a/src/Symfony/Component/Templating/Tests/PhpEngineTest.php b/src/Symfony/Component/Templating/Tests/PhpEngineTest.php
@@ -19,6 +19,9 @@
 use Symfony\Component\Templating\TemplateReferenceInterface;
 use Symfony\Component\Templating\TemplateReference;

+/**
+ * @group legacy
+ */
 class PhpEngineTest extends \PHPUnit_Framework_TestCase
 {
    protected $loader;
-Original file line number
+Diff line change
@@ -11,10 +11,14 @@
     namespace Symfony\Component\Templating;
+    @trigger_error('The '.DelegatingEngine::class.' class is deprecated since version 3.3 and will be removed in 4.0. Use Twig instead.', E_USER_DEPRECATED);
     /**
      * DelegatingEngine selects an engine for a given template.
      *
      * @author Fabien Potencier <fabien@symfony.com>
+     *
+     * @deprecated The DelegatingEngine class will be removed in Symfony 4.0. You should use Twig instead.
             Copy link

  
      
    
  

  
      

  
  Member


      

  

  
    
      

      
            nicolas-grekas
  

      

      

      


        Feb 11, 2017


      
    

  


        
      
  
  
  
    

    There was a problem hiding this comment.


  

 
  
    

    Choose a reason for hiding this comment

    
      The reason will be displayed to describe this comment to others. Learn more.
    

    
      
      


  


  
    
      the annotations should be rewritten as

@deprecated since version 3.3, to be removed in 4.0. You should use Twig instead.

this will make notices raised by DebugClassLoader a bit better/consistent.
    
  
  


    

        
      
  
  
    
  
  
  
    
    Sorry, something went wrong.
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  


          
      
  
    
    
      
        
            
    All reactions
      */
     class DelegatingEngine implements EngineInterface, StreamingEngineInterface
     {
-          Expand Down