配置MW：短链接

关于

短链接，顾名思义，相较于一长串字母的、毫无意义的、复杂的网址，短链接（如：“http://wiki.eijux.com/首页”）更易于理解、记忆、管理。

短 URL 或 URL 重写会隐藏页面地址中的 php 文件扩展名。

关于：相关 LocalSettings.php 配置项

相关配置项：

1. $wgScriptPath：MediaWiki 文件的实际路径。
2. $wgArticlePath：MediaWiki 文章的虚拟路径。
   • 必须与“$wgScriptPath”不同。
3. $wgUsePathInfo：为操作获取特殊链接。
4. $wgScriptExtension：脚本扩展名。
5. $wgActionPaths：MediaWiki 文章的操作路径。

关于：相关 Nginx 指令

相关指令：

1. try_files：尝试读取文件（读取静态文件），按后面的配置一次尝试。
2. $uri：Nginx 的一个变量，存放着用户访问的地址。

   如：“http://www.xxx.com/index.html”，那么“$uri”就是“/index.html”；

3. $uri/：Nginx 的一个变量，代表访问的是一个目录。

   如：“http://www.xxx.com/hello/test/”，那么“$uri/”就是“/hello/test/”；

示例： try_files $uri $uri/ @rewrite;

说明：

1. 尝试到网站目录读取用户访问的文件，如果“$uri”存在，就直接返回；
2. 否则继续读取“$uri/”，如果存在直接返回；
3. 否则直接跳转到“@rewrite”（定义的另一个“Location”）。

关于：http://wiki.eijux.com/%E9%A6%96%E9%A1%B5

地址“http://wiki.eijux.com/%E9%A6%96%E9%A1%B5”与“http://wiki.eijux.com/首页”其实是同一个地址：前者是将地址中的中文通过“URL 编码”得到的。

内容短链接

默认“内容地址”：http://wiki.eijux.com/index.php?title=首页。

MediaWiki 的短链接有两种方案：

1. example.com/wiki/Page_title

   如：http://wiki.eijux.com/wiki/首页

2. example.com/Page_title

   如：http://wiki.eijux.com/首页

关于“example.com/Page_title”方案：1、使用域的根目录作为 wiki 目录；2、使用 URL 如“example.com/Page_title”。

但这并不是官方建议的方式：
1、仅适用于“域名（子域名）仅用于 MediaWiki”。  ——  否则，可能会导致与其他文件和目录冲突。
2、可能存在的 Bug，如：task T34621、task T40048。等。

example.com/wiki/Page_title

---

1、MediaWiki 安装在站点目录下的文件夹中（“/www/wwwroot/example.com/w/”）。
2、文章将以“example.com/wiki/Page_title”形式的 URL 显示。

配置：

1. LocalSettings.php：

   $wgScriptPath = "/w";
   $wgArticlePath = "/wiki/$1";
   $wgUsePathInfo = true;
   

2. example.com.conf：

   server {
   	# [...]
   
   	# Location for wiki's entry points
   	location ~ ^/w/(index|load|api|thumb|opensearch_desc|rest|img_auth)\.php$ {
   		include /etc/nginx/fastcgi_params;
   		fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
   		fastcgi_pass 127.0.0.1:9000; # or whatever port your PHP-FPM listens on
   	}
   	
   	# Images
   	location /w/images {
   		# Separate location for images/ so .php execution won't apply
   	}
   	location /w/images/deleted {
   		# Deny access to deleted images folder
   		deny all;
   	}
   	# MediaWiki assets (usually images)
   	location ~ ^/w/resources/(assets|lib|src) {
   		try_files $uri 404;
   		add_header Cache-Control "public";
   		expires 7d;
   	}
   	# Assets, scripts and styles from skins and extensions
   	location ~ ^/w/(skins|extensions)/.+\.(css|js|gif|jpg|jpeg|png|svg|wasm)$ {
   		try_files $uri 404;
   		add_header Cache-Control "public";
   		expires 7d;
   	}
   	# Favicon
   	location = /favicon.ico {
   		alias /w/images/6/64/Favicon.ico;
   		add_header Cache-Control "public";
   		expires 7d;
   	}
   
   	# License and credits files
   	location ~ ^/w/(COPYING|CREDITS)$ {
   		default_type text/plain;
   	}
   	
   	## Uncomment the following code if you wish to use the installer/updater
   	## installer/updater
   	#location /w/mw-config/ {
   	#	# Do this inside of a location so it can be negated
   	#	location ~ \.php$ {
   	#		include /etc/nginx/fastcgi_params;
   	#		fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
   	#		fastcgi_pass 127.0.0.1:9000; # or whatever port your PHP-FPM listens on
   	#	}
   	#}
   	
   	# Handling for Mediawiki REST API, see [[mw:API:REST_API]]
   	location /w/rest.php/ {
   		try_files $uri $uri/ /w/rest.php?$query_string;
   	}
   
   	## Uncomment the following code for handling image authentication
   	## Also add "deny all;" in the location for /w/images above
   	#location /w/img_auth.php/ {
   	#	try_files $uri $uri/ /w/img_auth.php?$query_string;
   	#}
   
   	# Handling for the article path (pretty URLs)
   	location /wiki/ {
   		rewrite ^/wiki/(?<pagename>.*)$ /w/index.php;
   	}
   
   	# Allow robots.txt in case you have one
   	location = /robots.txt {
   	}
   	# Explicit access to the root website, redirect to main page (adapt as needed)
   	location = / {
   		return 301 /wiki/Main_Page;
   	}
   
   	# Every other entry point will be disallowed.
   	# Add specific rules for other entry points/images as needed above this
   	location / {
   		return 404;
   	}
   }
   

