文档
弃用功能
弃用功能
这个文档列出了所有在树枝弃用功能。弃用功能保持向后兼容性和删除下一个主要版本(一项功能,树枝1中被弃用。x是移除在树枝2.0)。
宏
2.0的树枝,宏进口文件中没有了(通过一个孩子的模板包括
例如调用)。需要导入宏每个文件中显式地使用它们。
令牌的解析器
树枝的1.倍,the token parser broker sub-system is deprecated. The following class and interface will be removed in 2.0:
Twig_TokenParserBrokerInterface
Twig_TokenParserBroker
- 1.27的树枝,
\树枝\解析器:getFilename ()
弃用。从一个象征性的解析器,使用$ this - >解析器- > getStream () - > getSourceContext () - > getPath ()
代替。 - 1.27的树枝,
\树枝\解析器:getEnvironment ()
弃用。
扩展
- 树枝的1.倍,the ability to remove an extension is deprecated and the
\树枝\环境::removeExtension ()
2.0方法将被删除。 - 1.23树枝,
\ \树枝\扩展ExtensionInterface: initRuntime ()
方法是弃用。你有两个选择,以避免弃用通知:如果你实现这个方法来存储环境定制过滤器,函数,或者测试,使用needs_environment
选择相反;如果你有更复杂的需求,明确实施\树枝\ \ InitRuntimeInterface延伸
(不推荐)。 - 1.23树枝,
\ \树枝\扩展ExtensionInterface: getGlobals ()
方法是弃用。实现\树枝\ \ GlobalsInterface延伸
为了避免弃用通知。 - 1.26树枝,
\ \树枝\扩展ExtensionInterface: getName ()
方法弃用,这不是在内部使用了。
梨
嫩枝1.15.1梨支持已经停产,没有梨包提供了。而是使用作曲家。
过滤器
树枝的1.倍,use
\树枝\ TwigFilter
添加一个过滤器。下面的类和接口将被删除在2.0:Twig_FilterInterface
Twig_FilterCallableInterface
Twig_Filter
Twig_Filter_Function
Twig_Filter_Method
Twig_Filter_Node
- 的嫩枝2。x,
Twig_SimpleFilter
类是弃用树枝3将被删除。x(使用\树枝\ TwigFilter
相反)。在树枝2. x,Twig_SimpleFilter
只是一个别名吗\树枝\ TwigFilter
。
功能
树枝的1.倍,use
\树枝\ TwigFunction
添加一个函数。下面的类和接口将被删除在2.0:Twig_FunctionInterface
Twig_FunctionCallableInterface
Twig_Function
Twig_Function_Function
Twig_Function_Method
Twig_Function_Node
- 的嫩枝2。x,
Twig_SimpleFunction
类是弃用树枝3将被删除。x(使用\树枝\ TwigFunction
相反)。在树枝2. x,Twig_SimpleFunction
只是一个别名吗\树枝\ TwigFunction
。
测试
树枝的1.倍,use
\树枝\ TwigTest
添加一个测试。下面的类和接口将被删除在2.0:Twig_TestInterface
Twig_TestCallableInterface
Twig_Test
Twig_Test_Function
Twig_Test_Method
Twig_Test_Node
- 的嫩枝2。x,
Twig_SimpleTest
类是弃用树枝3将被删除。x(使用\树枝\ TwigTest
相反)。在树枝2. x,Twig_SimpleTest
只是一个别名吗\树枝\ TwigTest
。 - 的
篇
和divisibleby
测试是不赞成一样
和整除
分别。
标签
- 树枝的1.倍,the
生
标签是弃用。你应该使用逐字
代替。
节点
- 树枝的1.倍,
节点:toXml ()
嫩枝2.0中弃用,将被删除。 - 1.26的树枝,
节点::$节点
应该只包含\ \树枝\节点
情况下,存储零
值被弃用,不可能在树枝2. x。 - 1.27树枝,
文件名
属性\树枝\ \ ModuleNode节点
弃用。使用getName ()
代替。 - 1.27树枝,
方法被弃用,使用\树枝 \节点 \节点::getFilename () / \树枝 \节点 \节点:getLine ()
代替。\树枝 \节点 / \节点:getTemplateName () \树枝 \节点 \节点:getTemplateLine ()
接口
- 的嫩枝2。x,following interfaces are deprecated and empty (they will be removed in Twig 3.0):
Twig_CompilerInterface
(使用\树枝\编译器
相反)Twig_LexerInterface
(使用、树枝、词法分析程序
相反)Twig_NodeInterface
(使用\ \树枝\节点
相反)Twig_ParserInterface
(使用\树枝\解析器
相反)\树枝\装载机\ ExistsLoaderInterface
(合并\树枝\装载机\ LoaderInterface
)\树枝\装载机\ SourceContextLoaderInterface
(合并\树枝\装载机\ LoaderInterface
)Twig_TemplateInterface
(使用\树枝\模板
相反,和使用这些常量TwigTemplate:: ANY_CALL TwigTemplate:: ARRAY_CALL TwigTemplate:: METHOD_CALL)
编译器
- 1.26树枝,
\树枝\编译器:getFilename ()
已弃用。无论如何你不应该使用它作为它的值是不可靠的。 - 1.27树枝,
\树枝\编译器:addIndentation ()
已弃用。使用\树枝\编译器::写(”)
代替。
加载器
- 树枝的1.倍,
Twig_Loader_String
2.0废弃,将被删除。你可以通过呈现一个字符串\树枝\环境::createTemplate ()
。 - 1.27的树枝,
\树枝\装载机\ LoaderInterface: getSource ()
弃用。实现\树枝\装载机\ SourceContextLoaderInterface
相反,使用getSourceContext ()
。
节点的游客
- 因为删除
Twig_NodeInterface
在2.0中,您需要扩展\树枝\ NodeVisitor \ AbstractNodeVisitor
而不是实现\树枝\ NodeVisitor \ NodeVisitorInterface
直接让你的节点游客兼容两枝1。倍和2.倍。
全局变量
- 的嫩枝2。x,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).
- 树枝的1.倍,using the
_self
获得当前的全局变量\树枝\模板
实例被弃用;大多数使用只需要当前的模板名称,这将继续在树枝2.0。在树枝2.0中,_self
返回当前模板名称,而不是当前\树枝\模板
实例。如果您使用的是{{_self。templateName}}
,就取而代之{{_self}}
。
杂项
- 树枝的1.倍,
\树枝\环境::clearTemplateCache ()
,\树枝\环境::writeCacheFile ()
,\树枝\环境::clearCacheFiles ()
,\树枝\环境::getCacheFilename ()
,\树枝\环境::getTemplateClassPrefix ()
,\树枝\环境::getLexer ()
,\树枝\环境::getParser ()
,\树枝\环境::getCompiler ()
在2.0废弃,将被删除。 - 树枝的1.倍,
\树枝\模板::getEnvironment ()
和Twig_TemplateInterface: getEnvironment ()
在2.0废弃,将被删除。 - 1.21的树枝,设置环境的选择
autoescape
来真正的
2.0废弃,将被删除。使用“html”
代替。 - 1.27的树枝,
\树枝\ \错误:错误:getTemplateFile ()
和\树枝\ \错误:错误:setTemplateFile ()
弃用。使用\树枝\ \错误:错误:getTemplateName ()
和\树枝\ \错误:错误:setTemplateName ()
代替。 - 1.27的树枝,
\树枝\模板::getSource ()
弃用。使用\树枝\模板::getSourceContext ()
代替。 - 1.27的树枝,
\树枝\解析器:addHandler ()
和\树枝\解析器:addNodeVisitor ()
在2.0废弃,将被删除。 - 从树枝1.29开始,一些类标记为最终通过@final注释。这些类将被标记为最终在2.0。