Jump to navigation Jump to search
Outras línguas: English  • Deutsch • français • Bahasa Indonesia • 日本語 • português • português do Brasil • русский • 中文

Esta página descreve os ficheiros chave e as diretorias no código fonte do MediaWiki. Para mais informação detalhada, consulte classe, ficheiro e as referências completas geradas automaticamente a partir do código fonte do MediaWiki, utilizando doxygen.

Pontos de acesso[edit]

Consulte também: Special:Version#Entry point URLs
You can generate this list by running: git grep -l /includes/WebStart.php.[AP 1][AP 2]

These are the files that a browser may reach when using the wiki. All of them are located in the root directory of the wiki.

Ficheiro Descrição Documentos da Wiki
index.php Main access point for the MediaWiki software. It handles most requests made to MediaWiki. Manual:index.php
api.php External access point for MediaWiki's API. See API:Main page. Manual:api.php
load.php Script for the front-end to hook into for loading ResourceLoader modules. Manual:load.php
img_auth.php Script that only serves images to logged in users. To configure the wiki to use that script, see Manual:Image Authorisation . Manual:img_auth.php
opensearch_desc.php Returns an OpenSearch description document that describes the web interface of MediaWiki's search engine. Manual:opensearch_desc.php
profileinfo.php Allow users to see the profiling information that are stored in the database. See Manual:How to debug#Profiling . Manual:profileinfo.php
thumb.php Script used to resize images. Manual:thumb.php
thumb_handler.php PHP script to be used as 404 handler to create and stream out a not yet existing image thumbnail. Manual:thumb_handler.php
  1. Except thumb_handler.php, which is a simple wrapper around thumb.php and thus does not have to re-include WebStart.php
  2. That command also returns mw-config/index.php, but unlike the other files, it is not intended for repeated use during normal wiki operation; in other words, it is not an access point to reach wiki resources, but a one-off script to launch the configuration process of a newly installed wiki.
Removed entry points
Ficheiro Descrição Documentos da Wiki
redirect.php Script that redirects to the article passed in the wpDropdown parameter of the request. Needed for Nostalgia skin. (removed in 1.22) Manual:redirect.php
trackback.php Adds trackbacks to the database. (removed in 1.19) (r104051) Manual:trackback.php


Default location for the file cache, if enabled (by setting $wgUseFileCache = true; — the default is false.). This location can be customized using $wgFileCacheDirectory .


Contains various text files that should help you understand the most important parts of the code of MediaWiki.


MediaWiki extensions are distributed separately from the core code. Installing an extension entails copying its files into this directory, and enabling it by following the extension's own installation instructions (usually editing the LocalSettings.php file). In current versions a set of several extensions is distributed with a fresh MediaWiki install.


This directory stores common include files needed by MediaWiki.