example.com/Page_title

---

1、MediaWiki 安装在站点目录的根目录中（“/www/wwwroot/example.com/”）。
2、文章将以“example.com/Page_title”形式的 URL 显示。

配置：

1. LocalSettings.php：

   $wgScriptPath = "";
   $wgArticlePath = "/$1";
   $wgUsePathInfo = true;
   $wgScriptExtension = ".php";
   

2. example.com.conf：

   server {
   	server_name www.example.com example.com;
   	listen 80;
   
   	root /home/user/public_html;
   	index index.php index.html index.htm;
   
   	access_log /var/log/nginx/access-example.log;
   	error_log /var/log/nginx/error-example.log;
   
   	location ~ \.ht {
   		deny all;
   	}
   
   	location / {
   		try_files $uri $uri/ @rewrite;
   	}
   
   	location @rewrite {
   		rewrite ^/(.*)$ /index.php;
   	}
   
   	location ^~ /maintenance/ {
   		return 403;
   	}
   
   	location ~ \.php$ {
   		include /etc/nginx/fastcgi_params;
   
   		fastcgi_pass  127.0.0.1:9000;
   		fastcgi_index index.php;
   
   		fastcgi_param  SCRIPT_FILENAME	$document_root$fastcgi_script_name;
   
   		try_files $uri @rewrite;
   	}
   }
   

操作短链接

必须先设置#内容短链接，并保证有效。

默认“操作地址”：http://wiki.eijux.com/index.php?title=首页&action=edit。

MediaWiki 的“操作短链接”有多种方案：

1. 根路径：

   $actions = array( 'view', 'edit', 'watch', 'unwatch', 'delete','revert', 'rollback',
     'protect', 'unprotect', 'markpatrolled', 'render', 'submit', 'history', 'purge', 'info' );
   
   foreach ( $actions as $action ) {
     #操作前置：
     $wgActionPaths[$action] = "/$action/$1";
     #操作后置：
     $wgActionPaths[$action] = "/$1/$action";
   }
   $wgActionPaths['view'] = "/$1";
   $wgArticlePath = $wgActionPaths['view'];
   

   操作前置：http://wiki.eijux.com/edit/首页”；

   操作后置：http://wiki.eijux.com/首页/edit”；

2. 非根路径：

   $actions = array( 'edit', 'watch', 'unwatch', 'delete','revert', 'rollback',
     'protect', 'unprotect', 'markpatrolled', 'render', 'submit', 'history', 'purge', 'info' );
    
   foreach ( $actions as $action ) {
     #操作前置：
     $wgActionPaths[$action] = "/wiki/$action/$1";
     #操作后置：
     $wgActionPaths[$action] = "/wiki/$1/$action";
   }
   $wgActionPaths['view'] = "/wiki/$1";
   $wgArticlePath = $wgActionPaths['view'];
   

   操作前置：“http://wiki.eijux.com/wiki/edit/首页”；

   操作后置：“http://wiki.eijux.com/wiki/首页/edit”；

