手册:Article.php
Appearance
Outdated translations are marked like this.
MediaWiki文件: Article.php | |
---|---|
位置: | includes/page/ |
源代码: | master • 1.42.3 • 1.41.4 • 1.39.10 |
类: | Article |
Article
类处理MediaWiki页面及其历史记录的呈现和交互。它与WikiPage 类密切相关,后者为页面提供模型对象。
例如,该文件包含一个用于查看页面的函数view()
,从ViewAction.php
调用(另一个版本在RawAction.php
中)。
此函数使用函数getContent()
、loadContent()
和fetchContent()
从数据库获取页面的wikitext$mContent
,并将其分配给$text
。
之后,它调用函数outputWikiText()
(已弃用)来处理$text
。
创建新的条目对象
要实例化Article
,请调用静态工厂方法之一或使用构造函数:
Article::newFromId( $id )
- 其中,$id
是文章ID(与page_id 相同)。Article::newFromTitle( Title $title, IContextSource $context )
- 为给定标题创建相应类的文章对象。Article::newFromWikiPage( WikiPage $page, IContextSource $context )
- 为给定页创建相应类的文章对象。new Article( Title $title )
- 从给定标题创建一个文章对象。
方法
getContent()
((在版本1.29移除); superseded by WikiPage::getContent() ) - 获取此修订版的文本。这个功能有副作用。如果您只需要真实的修订文本(如果有),请不要使用此功能。getContext()
(1.18+) - 获取在其中执行此项目的上下文。getOldID()
- 获取要显示的项目的旧版本,如果是当前修订,则为0。getPage()
(1.19+) - 获取此实例的Wikipage对象。getParserOptions()
- 获取适合呈现主项目wikitext的解析器选项。getParserOutput([$oldid, User $user])
- 一种轻量级方法,用于获取页面的解析器输出,检查解析器缓存等。它没有考虑Wikipage::view()
被迫考虑的大部分内容。getRevIdFetched()
- 获取页面视图上使用的修订版ID。getRevisionFetched()
(1.19+) - 根据请求参数获取获取的修订对象,如果失败则为空。getRobotPolicy(string $action, ParserOutput $pOutput)
- 获取要用于当前视图的自动机策略。$action
是包含action=Get参数和$pOutput
的字符串。getTitle()
- 获取与此页关联的标题。isCurrent()
- 如果当前引用的修订是对此页面的当前编辑(并且存在),则返回True。isFileCacheable()
- 如果页面可以缓存,则返回True。view()
- 此方法处理查看页面的(默认)操作。Actions(如‘VIEW’、‘REVERT’、‘DELETE’等)由Action子类处理。ViewAction的show()
方法调用Article::view()
来执行实际工作。
有关方法的完整列表,请参阅此处(MediaWiki开发文档)。
从该文件调用的钩子列在Category:MediaWiki hooks included in Article.php 类别中。