View source for Developer hub/yue

You do not have permission to edit this page, for the following reasons:

This page cannot be updated manually. This page is a translation of the page Developer hub and the translation can be updated using the translation tool.
Your IP address is in a range that has been blocked on all Wikimedia Foundation wikis. The block was made by ‪Jon Kolbert‬. The reason given is Open proxy/Webhost: See the help page if you are affected .
- Start of block: 05:35, 21 February 2024
- Expiry of block: 05:35, 21 February 2029
Your current IP address is 3.231.213.240. The blocked range is 3.231.0.0/16. Please include all above details in any queries you make. If you believe you were blocked by mistake, you can find additional information and instructions in the No open proxies global policy. Otherwise, to discuss the block please post a request for review on Meta-Wiki. You could also send an email to the stewards VRT queue at stewards@wikimedia.org including all above details.

You can view and copy the source of this page.

<languages/>
{{TOCright}}
{{Hubs|none|dev=y}}

<div lang="en" dir="ltr" class="mw-content-ltr">
'''This is a high-level overview of MediaWiki development''', including links to the key documents, resources and tools available to MediaWiki developers. It is written '''for skilled [[w:LAMP (software bundle)|LAMP]] developers who have experience using MediaWiki'''.
</div>

* <span lang="en" dir="ltr" class="mw-content-ltr">If you want to ''use'' Wikimedia web APIs, visit [https://developer.wikimedia.org/use-content/ the Developer Portal].</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">If you want to contribute to developing Wikimedia software, see {{ll|New Developers}}.</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">For an introductory guide to developing MediaWiki and MediaWiki extensions, read {{ll|How to become a MediaWiki hacker}}.</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">If you want to collaborate with other third-party MediaWiki users, the {{ll|MediaWiki Stakeholders' Group}} (MWStake) is a MediaWiki [[Special:MyLanguage/Groups|user group]] consisting of MediaWiki developers, system administrators, users, consultants, and hosting providers.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Overview==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
MediaWiki is the software that powers Wikipedia, its sister projects and thousands of wikis all over the world.
</div>

<span lang="en" dir="ltr" class="mw-content-ltr">MediaWiki is written in the [https://php.net PHP] programming language.<ref>Not all of MediaWiki is written in PHP. Some supporting tools are written in other languages, including [[w:Batch files|batch files]], [[w:Shell script|shell scripts]], [[w:Makefile|makefiles]] and [[w:Python (programming language)|Python]].</ref></span>
<span lang="en" dir="ltr" class="mw-content-ltr">It uses jQuery as the client JavaScript library.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">MediaWiki is primarily written for the [[w:LAMP_(software_bundle)|LAMP platform]]<ref>MediaWiki runs on most platforms that can support PHP, however, the lack of certain utilities or operating system features may limit the functionality or performance of MediaWiki on non-LAMP platforms.</ref> and runs on most operating systems.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">MediaWiki primarily uses the MySQL and MariaDB database servers.<ref>MediaWiki has support for [[w:DBMS|DBMS]] other than [[w:MySQL|MySQL]] and [[w:MariaDB|MariaDB]], including [[w:PostgreSQL|PostgreSQL]] and [[w:SQLite|SQLite]].</ref></span>

<div lang="en" dir="ltr" class="mw-content-ltr">
Development happens in an [[w:Open Source|open source]] style<ref>Developers are a mix of volunteers and paid staff (or contractors) for various organizations. For a full list of who works on the MediaWiki code, read the {{ll|Developers}} article.</ref>, is largely coordinated online, and supported by the Wikimedia Foundation, though volunteer community developers play a huge part as well.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* '''Development discussion''' happens on various [[Special:MyLanguage/Mailing lists|mailing lists]] and [[Special:MyLanguage/MediaWiki on IRC|IRC channels]].
</div> <span lang="en" dir="ltr" class="mw-content-ltr">The main developer list is [[mail:wikitech-l|wikitech-l]]. The main developer IRC channel is {{irc|mediawiki}}.</span>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''Source code''' is managed using the [[w:Git|Git]] version control system.
</div><ref>
<span lang="en" dir="ltr" class="mw-content-ltr">Browse the source code and revisions of code repositories in [https://gerrit.wikimedia.org/g/ Gerrit] or download the source code to your system by using {{ll|Gerrit}}.</span>
</ref>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''Code review''' for most projects is performed on {{ll|Gerrit}}. [[Gerrit/Tutorial|Follow this tutorial]] to set up Git and Gerrit in order to submit patches.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''Bug reports''' and tasks for most projects are managed on {{ll|Phabricator}}.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* Developers '''extending''' or '''interfacing''' with MediaWiki (instead of working on the core code) have several convenient extension points, including the '''[[Special:MyLanguage/API:Main page|API]]''', the '''[[Special:MyLanguage/Manual:Hooks|Hooks]]''' system and '''[[Special:MyLanguage/Manual:Skins|Skins]]''' – see the [[#Extending MediaWiki|#Extending MediaWiki]] section of this page for an overview.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Key documents==
</div>

{{ContentGrid
|content=
<!--
nowiki markers are added so the first bullet in the list are rendered correctly!
please don't remove those markers, thank you
-->
{{InfoCard
|heading = <span lang="en" dir="ltr" class="mw-content-ltr">Code, development and style</span>
|content=<nowiki/>
* '''{{ll|Development policy}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">an overview of key development policies.</span>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''[[Special:MyLanguage/Manual:Coding conventions|Coding conventions]]''' – learn how to write code in the MediaWiki style.
</div>
* '''{{ll|Security for developers}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">learn how to help keep MediaWiki secure.</span>
* '''{{ll|Manual:Pre-commit checklist}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">read this checklist before committing code.</span>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''[[Special:MyLanguage/Gerrit/Code review|Code review guide]]''' – a guide for reviewers of commits to the MediaWiki source code.
</div>
* '''{{ll|Technical Decision Making Process}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">read about the process to decide on making larger technical changes.</span>
}}

{{InfoCard
|heading = 搵錯同測試
|content =<nowiki/>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''[[Special:MyLanguage/Manual:How to debug|How to debug]]''' – a guide to debugging MediaWiki.
</div>
* '''{{ll|Manual:Errors and symptoms}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">an overview of common MediaWiki errors and their correlating symptoms.</span>
* '''{{ll|Selenium|2=<span lang="en" dir="ltr" class="mw-content-ltr">Browser testing</span>}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">learn to write UI tests for MediaWiki using Selenium.</span>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''[[Special:MyLanguage/Manual:Unit testing|Unit testing]]''' – learn to write unit tests for MediaWiki using PHPUnit.
</div>
* '''{{ll|MediaWiki API Integration Tests|2=<span lang="en" dir="ltr" class="mw-content-ltr">API integration tests</span>}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">learn to write API integration tests for MediaWiki using Mocha.</span>
* '''{{ll|Security for developers}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">learn how to write secure code.</span>
}}

{{InfoCard
|heading=<span lang="en" dir="ltr" class="mw-content-ltr">Architecture</span>
|content=<nowiki/>
* '''{{ll|Manual:MediaWiki architecture|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">an introduction to MediaWiki's architecture.</span>
* '''{{ll|Manual:Code}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">an overview of the key parts of MediaWiki's source code.</span>
* '''{{ll|Manual:Database layout}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">an overview of MediaWiki's database schemas.</span>
* '''{{ll|Manual:Global object variables}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">a partial list of key global variables.</span>
* '''{{ll|Localisation}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">learn about MediaWiki's internationalisation system.</span>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''[[Special:MyLanguage/Manual:Contents|Manual]]''' namespace on this wiki – documentation for developers.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
* '''[https://doc.wikimedia.org/mediawiki-core/master/php/ MediaWiki Class Reference]''' – technical documentation generated from the MediaWiki source code. ('''Note:''' The class reference is a large, slow-to-load page.)
</div>
}}

{{InfoCard
|heading =<span lang="en" dir="ltr" class="mw-content-ltr">Sub-systems</span>
|content=<nowiki/>
* '''[[Special:MyLanguage/API:Main page|API]]''' - 外部嘅API用來畀直接嘅資料層存取
* '''{{ll|Manual:ContentHandler|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">MediaWiki's framework for supporting custom types of page content.</span>
* '''{{ll|Manual:Database access|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">an overview of using databases in MediaWiki, including a brief guide to the database abstraction layer.</span>
* '''{{ll|Manual:Job queue|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">MediaWiki's framework for processing long-running tasks asynchronously.</span>
* '''{{ll|Manual:Messages API|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">MediaWiki's framework for providing localized application messages with PHP or JavaScript.</span>

}}
}}

<span id="Extending_MediaWiki"></span>
== 擴充MediaWiki ==

<div lang="en" dir="ltr" class="mw-content-ltr">
MediaWiki has been designed to allow for modification without changing the "core code". This makes it easy to update to a new version of MediaWiki without having to manually merge in old extension code changes. There are six main extension points that allow developers to change or extend what MediaWiki can do. The extension points are:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* '''[[Special:MyLanguage/API:Action API|API]]''' – access the data and metadata of MediaWiki instances through its web API.
</div>
* '''{{ll|Manual:Hooks|nsp=0}}''' – 可以響寫擴展嗰陣用來掛住嘅軟件鈎。
* '''{{ll|Manual:Parser functions|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">create a new command like: <code><nowiki>{{#if:...|...|...}}</nowiki></code>.</span>
* '''{{ll|Manual:Skins|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">change the look and feel of MediaWiki.</span>
* '''{{ll|Manual:Special pages|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">add a new special page.</span>
* '''{{ll|Manual:Tag extensions|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">create a new tag like: {{tag|newtag}}.</span>
* '''{{ll|Manual:Extending wiki markup|nsp=0}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">add a parser hook to modify the content of wikitext.</span>

{{ContentGrid
|content =

{{InfoCard
|heading=<span lang="en" dir="ltr" class="mw-content-ltr">Help for extension developers</span>
|content=<nowiki/>
* '''{{ll|Manual:Developing extensions}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">a guide to developing extensions.</span>
* '''{{ll|Extensions FAQ}}'''
* <span lang="en" dir="ltr" class="mw-content-ltr">See {{ll|Category:Extensions}}, for a list of extensions.</span>
* '''{{ll|Extension:BoilerPlate}}''' - <span lang="en" dir="ltr" class="mw-content-ltr">a blank extension template.</span>
}}

{{InfoCard
|heading=<span lang="en" dir="ltr" class="mw-content-ltr">Help for skin developers</span>
|content=<nowiki/>
* '''{{ll|Manual:How to make a MediaWiki skin}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">instructions on how to create a skin for MediaWiki.</span>
* '''{{ll|Manual:Skin configuration}}''' – <span lang="en" dir="ltr" class="mw-content-ltr">a guide to configuring skins for a wiki.</span>
}}

{{InfoCard
|heading=<span lang="en" dir="ltr" class="mw-content-ltr">Help for library code reuse</span>
|content=<nowiki/>
* {{ll|Manual:Developing libraries}} – <span lang="en" dir="ltr" class="mw-content-ltr">a guide to packaging third-party libraries for use with MediaWiki</span>
}}

}}
<div lang="en" dir="ltr" class="mw-content-ltr">
==Notes==
</div>
<references />

[[Category:MediaWiki development{{#translation:}}|*Developer hub]]
[[Category:New contributors{{#translation:}}]]

Templates used on this page:

Template:ContentGrid (edit)
Template:ContentGrid/styles.css (edit)
Template:Dir (view source) (semi-protected)
Template:Hubs (view source) (protected)
Template:Hubs/styles.css (view source) (protected)
Template:Hubs/yue (edit)
Template:IRC (edit)
Template:IRC/en (edit)
Template:IRC/styles.css (edit)
Template:IRC/yue (edit)
Template:InfoCard (edit)
Template:InfoCard/styles.css (edit)
Template:Irc (edit)
Template:Ll (view source) (protected)
Template:Localized link (view source) (protected)
Template:Pagelang (view source) (protected)
Template:TNTN (view source) (semi-protected)
Template:TOC (view source) (semi-protected)
Template:TOCright (edit)
Template:Tag (view source) (semi-protected)
Template:Translatable (view source) (protected)
Template:Translatable/en (edit)
Template:Translatable/yue (edit)
Template:Translatable template name (view source) (semi-protected)
Module:String (view source) (semi-protected)
Module:Template translation (view source) (protected)
Translations:Category:Extensions/Page display title/yue (edit)
Translations:Manual:Code/Page display title/yue (edit)
Translations:Phabricator/Page display title/yue (edit)

Return to Developer hub/yue.

Retrieved from "https://www.mediawiki.org/wiki/Developer_hub/yue"