3. 虚拟路径：

   $actions = array( 'view', 'edit', 'watch', 'unwatch', 'delete','revert', 'rollback',
     'protect', 'unprotect', 'markpatrolled', 'render', 'submit', 'history', 'purge', 'info' );
   
   foreach ( $actions as $action ) {
     #操作前置：
     $wgActionPaths[$action] = "$wgScriptPath/action/$action/$1";
     #操作后置：
     $wgActionPaths[$action] = "$wgScriptPath/action/$1/$action";
   }
   $wgActionPaths['view'] = $wgScriptPath/action/$1";
   $wgArticlePath = $wgActionPaths['view'];
   

   操作前置：“http://wiki.eijux.com/wiki/action/edit/首页”；

   操作后置：“http://wiki.eijux.com/wiki/action/首页/edit”；

• 以上均可分为“操作前置”和“操作后置”。
• 以上均设置单独将 view 操作链接中的“view”关键字省略。

配置了以上内容，仍然需要在“站点的 Ngnix 配置文件中”（example.com.conf）中定义规则以完成 URL 重写。

但是，使用“$wgActionPaths”设置后，不能创建某些与“操作关键字”（如上“$actions”中定义）相关的页面。

    如：创建名为“首页/edit”（action后置）、“edit/首页”（action后置）、“首页/history”的页面时，会跳转到“首页”相关的操作页面。


对此，可以修改“$actions”定义的操作词为不常用词（可能需要修改页面代码？）。

备注

当前站点使用的方式为：example.com/Page_title，现备注正在使用的“wiki.eijux.com.conf”如下。

【2022/08/23 05:41:49】

1. LocalSettings.php：

   # Short URL
   $wgArticlePath = "/$1";
   $wgUsePathInfo = true;
   $wgScriptExtension = ".php";
   

2. wiki.eijux.com.conf：【关键部分已高亮】

   server
   {
       ...
   
       location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
       {
           expires      30d;
           error_log /dev/null;
           access_log /dev/null;
           
           #允许访问内容, by Eijux at 2022/08/21 23:33:42
           try_files $uri @rewrite;
       }
   
       location ~ .*\.(js|css)?$
       {
           expires      12h;
           error_log /dev/null;
           access_log /dev/null;
   
           #允许访问内容, by Eijux at 2022/08/21 23:33:42
           try_files $uri @rewrite;
       }
       
       #修改短链接, by Eijux at 2020/09/09 03:14:50
       #begin
       location ~ \.ht {
           deny all;
       }
       
       location / {
           try_files $uri $uri/ @rewrite;
       }
   
       location @rewrite {
           rewrite ^/(.*)$ /index.php;
       }
     	
       location ^~ /maintenance/ {
           return 403;
       }
   	  
       location ~ \.php$ {
           include /www/server/nginx/conf/fastcgi_params;
       
           fastcgi_pass  unix:/tmp/php-cgi-73.sock;
           fastcgi_index index.php;
       
           fastcgi_param  SCRIPT_FILENAME	$document_root$fastcgi_script_name;
       
           try_files $uri @rewrite;
       }
       #end
       
       access_log  /www/wwwlogs/wiki.eijux.com.log;
       error_log  /www/wwwlogs/wiki.eijux.com.error.log;
   }
   

   • 关于fastcgi的配置，参见“/www/server/nginx/conf”中的“enable-php-73.conf”。
     • “fastcgi_params”和“fastcgi.conf”均位于“/www/server/nginx/conf”中。

FAQ

404 Not Found nginx

在修改短链接之后，可能出现 404 Not Found nginx 的错误：
    

出现此错误，其实是“站点的 Ngnix 配置文件”（example.com.conf）配置有问题：

1. 若在访问所有页面均出现此错误，则参考 #内容短链接 进行修改即可。
2. 若仅访问“png、jpg”、“js、css”等内容时，出现此错误，则修改如下：

       location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
       {
           expires      30d;
           error_log off;
           access_log /dev/null;
           
           try_files $uri @rewrite;
       }
       
       location ~ .*\.(js|css)?$
       {
           expires      12h;
           error_log off;
           access_log /dev/null; 
           
           try_files $uri @rewrite;
       }
   

若有其他内容错误，解决类似。