Ficheiro Descrição Documentos da Wiki
Article.php Contains the Article class, which provides methods to view, modify and manage articles. This maintains WikiPage functions for backwards compatibility. Manual:Article.php
AutoLoader.php This defines autoloading handler for whole MediaWiki framework. Manual:AutoLoader.php
Defines.php Defines several constants, suchs as those for namespaces, which are used by other files and classes. Manual:Defines.php
EditPage.php Provides much of the code related to the editing user interface Manual:EditPage.php
GlobalFunctions.php Contains globally used functions like wfMsgExt. Manual:GlobalFunctions.php
Linker.php Contains methods to create internal, external or image links and implements page existence detection. Manual:Linker.php
Message.php Provides methods for: fetching interface messages; processing messages into a variety of formats. See Manual:API das Mensagens . Manual:Message.php
OutputPage.php Hold HTML and wikitext parsing. Will also generate the <head> element or part of it. Manual:OutputPage.php
Pager.php Contains the IndexPager class used for paging results of MySQL queries. Manual:Pager.php
Parser.php Contains most of the code that converts wikitext to HTML (though few bits and pieces are in Manual:Skin.php ). Manual:Parser.php
Setup.php Include commonly used files and initializes the global object variables so that MediaWiki can work. Manual:Setup.php
Skin.php Encapsulates a "look and feel" for the wiki. Manual:Skin.php
SpecialPage.php Contains the SpecialPage class, which is the parent class for all special page classes. It also makes available several static functions for handling the special page list and several other special page classes, like RedirectSpecialPage and IncludableSpecialPage. See Manual:Páginas Especiais . Manual:SpecialPage.php
SiteStats.php Contains the SiteStats class for site statistics and related things. Manual:SiteStats.php
TemplateParser.php Functions for utilizing HTML templates (not to be confused with WikiText templates) Manual:TemplateParser.php
Title.php Represents the title of an article, and does all the work of translating among various forms such as plain text, URL, database key, etc. For convenience, and for historical reasons, it also represents a few features of articles that don't involve their text, such as access rights. Manual:Title.php
User.php Encapsulates the state of the user viewing/using the site. Can be queried for things like the user's settings, name, etc. Handles the details of getting and saving to the user table of the database, and dealing with sessions and cookies. Manual:User.php
UserMailer.php Collection of static functions for sending mail. Manual:UserMailer.php
WebRequest.php This file contains the definition of the WebRequest class. Manual:WebRequest.php
WebStart.php It does the initial setup for a web request: security checks, loads LocalSettings.php and Setup.php . Manual:WebStart.php
MediaWiki.php This file consists of the definition of the MediaWiki class. Manual:MediaWiki.php
PathRouter.php The class used for turning pretty urls into query arguments that MediaWiki can use. Manual:PathRouter.php
WikiPage.php Contains the WikiPage class, which represents a page in the wiki. Manual:WikiPage.php


This directory contains the Action classes, which handle the different actions which can be performed on pages (e.g. view, delete, edit, etc.). All these classes extend the Action, FormlessAction or FormAction classes. Some of them are just stubs which call methods in the Article or EditPage classes to do the actual work.

Ficheiro Descrição Documentos da Wiki
CreditsAction.php Handles formatting the credits for articles. See also Manual:$wgMaxCredits . Manual:CreditsAction.php
DeleteAction.php Handles page deletion. Manual:DeleteAction.php
EditAction.php Contains classes EditAction and SubmitAction which handle the edit and submitting actions. Manual:EditAction.php
HistoryAction.php Handles printing the history page for an article. Manual:HistoryAction.php
InfoAction.php Displays informations about a page, like the total number of edits and number of unique editors. Manual:InfoAction.php
MarkpatrolledAction.php Handles marking a revision as patrolled. Manual:MarkpatrolledAction.php
ProtectAction.php Handles protecting a page. Manual:ProtectAction.php
PurgeAction.php Handles purging a page. Manual:PurgeAction.php
RawAction.php Handles the "action=raw" action. Manual:RawAction.php
RenderAction.php Handles the render action, which shows an HTML rendering of the page; similar to the view action, but only the unstyled article text is shown, not the additional toolboxes, search boxes, stylesheets, etc. Manual:RenderAction.php
RevertAction.php Contains class RevertFileAction, which handles reverting a file. Manual:RevertAction.php
RevisiondeleteAction.php Handles the revision delete action by just passing the request to Special:RevisionDelete. Manual:RevisiondeleteAction.php
RollbackAction.php Handles rolling back a page. Manual:RollbackAction.php
ViewAction.php Handles the viewing of a page, by calling Article::view(). Manual:ViewAction.php
WatchAction.php Contains classes WatchAction and UnwatchAction, which handle watching and unwatching a page. Manual:WatchAction.php


This directory contains the code for the MediaWiki API. See API:Main page. The most important files are:

Ficheiro Descrição Documentos da Wiki
ApiBase.php The base class for all API classes. Has a lot of common code for all API actions. Inherits ContextSource class Manual:ApiBase.php
ApiFormatBase.php The base class for all formatting classes. Inherits ApiBase. Manual:ApiFormatBase.php
ApiQueryBase.php The base class for all query API classes. Inherits ApiBase. Manual:ApiQueryBase.php


