Manual:$wgServer

From MediaWiki.org
Jump to navigation Jump to search

Other languages:
العربية • ‎български • ‎Deutsch • ‎English • ‎español • ‎فارسی • ‎français • ‎日本語 • ‎polski • ‎português do Brasil • ‎русский • ‎اردو • ‎中文
General Settings: $wgServer
The base URL of the server.
Introduced in version: pre 1.1.0
Removed in version: still in use
Allowed values: URL prefix (protocol, host, optionally with port; no path portion)
Default value: dynamically created
Other settings: Alphabetical | By function

Details[edit]

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.

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 e-mails
  • and more!
Please make sure that $wgServer is not set to http://localhost or //localhost! If it is, a number of things will break, e.g. links inside your wiki will not work, stylesheets will not display properly and many more. Set it to the actual base URL instead!

Autodetection[edit]

When $wgServer is not set, the default value is calculated automatically. Some web servers end up returning silly defaults or internal names which aren't what you want; for instance the ServerName directive in Apache's httpd.conf may not be set or detected properly by the system, leaving you with an unexpected http://localhost. It's always good to configure the web server properly. But you anyway are always strongly recommended to set $wgServer explicitly in your LocalSettings.php as there are other bugs that may arise from allowing it to be auto-detected, such as pollution of the MediaWiki cache.

Universal value[edit]

In situations where a server URL is subject to change (i.e. frequent Mediawiki installation porting, intranet access, etc.), setting $wgServer to ./ will work without causing CSS not to work.

See also[edit]