手册:$wgServer

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:$wgServer and the translation is 42% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎magyar • ‎polski • ‎português do Brasil • ‎български • ‎русский • ‎اردو • ‎العربية • ‎فارسی • ‎中文 • ‎日本語 • ‎한국어
一般设置: $wgServer
服务器的基础URL。
引进版本:pre 1.1.0
移除版本:仍在使用
允许的值:(URL前缀(协议、主机、有时也包含端口;没有路径部分))
默认值:(动态创建)
其他设置: 按首字母排序 | 按功能排序

详情

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). 从1.18版开始,MediaWiki也支持设置$wgServer为协议相对URL(例如//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!

自动检测

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. 适当地配置web服务器总是不错的。 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

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.

参见