This directory contains files with code relating to MediaWiki's caching mechanisms.

Ficheiro Descrição Documentos da Wiki
FileCacheBase.php The FileCacheBase class is the base class for classes which provide a file based cache scheme. See Manual:File cache . Manual:FileCacheBase.php
GenderCache.php Caches user genders when needed to use correct namespace aliases. Manual:GenderCache.php
HTMLCacheUpdate.php Invalidates the HTML cache of all the pages linking to a given title. Manual:HTMLCacheUpdate.php
HTMLFileCache.php File based caching of HTML pages. Manual:HTMLFileCache.php
LinkBatch.php The LinkBatch class represents a list of titles. Manual:LinkBatch.php
LinkCache.php Caching for article titles (prefixed DB keys) and ids linked from one source. See also LINKCACHE.TXT. Manual:LinkCache.php
MemcachedSessions.php This file gets included if $wgSessionsInMemcache is set in the config. It redirects session handling functions to store their data in memcached instead of the local filesystem. Manual:MemcachedSessions.php
MessageCache.php Performs various MediaWiki namespace-related functions. Manual:MessageCache.php
ObjectFileCache.php File based caching of objects. Manual:ObjectFileCache.php
ResourceFileCache.php File based caching of JavaScript and CSS resources. Manual:ResourceFileCache.php
SquidUpdate.php Handles purging appropriate Squid URLs given a title (or titles). Manual:SquidUpdate.php


This directory contains a few classes related to (request) contexts. As of MediaWiki 1.18 the context of a request is encapsulated inside a RequestContext instance which implements IContextSource. A context is a way of grouping the parts of a request together. This reduces the need for globals. See Manual:RequestContext.php for more information.

Ficheiro Descrição Documentos da Wiki
ContextSource.php The ContextSource class implements the IContextSource interface. It is a helper class: by making a class extend ContextSource the class will be provided with the various getOutput, getSkin, getLanguage, etc. helpers directly and will implement IContextSource. Manual:ContextSource.php
DerivativeContext.php A DerivativeContext is an IContextSource implementation which will inherit context from another source but allows individual pieces of context to be changed locally. Manual:DerivativeContext.php
IContextSource.php This file contains the IContextSource interface. This interface should be implemented by objects which provide a context on a request. Manual:IContextSource.php
RequestContext.php A RequestContext object groups all the pieces relevant to the context of a request into one instance. Manual:RequestContext.php


This directory contains the code for database support. Database.php provides MediaWiki's database abstraction layer.


This directory contains the standard MediaWiki difference engine. A difference engine computes the difference between two texts. Whether this difference engine is used or some external diff tool, depends on the $wgExternalDiffEngine setting.

Ficheiro Descrição Documentos da Wiki
DairikiDiff.php The DairikiDiff engine. Currently the standard diff engine. The file defines several related classes. Manual:DairikiDiff.php
DifferenceEngine.php The DifferenceEngine class the interface between MediaWiki and whichever difference engine is used. Which difference engine is used depends on the $wgExternalDiffEngine config setting. Manual:DifferenceEngine.php
WikiDiff3.php Another diff engine. Currently not in use. Manual:WikiDiff3.php


Files related to the job queue. Each job class for a specific type of job derives from the Job class and has to implement a run() method which does the actual job.

Ficheiro Descrição Documentos da Wiki
DoubleRedirectJob.php Job to fix double redirects after moving a page Manual:DoubleRedirectJob.php
EnotifNotifyJob.php Job for email notification. Manual:EnotifNotifyJob.php
JobQueue.php Contains the Job class. This is the abstract class to describe a background job. The class also contains static functions for handling jobs (insert jobs in the queue and pop jobs from the queue). Manual:JobQueue.php
RefreshLinksJob.php Contains the RefreshLinksJob and RefreshLinksJob2 classes for jobs to update links for a given title. They use class LinksUpdate (defined in /includes/LinksUpdate.php) to update several db tables. Manual:RefreshLinksJob.php
UploadFromUrlJob.php Job for asynchronous upload-by-url. Its an interface to the UploadFromUrl class in /includes/upload/UploadFromUrl.php. Manual:UploadFromUrlJob.php


