RobertBushman at 20:41, 28 September 2023

2023-09-28T20:41:10Z

← Older revision		Revision as of 20:41, 28 September 2023
Line 1:		Line 1:
	[[Category:MediaWiki]]		[[Category:MediaWiki]]
	~~[[Category:Website]]~~

	= Multi-Wiki =		= Multi-Wiki =

RobertBushman: Created page with "Category:MediaWiki Category:Website = Multi-Wiki = == Wiki farm: Practical ==

 $wgLogos = [ 	'1x' => "http://wiki-static.iterativechaos.com/iterative_chaos_logo_004.png", 	'icon' => "http://wiki-static.iterativechaos.com/iterative_chaos_logo_004.png", ]; $wgDBtype = "mysql"; $wgDBserver = "localhost"; $wgDBname = "iterativechaos_wiki"; $wgDBuser = "wiki_wiki";  ## Set $wgCacheDirectory to a writable directory on the web server #$wgCacheDirectory = "$IP/cac..."

2023-09-28T20:40:50Z

Created page with "Category:MediaWiki Category:Website = Multi-Wiki = == Wiki farm: Practical == <pre> $wgLogos = [ '1x' => "http://wiki-static.iterativechaos.com/iterative_chaos_logo_004.png", 'icon' => "http://wiki-static.iterativechaos.com/iterative_chaos_logo_004.png", ]; $wgDBtype = "mysql"; $wgDBserver = "localhost"; $wgDBname = "iterativechaos_wiki"; $wgDBuser = "wiki_wiki"; ## Set $wgCacheDirectory to a writable directory on the web server #$wgCacheDirectory = "$IP/cac..."

New page

[[Category:MediaWiki]]
[[Category:Website]]

= Multi-Wiki =

== Wiki farm: Practical ==
<pre>
$wgLogos = [
'1x' => "http://wiki-static.iterativechaos.com/iterative_chaos_logo_004.png",
'icon' => "http://wiki-static.iterativechaos.com/iterative_chaos_logo_004.png",
];
$wgDBtype = "mysql";
$wgDBserver = "localhost";
$wgDBname = "iterativechaos_wiki";
$wgDBuser = "wiki_wiki";

## Set $wgCacheDirectory to a writable directory on the web server
#$wgCacheDirectory = "$IP/cache";
NO ENTRY FOR: $wgUploadDirectory = "$IP/images/$wgDBname";
NO ENTRY FOR: $wgUploadPath = "/w/images/$wgDBname";
## $IP is Install Path
</pre>

The following steps are for running multiple wikis on same version of MediaWiki:

# Install the first wiki as normal. For details, see Manual:Installation guide.
# Enable your web server to share your MediaWiki install with all wikis. For multiple (sub)domains, you can use listen on multiple server names. For multiple subdirectories, you could use rewrite rules, aliases, or symlinks.
# Add code to the top of <code>LocalSettings.php</code>, to detect the current wiki. Note that if the argument to <code>--wiki</code> contains a hyphen, the argument will be split on the hyphen and the resulting two values assigned to <code>MW_DB</code> and <code>MW_PREFIX</code>, respectively. For wikis by domain name:<syntaxhighlight lang="php">
$wikis = [
'wiki.iterativechaos.com' => 'wiki',
'mw.iterativechaos.com' => 'mediawiki',
];
if ( defined( 'MW_DB' ) ) {
// Automatically set from --wiki option to maintenance scripts
$wikiID = MW_DB;
} else {
// Use MW_DB environment variable or map the domain name
$wikiID = $_SERVER['MW_DB'] ?? $wikis[ $_SERVER['SERVER_NAME'] ?? '' ] ?? null;
if ( !$wikiID ) {
die( 'Unknown wiki.' );
}
}

$wgLocalDatabases = $wgConf->wikis = array_values( $wikis );
$wgDBname = $wikiID;
$wgDBuser = 'mediawiki';
</syntaxhighlight>
# Configure settings that must differ for all wikis. For example:<syntaxhighlight lang="php">
$wgCacheDirectory = "/tmp/mediawiki_cache/$wgDBname";
$wgUploadDirectory = "$IP/images/$wgDBname";
$wgUploadPath = "/w/images/$wgDBname";
</syntaxhighlight>
# Configure per-wiki overrides. This should include at least {{phpi|$wgServer}} and {{phpi|$wgArticlePath}}.<syntaxhighlight lang="php">
$wgConf->settings = [
'wgServer' => [
'examplewiki' => 'https://example.org',
'onewiki' => 'https://one.example.org',
],
'wgArticlePath' => [
'default' => '/wiki',
],
'wgSitename' => [
'default' => 'Example',
'onewiki' => 'One',
],
'wgLogo' => [
'default' => '/images/examplewiki/Example_logo.png',
],
'wgLanguageCode' => [
'default' => 'en',
'onewiki' => 'pt',
],
];
extract( $wgConf->getAll( $wgDBname ) );
</syntaxhighlight>This could be done from a separate file, e.g.:<syntaxhighlight lang="php">
# LocalSettings.php
$wgConf->settings = require __DIR__ . '/LocalSettings_overrides.php';

# LocalSettings_overrides.php
return [
'wgServer' => ..,
..,
];
</syntaxhighlight>

To create a new wiki, create its database and add its settings first, and then run <code>php maintenance/update.php --wiki=mywiki</code>.

== Wiki farm ==

The following steps are for running multiple wikis on same version of MediaWiki:

# Install the first wiki as normal. For details, see Manual:Installation guide.
# Enable your web server to share your MediaWiki install with all wikis. For multiple (sub)domains, you can use listen on multiple server names. For multiple subdirectories, you could use rewrite rules, aliases, or symlinks.
# Add code to the top of <code>LocalSettings.php</code>, to detect the current wiki. Note that if the argument to <code>--wiki</code> contains a hyphen, the argument will be split on the hyphen and the resulting two values assigned to <code>MW_DB</code> and <code>MW_PREFIX</code>, respectively. For wikis by domain name:<syntaxhighlight lang="php">
$wikis = [
'example.org' => 'examplewiki',
'one.example.org' => 'onewiki',
];
if ( defined( 'MW_DB' ) ) {
// Automatically set from --wiki option to maintenance scripts
$wikiID = MW_DB;
} else {
// Use MW_DB environment variable or map the domain name
$wikiID = $_SERVER['MW_DB'] ?? $wikis[ $_SERVER['SERVER_NAME'] ?? '' ] ?? null;
if ( !$wikiID ) {
die( 'Unknown wiki.' );
}
}

$wgLocalDatabases = $wgConf->wikis = array_values( $wikis );
$wgDBname = $wikiID;
$wgDBuser = 'mediawiki';
</syntaxhighlight>
# Configure settings that must differ for all wikis. For example:<syntaxhighlight lang="php">
$wgCacheDirectory = "/tmp/mediawiki_cache/$wgDBname";
$wgUploadDirectory = "$IP/images/$wgDBname";
$wgUploadPath = "/w/images/$wgDBname";
</syntaxhighlight>
# Configure per-wiki overrides. This should include at least {{phpi|$wgServer}} and {{phpi|$wgArticlePath}}.<syntaxhighlight lang="php">
$wgConf->settings = [
'wgServer' => [
'examplewiki' => 'https://example.org',
'onewiki' => 'https://one.example.org',
],
'wgArticlePath' => [
'default' => '/wiki',
],
'wgSitename' => [
'default' => 'Example',
'onewiki' => 'One',
],
'wgLogo' => [
'default' => '/images/examplewiki/Example_logo.png',
],
'wgLanguageCode' => [
'default' => 'en',
'onewiki' => 'pt',
],
];
extract( $wgConf->getAll( $wgDBname ) );
</syntaxhighlight>This could be done from a separate file, e.g.:<syntaxhighlight lang="php">
# LocalSettings.php
$wgConf->settings = require __DIR__ . '/LocalSettings_overrides.php';

# LocalSettings_overrides.php
return [
'wgServer' => ..,
..,
];
</syntaxhighlight>

To create a new wiki, create its database and add its settings first, and then run <code>php maintenance/update.php --wiki=mywiki</code>.

== Separate settings files ==

This approach is for operating entirely independent wikis, but still sharing the same web server and MediaWiki source code.

# Install the first wiki as normal, via the web or CLI installer, which sets up your database and generates a LocalSettings.php file.

# After installation, rename the generated <code>LocalSettings.php</code> file to include the wiki ID (e.g. database name), like <code>LocalSettings_mywiki.php</code>.

# Repeat step one and two above for each wiki you wish to create.

# Create a new <code>LocalSettings.php</code> file that will load the correct one. As with the above wiki farm example, a <code>--wiki</code> argument containing a hyphen will be split on the hyphen into two values assigned to <code>MW_DB</code> and <code>MW_PREFIX</code>, respectively.

<syntaxhighlight lang="php">
<?php
$wikis = [
'example.org' => 'examplewiki',
'one.example.org' => 'onewiki',
];
if ( defined( 'MW_DB' ) ) {
// Automatically set from --wiki option to maintenance scripts
$wikiID = MW_DB;
} else {
// Use MW_DB environment variable or map the domain name
$wikiID = $_SERVER['MW_DB'] ?? $wikis[ $_SERVER['SERVER_NAME'] ?? '' ] ?? null;
}

if ( $wikiID ) {
require_once "LocalSettings_$wikiID.php";
} else {
die( 'Unknown wiki.' );
}

// Add any settings that should apply to all wikis below this line
// -------
</syntaxhighlight>

If your wikis are on the same domain but under different paths (e.g. <code>example.org/wiki1</code>, <code>example.org/wiki2</code> etc.), you can use something like this:

<syntaxhighlight lang="php">
<?php
$wikis = [
'/example' => 'examplewiki',
'/w_example' => 'examplewiki',
'/one' => 'onewiki',
'/w_one' => 'onewiki',
];
if ( defined( 'MW_DB' ) ) {
// Automatically set from --wiki option to maintenance scripts.
$wikiID = MW_DB;
} else {
$path = explode( '/', $_SERVER['REQUEST_URI'] ? '', 3 )[1] ?? '';
$wikiID = $_SERVER['MW_DB'] ?? $wikis[ $path ] ?? null;
}

if ( $wikiID ) {
require_once "LocalSettings_$wikiID.php";
} else {
die( 'Unknown wiki.' );
}
</syntaxhighlight>

Note: If you use [[Special:MyLanguage/Manual:Short URL|Short URL]], you need to add both your $wgArticlePath and the $wgScriptPath

MultiWiki - Revision history

RobertBushman at 20:41, 28 September 2023