]>
Commit | Line | Data |
---|---|---|
4f5b44bd NL |
1 | Deprecated Features |
2 | =================== | |
3 | ||
4 | This document lists all deprecated features in Twig. Deprecated features are | |
5 | kept for backward compatibility and removed in the next major release (a | |
6 | feature that was deprecated in Twig 1.x is removed in Twig 2.0). | |
7 | ||
8 | Token Parsers | |
9 | ------------- | |
10 | ||
11 | * As of Twig 1.x, the token parser broker sub-system is deprecated. The | |
12 | following class and interface will be removed in 2.0: | |
13 | ||
14 | * ``Twig_TokenParserBrokerInterface`` | |
15 | * ``Twig_TokenParserBroker`` | |
16 | ||
17 | Extensions | |
18 | ---------- | |
19 | ||
20 | * As of Twig 1.x, the ability to remove an extension is deprecated and the | |
21 | ``Twig_Environment::removeExtension()`` method will be removed in 2.0. | |
22 | ||
23 | PEAR | |
24 | ---- | |
25 | ||
26 | PEAR support will be discontinued in Twig 2.0, and no PEAR packages will be | |
27 | provided. Use Composer instead. | |
28 | ||
29 | Filters | |
30 | ------- | |
31 | ||
32 | * As of Twig 1.x, use ``Twig_SimpleFilter`` to add a filter. The following | |
33 | classes and interfaces will be removed in 2.0: | |
34 | ||
35 | * ``Twig_FilterInterface`` | |
36 | * ``Twig_FilterCallableInterface`` | |
37 | * ``Twig_Filter`` | |
38 | * ``Twig_Filter_Function`` | |
39 | * ``Twig_Filter_Method`` | |
40 | * ``Twig_Filter_Node`` | |
41 | ||
42 | * As of Twig 2.x, the ``Twig_SimpleFilter`` class is deprecated and will be | |
43 | removed in Twig 3.x (use ``Twig_Filter`` instead). In Twig 2.x, | |
44 | ``Twig_SimpleFilter`` is just an alias for ``Twig_Filter``. | |
45 | ||
46 | Functions | |
47 | --------- | |
48 | ||
49 | * As of Twig 1.x, use ``Twig_SimpleFunction`` to add a function. The following | |
50 | classes and interfaces will be removed in 2.0: | |
51 | ||
52 | * ``Twig_FunctionInterface`` | |
53 | * ``Twig_FunctionCallableInterface`` | |
54 | * ``Twig_Function`` | |
55 | * ``Twig_Function_Function`` | |
56 | * ``Twig_Function_Method`` | |
57 | * ``Twig_Function_Node`` | |
58 | ||
59 | * As of Twig 2.x, the ``Twig_SimpleFunction`` class is deprecated and will be | |
60 | removed in Twig 3.x (use ``Twig_Function`` instead). In Twig 2.x, | |
61 | ``Twig_SimpleFunction`` is just an alias for ``Twig_Function``. | |
62 | ||
63 | Tests | |
64 | ----- | |
65 | ||
66 | * As of Twig 1.x, use ``Twig_SimpleTest`` to add a test. The following classes | |
67 | and interfaces will be removed in 2.0: | |
68 | ||
69 | * ``Twig_TestInterface`` | |
70 | * ``Twig_TestCallableInterface`` | |
71 | * ``Twig_Test`` | |
72 | * ``Twig_Test_Function`` | |
73 | * ``Twig_Test_Method`` | |
74 | * ``Twig_Test_Node`` | |
75 | ||
76 | * As of Twig 2.x, the ``Twig_SimpleTest`` class is deprecated and will be | |
77 | removed in Twig 3.x (use ``Twig_Test`` instead). In Twig 2.x, | |
78 | ``Twig_SimpleTest`` is just an alias for ``Twig_Test``. | |
79 | ||
80 | Interfaces | |
81 | ---------- | |
82 | ||
83 | * As of Twig 2.x, the following interfaces are deprecated and empty (they will | |
84 | be removed in Twig 3.0): | |
85 | ||
86 | * ``Twig_CompilerInterface`` (use ``Twig_Compiler`` instead) | |
87 | * ``Twig_LexerInterface`` (use ``Twig_Lexer`` instead) | |
88 | * ``Twig_NodeInterface`` (use ``Twig_Node`` instead) | |
89 | * ``Twig_ParserInterface`` (use ``Twig_Parser`` instead) | |
90 | * ``Twig_ExistsLoaderInterface`` (merged with ``Twig_LoaderInterface``) | |
91 | * ``Twig_TemplateInterface`` (use ``Twig_Template`` instead) | |
92 | ||
93 | Globals | |
94 | ------- | |
95 | ||
96 | * As of Twig 2.x, the ability to register a global variable after the runtime | |
97 | or the extensions have been initialized is not possible anymore (but | |
98 | changing the value of an already registered global is possible). |