Some files related to logging the events which happen on a Wiki. This directory was introduced in MW 1.19. Some of the files were already present in olders versions, in the includes/ directory.

Ficheiro Descrição Documentos da Wiki
LogEntry.php Contains the LogEntry interface and some classes implementing this interface to encapsulate log entries. Introduced in MW 1.19. Manual:LogEntry.php
LogEventsList.php A class to list log entries. Manual:LogEventsList.php
LogFormatter.php Contains several classes for formatting log entries. Introduced in MW 1.19. Manual:LogFormatter.php
LogPage.php Class to manage a log: add entries to the log and extract information from the log. Manual:LogPage.php
LogPager.php Class to list log entries. Implements the ReverseChronologicalPager class. Manual:LogPager.php
PatrolLog.php Class containing static functions for working with logs of patrol events. Manual:PatrolLog.php


This directory contains files for handling several media formats, mostly images.


This directory contains some Unicode normalization routines. See includes/normal/README for more information.


Files related to MediaWiki's caching mechanisms. The files in this directory provide the possibility to store objects in PHP accelerators, in memcached, in a database or in DBA files.

Ficheiro Descrição Documentos da Wiki
APCBagOStuff.php Implementation of BagOStuff for APC's shared memory functions. Manual:APCBagOStuff.php
BagOStuff.php Abstract class to be derived by classes which cache objects in PHP accelerators, SQL database or DBA files. It specifies the methods a cache class must provide, like get(), set(), delete(), etc. Manual:BagOStuff.php
DBABagOStuff.php Implementation of BagOStuff which uses PHP's DBA extension as a backend. Manual:DBABagOStuff.php
EhcacheBagOStuff.php Implementation of BagOStuff using the Ehcache RESTful web service. Manual:EhcacheBagOStuff.php
EmptyBagOStuff.php Emulates an empty BagOStuff. Manual:EmptyBagOStuff.php
MemcachedClient.php Contains the MWMemcached class, a PHP memcache client. Manual:MemcachedClient.php
MemcachedPhpBagOStuff.php Implementation of BagOStuff using memcached. It uses the MWMemcached class as a pure PHP memcached client. Manual:MemcachedPhpBagOStuff.php
MultiWriteBagOStuff.php Implementation of BagOStuff that replicates all writes to multiple child caches. Manual:MultiWriteBagOStuff.php
ObjectCache.php The ObjectCache class contains some static helper functions for caching objects. Manual:ObjectCache.php
SqlBagOStuff.php Implementation of BagOStuff using a database. Manual:SqlBagOStuff.php
inCacheBagOStuff.php Implementation of BagOStuff using WinCache. Manual:inCacheBagOStuff.php
CacheBagOStuff.php Implementation of BagOStuff using XCache. Manual:CacheBagOStuff.php


The MediaWiki parser, which transforms wikitext to HTML, can be found here together with related files. The most interesting files in this directory:

