Mediawiki - Revision history

Johnno: /* Visual Editor */

2026-10-24T16:10:19Z

Visual Editor

← Older revision		Revision as of 16:10, 24 October 2026
Line 44:		Line 44:
	== Visual Editor ==		== Visual Editor ==

	This relies on Parsoid, which used to be a separate Node.js REST service you had to install~~; in 2019 it~~ was rewritten in PHP and is now bundled since version 1.35 of MediaWiki.		This relies on Parsoid, which used to be a separate Node.js REST service you had to install, but was rewritten in PHP and is now bundled since version 1.35 of MediaWiki.

	=== Install the required MediaWiki extensions ===		=== Install the required MediaWiki extensions ===
Line 50:		Line 50:
	Install the Visual Editor extension and its dependent extension (UniversalLanguageSelector):		Install the Visual Editor extension and its dependent extension (UniversalLanguageSelector):

	git submodule add -b ~~REL1_35~~ <nowiki>https://gerrit.wikimedia.org/r/mediawiki/extensions/VisualEditor</nowiki> extensions/VisualEditor		git submodule add -b REL1_43 <nowiki>https://gerrit.wikimedia.org/r/mediawiki/extensions/VisualEditor</nowiki> extensions/VisualEditor
	git submodule add -b ~~REL1_35~~ <nowiki>https://gerrit.wikimedia.org/r/mediawiki/extensions/UniversalLanguageSelector</nowiki> extensions/UniversalLanguageSelector		git submodule add -b REL1_43 <nowiki>https://gerrit.wikimedia.org/r/mediawiki/extensions/UniversalLanguageSelector</nowiki> extensions/UniversalLanguageSelector
	git submodule update --init --recursive extensions/VisualEditor extensions/UniversalLanguageSelector		git submodule update --init --recursive extensions/VisualEditor extensions/UniversalLanguageSelector

Johnno: /* Installation */

2026-10-24T16:08:33Z

Installation

← Older revision		Revision as of 16:08, 24 October 2026
Line 3:		Line 3:
	Check [https://www.mediawiki.org/wiki/Compatibility compatibility with PHP] and install the latest version of PHP you can.		Check [https://www.mediawiki.org/wiki/Compatibility compatibility with PHP] and install the latest version of PHP you can.

	This assumes Ubuntu 20.04 ~~LTS~~, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites (see the [[PHP]] page for more about how to set up PHP so it sucks less):		This assumes Ubuntu 26.04 or Debian 13 trixie, the new Mediawiki LTS version 1.43 and a passing familiarity with [[Git]]. First, some prerequisites (see the [[PHP]] page for more about how to set up PHP so it sucks less):

	apt-get install git apache2 libapache2-mod-fcgid ~~php7~~.4-curl ~~php7~~.4-fpm ~~php7~~.4-mysql curl		apt-get install git apache2 libapache2-mod-fcgid php8.4-curl php8.4-fpm php8.4-mysql curl

	~~;NOTE: MediaWiki does not (yet) work properly with PHP 8 so we use PHP 7.4 for now.~~

	Now clone Mediawiki with git:		Now clone Mediawiki with git:
Line 33:		Line 31:
	Now when we want an extension, say the ''Cite'' extension, we add the git submodule:		Now when we want an extension, say the ''Cite'' extension, we add the git submodule:

	git submodule add -b ~~REL1_35~~ <nowiki>https://gerrit.wikimedia.org/r/mediawiki/extensions/Cite</nowiki> extensions/Cite		git submodule add -b REL1_43 <nowiki>https://gerrit.wikimedia.org/r/mediawiki/extensions/Cite</nowiki> extensions/Cite
	git submodule update --init --recursive extensions/Cite		git submodule update --init --recursive extensions/Cite

Johnno: /* Upgrading */

2026-10-24T14:00:17Z

Upgrading

← Older revision		Revision as of 14:00, 24 October 2026
Line 121:		Line 121:
	composer update --no-dev		composer update --no-dev
	git submodule update --init --recursive		git submodule update --init --recursive
	sudo -u www-data /usr/bin/php maintenance/update.php		sudo -u www-data /usr/bin/php maintenance/update.php # up to 1.39
			sudo -u www-data /usr/bin/php maintenance/run.php update # 1.40 onwards
	# (look for any new updateXXX.php commands in the maintenance directory)		# (look for any new updateXXX.php commands in the maintenance directory)

Johnno: /* Installation */

2026-10-24T12:49:18Z

Installation

← Older revision		Revision as of 12:49, 24 October 2026
Line 11:		Line 11:
	Now clone Mediawiki with git:		Now clone Mediawiki with git:

	git clone <nowiki>https://gerrit.wikimedia.org/r/mediawiki/core</nowiki>		git clone <nowiki>https://gerrit.wikimedia.org/r/mediawiki/core</nowiki> mediawiki

	Next, we need to pull in PHP library dependencies with [https://getcomposer.org/download/ PHP composer]. First install composer from the download page, then use it to pull dependencies into MediaWiki:		Next, we need to pull in PHP library dependencies with [https://getcomposer.org/download/ PHP composer]. First install composer from the download page, then use it to pull dependencies into MediaWiki:

Johnno: /* Installation */

2026-10-24T12:48:53Z

Installation

← Older revision		Revision as of 12:48, 24 October 2026
Line 11:		Line 11:
	Now clone Mediawiki with git:		Now clone Mediawiki with git:

	git clone <nowiki>https://~~phabricator~~.wikimedia.org/~~source~~/mediawiki~~.git~~</nowiki>		git clone <nowiki>https://gerrit.wikimedia.org/r/mediawiki/core</nowiki>

	Next, we need to pull in PHP library dependencies with [https://getcomposer.org/download/ PHP composer]. First install composer from the download page, then use it to pull dependencies into MediaWiki:		Next, we need to pull in PHP library dependencies with [https://getcomposer.org/download/ PHP composer]. First install composer from the download page, then use it to pull dependencies into MediaWiki:

Johnno: /* Installation */

2026-10-23T22:57:44Z

Installation

← Older revision		Revision as of 22:57, 23 October 2026
Line 1:		Line 1:
	== Installation ==		== Installation ==

			Check [https://www.mediawiki.org/wiki/Compatibility compatibility with PHP] and install the latest version of PHP you can.

	This assumes Ubuntu 20.04 LTS, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites (see the [[PHP]] page for more about how to set up PHP so it sucks less):		This assumes Ubuntu 20.04 LTS, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites (see the [[PHP]] page for more about how to set up PHP so it sucks less):

Johnno: /* Installation */

2021-09-07T22:42:39Z

Installation

← Older revision		Revision as of 22:42, 7 September 2021
Line 3:		Line 3:
	This assumes Ubuntu 20.04 LTS, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites (see the [[PHP]] page for more about how to set up PHP so it sucks less):		This assumes Ubuntu 20.04 LTS, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites (see the [[PHP]] page for more about how to set up PHP so it sucks less):

	apt-get install git apache2 libapache2-mod-~~fcgi~~ php7.4-curl php7.4-fpm php7.4-mysql curl		apt-get install git apache2 libapache2-mod-fcgid php7.4-curl php7.4-fpm php7.4-mysql curl

	;NOTE: MediaWiki does not (yet) work properly with PHP 8 so we use PHP 7.4 for now.		;NOTE: MediaWiki does not (yet) work properly with PHP 8 so we use PHP 7.4 for now.

Johnno: /* Installation */

2021-09-07T22:42:12Z

Installation

← Older revision		Revision as of 22:42, 7 September 2021
Line 1:		Line 1:
	== Installation ==		== Installation ==

	This assumes Ubuntu 20.04 LTS, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites:		This assumes Ubuntu 20.04 LTS, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites (see the [[PHP]] page for more about how to set up PHP so it sucks less):

	apt-get install git apache2 libapache2-mod-php7.4 php7.4-~~curl~~ php7.4-mysql curl		apt-get install git apache2 libapache2-mod-fcgi php7.4-curl php7.4-fpm php7.4-mysql curl

			;NOTE: MediaWiki does not (yet) work properly with PHP 8 so we use PHP 7.4 for now.

	Now clone Mediawiki with git:		Now clone Mediawiki with git:

Johnno: /* Caching */

2021-09-07T22:38:22Z

Caching

← Older revision		Revision as of 22:38, 7 September 2021
Line 84:		Line 84:
	opcache.revalidate_freq=0		opcache.revalidate_freq=0
	opcache.fast_shutdown=0		opcache.fast_shutdown=0

			=== APCu ===

			This is simpler than using Memcache and just as effective.

			apt install php-apcu

			Then add this to LocalSettings.php:

			$wgMainCacheType = CACHE_ACCEL;
			$wgSessionCacheType = CACHE_DB;

	=== MediaWiki file cache ===		=== MediaWiki file cache ===

	Use the [https://www.mediawiki.org/wiki/Manual:File_cache#Operation_and_usage file cache], Luke. It's simple but effective. In <tt>LocalSettings.php</tt>:		Use the [https://www.mediawiki.org/wiki/Manual:File_cache#Operation_and_usage file cache], Luke. It's simple but effective for anonymous users. In <tt>LocalSettings.php</tt>:

	$wgUseFileCache = true;		$wgUseFileCache = true;

Johnno: /* Visual Editor */

2021-09-07T22:32:47Z

Visual Editor

@@ Line 42: / Line 42: @@
 == Visual Editor ==
-=== Install Parsoid ===
+This relies on Parsoid, which used to be a separate Node.js REST service you had to install; in 2019 it was rewritten in PHP and is now bundled since version 1.35 of MediaWiki.
 === Install the required MediaWiki extensions ===
@@ Line 92: / Line 66: @@
     NS_TEMPLATE => false,
     '_merge_strategy' => 'array_plus',
   ];