Jump to content

Manual:$wgServer

From mediawiki.org
Server URLs and file paths: $wgServer
The base URL of the server.
Introduced in version:Before 1.1.0
Removed in version:Still in use
Allowed values:(URL prefix (protocol, host, optionally with port; no path portion))
Default value:(see below)

Details

This variable is normally set by the MediaWiki installer, but may need to be adjusted after your LocalSettings.php is generated.

The base URL of the server, including protocol but without the trailing slash and without the subdirectory if any (e.g., https://www.mediawiki.org). Since version 1.18.0 MediaWiki also supports setting $wgServer to a protocol-relative URL (e.g., //www.mediawiki.org). This is used for supporting both HTTP and HTTPS with the same caches by using links that work under both protocols. When doing this, $wgCanonicalServer can be used to set the full URL including protocol that will be used in locations such as emails that do not support protocol relative URLs. If the URL starts with https://, MediaWiki will assume that your wiki prefers the HTTPS protocol or supports it exclusively. In that case, you should also set $wgForceHTTPS . See Manual:HTTPS for more information.

The setting to this configuration parameters is used when producing fully-qualified URLs pointing to the wiki, for instance:

  • HTTP redirects on edit and to canonical URL spellings
  • print footer
  • links to articles from RSS/Atom feeds
  • links to articles from notification emails
  • and more!
Please make sure that $wgServer is set to your actual base URL and not to http://localhost (unless you actually want to only access MediaWiki through your localhost). Otherwise links will not work.

Autodetection

MediaWiki formerly tried to autodetect the name of the server, however this was vulnerable to cache poisoning attacks, and informally deprecated in 1.18. It was fully removed in MediaWiki 1.34.

Default value

MediaWiki version:
1.34
$wgServer = false;
MediaWiki versions:
1.18 – 1.33
$wgServer = WebRequest::detectServer();
MediaWiki version:
1.17
$wgServer = '';
$wgServer = $wgProto.'://' . $serverName;
MediaWiki versions:
1.4 – 1.16
$wgServer = '';
$wgServer = $wgProto.'://' . $wgServerName;
MediaWiki version:
1.3
$wgServer = $wgProto.'://' . $wgServerName;
MediaWiki version:
1.2
$wgServer           = "http://" . $_SERVER["SERVER_NAME"];
MediaWiki version:
1.1
$wgServer           = "http://" . getenv( "SERVER_NAME" );

See also