Ficheiro Descrição Documentos da Wiki
CoreParserFunctions.php A collection of functions which implement the core parser functions. Manual:CoreParserFunctions.php
CoreTagHooks.php Tag hooks provided by MediaWiki core, e.g. <nowiki>, <gallery>, <pre>, .. Manual:CoreTagHooks.php
LinkHolderArray.php A LinkHolderArray holds a set of replacement pairs for wiki links. Manual:LinkHolderArray.php
Parser.php This file contains the parser. A few regular expressions are included. Manual:Parser.php
ParserCache.php This class handles caching the output from the parser. Manual:ParserCache.php
ParserOptions.php The ParserOptions class holds a collection of options for the parser. Manual:ParserOptions.php
ParserOutput.php Contains the ParserOutput class, which encapsulates the output of the parser. Manual:ParserOutput.php
Preprocessor.php Contains the Preprocessor interface for preprocessors. Also contains the PPFrame and PPNode interfaces. Manual:Preprocessor.php
Preprocessor_DOM.php A preprocessor using PHP's DOM extension. This preprocessor is used if the PHP DOM extension is available. Manual:Preprocessor_DOM.php
Preprocessor_Hash.php A preprocessor using PHP arrays. This preprocessor is used if the PHP DOM isn't available or when the old XMLDOM extension is present. Manual:Preprocessor_Hash.php
Preprocessor_HipHop.php A preprocessor optimised for HipHop, using HipHop-specific syntax. Manual:Preprocessor_HipHop.php


Files related to ResourceLoader, a JavaScript/CSS delivery optimizing system for MediaWiki.


This directory contains the code to implement the possibility of searching a wiki using one the possible backends.

Ficheiro Descrição Documentos da Wiki
SearchEngine.php Contains several classes related to searching a wiki. The SearchEngine class is the parent class for specific search implementations. Manual:SearchEngine.php
SearchIBM_DB2.php Implements SearchEngine using IBM DB2. Manual:SearchIBM_DB2.php
SearchMssql.php Implements SearchEngine using Msssql. Manual:SearchMssql.php
SearchMySQL.php Implements SearchEngine using a MySQL search engine. Manual:SearchMySQL.php
SearchOracle.php Implements SearchEngine using Oracle (ConText). Manual:SearchOracle.php
SearchSqlite.php Implements SearchEngine using SQLite. Manual:SearchSqlite.php


This directory contains the code and classes for the standard special pages. All special page classes derive from class SpecialPage (defined in [1]). Special pages which come with extension are located in their respective extensions directories. See also Manual:Páginas Especiais .


Files providing the backend of MediaWiki's file upload feature.

Ficheiro Descrição Documentos da Wiki
UploadBase.php UploadBase and subclasses are the backend of MediaWiki's file uploads. Manual:UploadBase.php
UploadFromChunks.php Subclass of UploadBase implementing uploading from chunks. Manual:UploadFromChunks.php
UploadFromFile.php Subclass of UploadBase implementing regular file uploads. Manual:UploadFromFile.php
UploadFromStash.php Subclass of UploadBase implementing uploading from previously stored file. Manual:UploadFromStash.php
UploadFromUrl.php Subclass of UploadBase implementing uploading from a HTTP resource. Manual:UploadFromUrl.php
UploadStash.php Provides the possibility to enable applications to temporarily stash files without publishing them to the wiki. Manual:UploadStash.php


If uploads are enabled in the wiki, files will be put in subdirectories under this directory. See Manual:Administração de Imagem for more details.


This directory contains files used for localization and internationalization. For a quick overview, see Language in MediaWiki.

Ficheiro Descrição Documentos da Wiki
Language.php Contains the Language class, it represents the language used for incidental text, and also has some character encoding functions and other locale stuff. Two globals contain an instance of this class: $wgContLang for the site language and $wgLang for the user language. Manual:Language.php


This directory contains maintenance scripts that must be run from a command line interface.

See Manual:Scripts de Manutenção for an overview of those scripts.


Entry point for the Config script (the helper script that helps setting up a newly installed wiki). The actual code of the installer is located at /includes/installer/.


This directory contains JavaScript and CSS resources used by MediaWiki, including jQuery.

It also contains binary files like PNG and SVG images, for instance in resources/src/mediawiki/images/: see Manual:Assets .


Location for serialized objects (database entries converted into files -- see Serialization for more information). The database tables that contain serialized data are listed at Manual:Serialization .


This directory contain all skins classes, JavaScripts, CSS and some images used by that skins. See Manual:Temas .


Contém vários ficheiros relacionados com os testes (unidade), incluindo: