Manual:Code/ru

From MediaWiki.org
Jump to navigation Jump to search

This page is in progress of translating to Russian. You can help translating it or go to another language version that follows:

Эта страница в процессе перевода на русский язык. Вы можете помочь в переводе или перейти на другие языковые версии, указанные ниже:

Другие языки: English  • Deutsch • français • Bahasa Indonesia • 日本語 • português do Brasil • русский • 中文

На этой странице перечислены основные файлы (классы) и папки, составляющие программный код MediaWiki. Для получения более подробной информации см. документацию этих классов, файлов и общую, автоматически генерируемую из исходного кода MediaWiki посредством doxygen.

Точки доступа[edit]

Файл Описание
index.php Основная точка доступа к ПО MediaWiki. Обрабатывает большинство запросов к MediaWiki. См. Manual:index.php. Manual:index.php/ruTemplate:Enlink/list1
api.php Точка доступа для внешних обращений через API MediaWiki. См. API:Main page и Manual:api.php. Manual:api.php/ruTemplate:Enlink/list1
load.php Скрипт для интерфейсного подключения для загрузки модулей через ResourceLoader. См. также Manual:load.php. Manual:load.php/ruTemplate:Enlink/list1
img_auth.php Сценарий, обеспечивающий доступ к изображениям только авторизованных пользователей. Как настроить вики для использования этого сценария, см. в руководстве Manual:Image Authorisation. См. также Manual:img_auth.php. Manual:img_auth.php/ru /en
opensearch_desc.php Возвращает документ с описанием в формате OpenSearch, описывающий веб-интерфейс поискового модуля MediaWiki. См. также Manual:opensearch_desc.php. Manual:opensearch_desc.php/ru /en
profileinfo.php Позволяет пользователям видеть хранящуюся в базе данных информацию профилирования. См. How to debug#Profiling. См. также Manual:profileinfo.php. Manual:profileinfo.php/ruTemplate:Enlink/list1
redirect.php Сценарий, всего-навсего перенаправляющий на статью, пришедшую в параметре запроса wpDropdown. Требуется для стиля Nostalgia. См. Manual:redirect.php. Manual:redirect.php/ru /en
thumb.php Сценарий, используемый для изменения размеров изображений. См. Manual:thumb.php. Manual:thumb.php/ru /en
thumb_handler.php Access to thumbnails using HTTP-errors (Status Code 404) Manual:thumb_handler.php/ru /en
trackback.php Позволяет добавлять в базу данных trackbacks-уведомления. Удалено начиная с MediaWiki 1.19 (r104051). См. Manual:trackback.php. Manual:trackback.php/ru /en

Папка /includes/[edit]

Эта папка содержит все файлы, требуемые MediaWiki.

Файл Описание
includes/Article.php Содержит класс Article, обеспечивающий методы просмотра, изменения и управления статьями. Это поддерживает функции вики-страниц для обратной совместимости. См. Manual:Article.php. Manual:Article.php/ru /en
includes/Defines.php Defines several constants, suchs as those for namespaces, which are used by other files and classes. Manual:Defines.php/ru /en
includes/EditPage.php Provides much of the code related to the editing user interface Manual:EditPage.php/ru /en
includes/GlobalFunctions.php Содержит глобально используемые функции типа wfMsgExt. См. Manual:GlobalFunctions.php. Manual:GlobalFunctions.php/ru /en
includes/Linker.php Содержит методы для создания внутренних и внешних ссылок, а также ссылок на изображения; осуществляет обнаружение существующих страниц. См. Manual:Linker.php. Manual:Linker.php/ru /en
includes/OutputPage.php Содержит результат парсинга HTML и викитекста. Может также гененрировать элемент <head> или его часть. Manual:OutputPage.php. Manual:OutputPage.php/ru /en
includes/Pager.php Содержит класс IndexPager, используемый для подкачки результатов запросов MySQL. См. Manual:Pager.php. Manual:Pager.php/ru /en
includes/Parser.php Этот файл описывает объект парсера, используемый для конвертации викитекста в HTML (хотя и несколько фрагментов есть и в Manual:Skin.php.). См. Manual:Parser.php. Manual:Parser.php/ruTemplate:Enlink/list1
includes/Setup.php Включает некоторые часто используемые файлы и создаёт объекты, определяемые глобальными переменными и обеспечивающие работоспособность MediaWiki. См. Manual:Setup.php. Manual:Setup.php/ruTemplate:Enlink/list1
includes/Skin.php Инкапсулирует «внешний вид» вики-проекта. См. Manual:Skin.php. Manual:Skin.php/ruTemplate:Enlink/list1
includes/SpecialPage.php Содержит класс SpecialPage, являющийся родительским для всех классов служебных страниц. 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:SpecialPage.php and Manual:Special pages. Manual:SpecialPage.php/ru /en
includes/SiteStats.php Содержит класс SiteStats, предназначенный для статистики сайта и всех относящихся к этой области задач Manual:SiteStats.php/ru /en
includes/Title.php Представляет название статьи, и делает всю работу по его преобразованию в различные формы, такие, как простой текст, URL, ключ базы данных и т.д. Для удобства использования, а также по причинам исторического характера, здесь также обрабатываются некоторые особенности статей, не связанные с их текстом, как, например, права доступа. См. Manual:Title.php. Manual:Title.php/ru /en
includes/User.php Инкапсулирует состояние возможности просмотра/использования сайта пользователем. Может быть запрошен относительно таких вещей, как настройки пользователя, его имя и т.д. Обрабатывает детали, чтения из таблицы «user» базы данных и сохранения в неё; имеет дело с сессиями и куками. См. Manual:User.php. Manual:User.php/ru /en
includes/UserMailer.php Collection of static functions for sending mail. See Manual:UserMailer.php. Manual:UserMailer.php/ru /en
includes/WebRequest.php Этот файл содержит описание класса WebRequest. См. Manual:WebRequest.php. Manual:WebRequest.php/ru /en
includes/WebStart.php Выполняет ключевые настройки для веб-запроса: проверки безопасности, загрузка LocalSettings.php и Setup.php. См. Manual:WebStart.php. Manual:WebStart.php/ruTemplate:Enlink/list1
includes/MediaWiki.php Этот файл содержит описание класса MediaWiki. См. Manual:MediaWiki.php. Manual:MediaWiki.php/ru /en
includes/WikiPage.php Contains the WikiPage class, which represents an article in the wiki. Manual:WikiPage.php/ru /en

Папка /includes/actions/[edit]

Эта папка содержит Action классы, которые управляют различными действиями, которые могут быть выполнены над страницами (напр. просмотр, удаление, редактирование, и т.д.). Все эти классы расширяют классы Action, FormlessAction или FormAction. Некоторые из них просто заглушки, которые вызывают методы в Article или EditPage классах для выполнения реальной работы.

Файл Описание
includes/actions/CreditsAction.php Handles formatting the credits for articles. See also Manual:$wgMaxCredits. Manual:CreditsAction.php/ru /en
includes/actions/DeleteAction.php Управляет удалением страницы. Manual:DeleteAction.php/ru /en
includes/actions/EditAction.php Содержит классы EditAction и SubmitAction, которые управляют действиями редактирование и подтверждение. Manual:EditAction.php/ru /en
includes/actions/HistoryAction.php Управляет выводом страницы истории для статьи. Manual:HistoryAction.php/ru /en
includes/actions/InfoAction.php Показывает информацию о странице, типа общее количество правок и число уникальных редакторов. Manual:InfoAction.php/ru /en
includes/actions/MarkpatrolledAction.php Handles marking a revision as patrolled. Manual:MarkpatrolledAction.php/ru /en
includes/actions/ProtectAction.php Управляет защитой страницы. Manual:ProtectAction.php/ru /en
includes/actions/PurgeAction.php Управляет очисткой страницы. Manual:PurgeAction.php/ru /en
includes/actions/RawAction.php Handles the "action=raw" action. Manual:RawAction.php/ru /en
includes/actions/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/ru /en
includes/actions/RevertAction.php Contains class RevertFileAction, which handles reverting a file. Manual:RevertAction.php/ru /en
includes/actions/RevisiondeleteAction.php Управляет действием удаление ревизии, просто помещая запрос в Special:RevisionDelete. Manual:RevisiondeleteAction.php/ru /en
includes/actions/RollbackAction.php Управляет откатом содержимого страницы. Manual:RollbackAction.php/ru /en
includes/actions/ViewAction.php Handles the viewing of a page, by calling Article::view(). Manual:ViewAction.php/ruTemplate:Enlink/list1
includes/actions/WatchAction.php Contains classes WatchAction and UnwatchAction, which handle watching and unwatching a page. Manual:WatchAction.php/ru /en

Папка /includes/api/[edit]

Эта папка содержит код для MediaWiki API. See API:Main page. Наиболее важные файлы:

Файл Описание
includes/api/ApiBase.php The base class for all API classes. Has a lot of common code for all API actions. Inherits class ContextSource Manual:ApiBase.php/ruTemplate:Enlink/list1
includes/api/ApiFormatBase.php The base class for all formatting classes. Inherits ApiBase. Manual:ApiFormatBase.php/ruTemplate:Enlink/list1
includes/api/ApiQueryBase.php The base class for all query API classes. Inherits ApiBase. Manual:ApiQueryBase.php/ruTemplate:Enlink/list1

Папка /includes/cache/[edit]

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

Файл Описание
cache/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/ru /en
cache/GenderCache.php Caches user genders when needed to use correct namespace aliases. Manual:GenderCache.php/ru /en
cache/HTMLCacheUpdate.php Invalidates the HTML cache of all the pages linking to a given title. Manual:HTMLCacheUpdate.php/ru /en
HTMLFileCache.php File based caching of HTML pages. Manual:HTMLFileCache.php/ru /en
cache/LinkBatch.php The LinkBatch class represents a list of titles. Manual:LinkBatch.php/ru /en
cache/LinkCache.php Caching for article titles (prefixed DB keys) and ids linked from one source. See also LINKCACHE.TXT. Manual:LinkCache.php/ru /en
cache/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/ru /en
cache/MessageCache.php Performs various MediaWiki namespace-related functions. Manual:MessageCache.php/ru /en
cache/ObjectFileCache.php File based caching of objects. Manual:ObjectFileCache.php/ru /en
cache/ResourceFileCache.php File based caching of JavaScript and CSS resources. Manual:ResourceFileCache.php/ru /en
cache/SquidUpdate.php Handles purging appropriate Squid URLs given a title (or titles). Manual:SquidUpdate.php/ru /en

Папка /includes/context/[edit]

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.

Файл Описание
includes/context/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/ru /en
includes/context/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/ru /en
includes/context/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/ru /en
includes/context/RequestContext.php A RequestContext object groups all the pieces relevant to the context of a request into one instance. Manual:RequestContext.php/ruTemplate:Enlink/list1

Папка /includes/db/[edit]

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

Папка /includes/diff/[edit]

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.

Файл Описание
includes/diff/DairikiDiff.php The DairikiDiff engine. Currently the standard diff engine. The file defines several related classes. Manual:DairikiDiff.php/ru /en
includes/diff/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/ru /en
includes/diff/WikiDiff3.php Another diff engine. Currently not in use. Manual:WikiDiff3.php/ru /en

Папка /includes/job/[edit]

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.

Файл Описание
includes/job/DoubleRedirectJob.php Job to fix double redirects after moving a page Manual:DoubleRedirectJob.php/ru /en
includes/job/EnotifNotifyJob.php Job for email notification. Manual:EnotifNotifyJob.php/ru /en
includes/job/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/ru /en
includes/job/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/ru /en
includes/job/UploadFromUrlJob.php Job for asynchronous upload-by-url. Its an interface to the UploadFromUrl class in /includes/upload/UploadFromUrl.php. Manual:UploadFromUrlJob.php/ruTemplate:Enlink/list1

