115 lines
3.4 KiB
ReStructuredText
115 lines
3.4 KiB
ReStructuredText
Deprecated Features
|
|
===================
|
|
|
|
This document lists all deprecated features in Twig. Deprecated features are
|
|
kept for backward compatibility and removed in the next major release (a
|
|
feature that was deprecated in Twig 1.x is removed in Twig 2.0).
|
|
|
|
Token Parsers
|
|
-------------
|
|
|
|
* As of Twig 1.x, the token parser broker sub-system is deprecated. The
|
|
following class and interface will be removed in 2.0:
|
|
|
|
* ``Twig_TokenParserBrokerInterface``
|
|
* ``Twig_TokenParserBroker``
|
|
|
|
Extensions
|
|
----------
|
|
|
|
* As of Twig 1.x, the ability to remove an extension is deprecated and the
|
|
``Twig_Environment::removeExtension()`` method will be removed in 2.0.
|
|
|
|
PEAR
|
|
----
|
|
|
|
PEAR support has been discontinued in Twig 1.15.1, and no PEAR packages are
|
|
provided anymore. Use Composer instead.
|
|
|
|
Filters
|
|
-------
|
|
|
|
* As of Twig 1.x, use ``Twig_SimpleFilter`` to add a filter. The following
|
|
classes and interfaces will be removed in 2.0:
|
|
|
|
* ``Twig_FilterInterface``
|
|
* ``Twig_FilterCallableInterface``
|
|
* ``Twig_Filter``
|
|
* ``Twig_Filter_Function``
|
|
* ``Twig_Filter_Method``
|
|
* ``Twig_Filter_Node``
|
|
|
|
* As of Twig 2.x, the ``Twig_SimpleFilter`` class is deprecated and will be
|
|
removed in Twig 3.x (use ``Twig_Filter`` instead). In Twig 2.x,
|
|
``Twig_SimpleFilter`` is just an alias for ``Twig_Filter``.
|
|
|
|
Functions
|
|
---------
|
|
|
|
* As of Twig 1.x, use ``Twig_SimpleFunction`` to add a function. The following
|
|
classes and interfaces will be removed in 2.0:
|
|
|
|
* ``Twig_FunctionInterface``
|
|
* ``Twig_FunctionCallableInterface``
|
|
* ``Twig_Function``
|
|
* ``Twig_Function_Function``
|
|
* ``Twig_Function_Method``
|
|
* ``Twig_Function_Node``
|
|
|
|
* As of Twig 2.x, the ``Twig_SimpleFunction`` class is deprecated and will be
|
|
removed in Twig 3.x (use ``Twig_Function`` instead). In Twig 2.x,
|
|
``Twig_SimpleFunction`` is just an alias for ``Twig_Function``.
|
|
|
|
Tests
|
|
-----
|
|
|
|
* As of Twig 1.x, use ``Twig_SimpleTest`` to add a test. The following classes
|
|
and interfaces will be removed in 2.0:
|
|
|
|
* ``Twig_TestInterface``
|
|
* ``Twig_TestCallableInterface``
|
|
* ``Twig_Test``
|
|
* ``Twig_Test_Function``
|
|
* ``Twig_Test_Method``
|
|
* ``Twig_Test_Node``
|
|
|
|
* As of Twig 2.x, the ``Twig_SimpleTest`` class is deprecated and will be
|
|
removed in Twig 3.x (use ``Twig_Test`` instead). In Twig 2.x,
|
|
``Twig_SimpleTest`` is just an alias for ``Twig_Test``.
|
|
|
|
* The ``sameas`` and ``divisibleby`` tests are deprecated in favor of ``same
|
|
as`` and ``divisible by`` respectively.
|
|
|
|
Nodes
|
|
-----
|
|
|
|
* As of Twig 1.x, ``Node::toXml()`` is deprecated and will be removed in Twig
|
|
2.0.
|
|
|
|
Interfaces
|
|
----------
|
|
|
|
* As of Twig 2.x, the following interfaces are deprecated and empty (they will
|
|
be removed in Twig 3.0):
|
|
|
|
* ``Twig_CompilerInterface`` (use ``Twig_Compiler`` instead)
|
|
* ``Twig_LexerInterface`` (use ``Twig_Lexer`` instead)
|
|
* ``Twig_NodeInterface`` (use ``Twig_Node`` instead)
|
|
* ``Twig_ParserInterface`` (use ``Twig_Parser`` instead)
|
|
* ``Twig_ExistsLoaderInterface`` (merged with ``Twig_LoaderInterface``)
|
|
* ``Twig_TemplateInterface`` (use ``Twig_Template`` instead, and use
|
|
those constants Twig_Template::ANY_CALL, Twig_Template::ARRAY_CALL,
|
|
Twig_Template::METHOD_CALL)
|
|
|
|
Loaders
|
|
-------
|
|
|
|
* As of Twig 1.x, ``Twig_Loader_String`` is deprecated and will be removed in
|
|
2.0.
|
|
|
|
Globals
|
|
-------
|
|
|
|
* As of Twig 2.x, the ability to register a global variable after the runtime
|
|
or the extensions have been initialized is not possible anymore (but
|
|
changing the value of an already registered global is possible).
|