Папка /includes/logging/[edit]

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.

Файл Описание
includes/logging/LogEntry.php Contains the LogEntry interface and some classes implementing this interface to encapsulate log entries. Introduced in MW 1.19. Manual:LogEntry.php/ru /en
includes/logging/LogEventsList.php A class to list log entries. Manual:LogEventsList.php/ruTemplate:Enlink/list1
includes/logging/LogFormatter.php Contains several classes for formatting log entries. Introduced in MW 1.19. Manual:LogFormatter.php/ruTemplate:Enlink/list1
includes/logging/LogPage.php Class to manage a log: add entries to the log and extract information from the log. Manual:LogPage.php/ru /en
includes/logging/LogPager.php Class to list log entries. Implements the ReverseChronologicalPager class. Manual:LogPager.php/ru /en
includes/logging/PatrolLog.php Class containing static functions for working with logs of patrol events. Manual:PatrolLog.php/ru /en

Папка /includes/media/[edit]

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

Папка /includes/normal/[edit]

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

Папка /includes/objectcache/[edit]

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.

Файл Описание
includes/objectcache/APCBagOStuff.php Implementation of BagOStuff for APC's shared memory functions. Manual:APCBagOStuff.php/ru /en
includes/objectcache/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/ru /en
includes/objectcache/DBABagOStuff.php Implementation of BagOStuff which uses PHP's DBA extension as a backend. Manual:DBABagOStuff.php/ru /en
includes/objectcache/EhcacheBagOStuff.php Implementation of BagOStuff using the Ehcache RESTful web service. Manual:EhcacheBagOStuff.php/ru /en
includes/objectcache/EmptyBagOStuff.php Emulates an empty BagOStuff. Manual:EmptyBagOStuff.php/ru /en
includes/objectcache/MemcachedClient.php Contains the MWMemcached class, a PHP memcache client. Manual:MemcachedClient.php/ru /en
includes/objectcache/MemcachedPhpBagOStuff.php Implementation of BagOStuff using memcached. It uses the MWMemcached class as a pure PHP memcached client. Manual:MemcachedPhpBagOStuff.php/ru /en
includes/objectcache/MultiWriteBagOStuff.php Implementation of BagOStuff that replicates all writes to multiple child caches. Manual:MultiWriteBagOStuff.php/ru /en
includes/objectcache/ObjectCache.php The ObjectCache class contains some static helper functions for caching objects. Manual:ObjectCache.php/ru /en
includes/objectcache/SqlBagOStuff.php Implementation of BagOStuff using a database. Manual:SqlBagOStuff.php/ru /en
includes/objectcache/inCacheBagOStuff.php Implementation of BagOStuff using WinCache. Manual:inCacheBagOStuff.php/ru /en
includes/objectcache/CacheBagOStuff.php Implementation of BagOStuff using XCache. Manual:CacheBagOStuff.php/ru /en

Папка /includes/parser/[edit]

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

Файл Описание
includes/parser/CoreParserFunctions.php A collection of functions which implement the core parser functions. Manual:CoreParserFunctions.php/ru /en
includes/parser/CoreTagHooks.php Tag hooks provided by MediaWiki core, e.g. <nowiki>, <gallery>, <pre>, .. Manual:CoreTagHooks.php/ruTemplate:Enlink/list1
includes/parser/LinkHolderArray.php A LinkHolderArray holds a set of replacement pairs for wiki links. Manual:LinkHolderArray.php/ru /en
includes/parser/Parser.php This file contains the parser. A few regular expressions are included. See Manual:Parser.php. Manual:Parser.php/ruTemplate:Enlink/list1
includes/parser/ParserCache.php This class handles caching the output from the parser. Manual:ParserCache.php/ru /en
includes/parser/ParserOptions.php The ParserOptions class holds a collection of options for the parser. Manual:ParserOptions.php/ru /en
includes/parser/ParserOutput.php Contains the ParserOutput class, which encapsulates the output of the parser. Manual:ParserOutput.php/ru /en
includes/parser/Preprocessor.php Contains the Preprocessor interface for preprocessors. Also contains the PPFrame and PPNode interfaces. Manual:Preprocessor.php/ru /en
includes/parser/Preprocessor_DOM.php A preprocessor using PHP's DOM extension. See Manual:Preprocessor_DOM.php. This preprocessor is used if the PHP DOM extension is available. Manual:Preprocessor_DOM.php/ru /en
includes/parser/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/ru /en
includes/parser/Preprocessor_HipHop.php A preprocessor optimised for HipHop, using HipHop-specific syntax. Manual:Preprocessor_HipHop.php/ru /en

Папка /includes/resourceloader/[edit]

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

Папка /includes/search/[edit]

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

Файл Описание
includes/search/SearchEngine.php Contains several classes related to searching a wiki. The SearchEngine class is the parent class for specific search implementations. Manual:SearchEngine.php/ru /en
includes/search/SearchIBM_DB2.php Implements SearchEngine using IBM DB2. Manual:SearchIBM_DB2.php/ru /en
includes/search/SearchMssql.php Implements SearchEngine using Msssql. Manual:SearchMssql.php/ru /en
includes/search/SearchMySQL.php Implements SearchEngine using a MySQL search engine. Manual:SearchMySQL.php/ru /en
includes/search/SearchOracle.php Implements SearchEngine using Oracle (ConText). Manual:SearchOracle.php/ru /en
includes/search/SearchSqlite.php Implements SearchEngine using SQLite. Manual:SearchSqlite.php/ru /en

Папка /includes/specials/[edit]

This directory contains the code and classes for the standard special pages. All special page classes derive from class SpecialPage (defined in includes/SpecialPage.php). Special pages which come with extension are located in their respective extensions directories. See also Manual:Special pages.

Папка /includes/upload/[edit]

Files providing the backend of MediaWiki's file uploads.

Файл Описание
includes/upload/UploadBase.php UploadBase and subclasses are the backend of MediaWiki's file uploads. Manual:UploadBase.php/ru /en
includes/upload/UploadFromChunks.php Subclass of UploadBase implementing uploading from chunks. Manual:UploadFromChunks.php/ru /en
includes/upload/UploadFromFile.php Subclass of UploadBase implementing regular file uploads. Manual:UploadFromFile.php/ru /en
includes/upload/UploadFromStash.php Subclass of UploadBase implementing uploading from previously stored file. Manual:UploadFromStash.php/ru /en
includes/upload/UploadFromUrl.php Subclass of UploadBase implementing uploading from a HTTP resource. Manual:UploadFromUrl.php/ru /en
includes/upload/UploadStash.php Provides the possibility to enable applications to temporarily stash files without publishing them to the wiki. Manual:UploadStash.php/ru /en

Папка /languages/[edit]

Эта папка содержит файлы, используемые для локализации и организации многоязычных проектов. Получить быстрый обзор можно на стр. Language in MediaWiki.

Файл Описание
languages/Language.php Содержит класс Language, определяющий язык для отображения служебных текстов, а также включающий ряд функций для поддержки различных кодировок символов и другие элементы локализации. Две глобальные переменные содержат экземпляр этого класса: $wgContLang, определяющая язык сайта, и $wgLang, определяющая язык интерфейса пользователя. Manual:Language.php/ru /en

Папка /maintenance/[edit]

Эта папка содержит сервисные сценарии (скрипты), которые должны запускаться из интерфейса командной строки.

См. обзор этих сценариев в Manual:Maintenance scripts.

Папка /resources/[edit]

Эта папка содержит используемые MediaWiki ресурсы JavaScript и таблицы стилей CSS, включая jQuery.

Папка /skins/[edit]

Эта папка содержит все классы стилей оформления, сценарии на языке JavaScript, таблицы стилей CSS и некоторые файлы изображений, используемых в оформлении. См. Manual:Skins.

Папка /tests/[edit]

Содержит различные относящиеся к файлам (юнит-)тесты, включая:

Другие языки: English  • Deutsch • français • Bahasa Indonesia • 日本語 • português do Brasil • русский • 中文