Building on yesterday’s post on setting up PmWiki on nginx, I figured out the nginx configurations for PmWiki Clean URLs.
First, copy the example config.php out of the docs/ directory to the root of the PMWiki site, in my case, I installed to $DOCROOT/pmwiki/:
cd $DOCROOT
cp pmwiki/docs/sample-config.php pmwiki/config.phpFollowing the Clean URL notes, in pmwiki/config.php I set:
$EnablePathInfo = 1;then I hit the wiki front page and started to look at the resulting link URLs like http://wiki.example.com/pmwiki/index.php/Main/WikiSandbox – they all 404 at this point, but this gives an idea of what I want to do next. I want to get rid of the /index.php/ bit, first, so in pmwiki/config.php I set:
$ScriptUrl = 'http://wiki.example.com/pmwiki';This worked – the resulting URLs are like http://wiki.example.com/pmwiki/Main/WikiSandbox – but, let’s make that a little more portable for other vhost names or aliases and set it to:
$ScriptUrl = 'http://'.$_SERVER['HTTP_HOST'].'/pmwiki';This works perfectly – now to take care of all the 404s with nginx rewrites. From yesterday’s config, I added the “location /pmwiki” and “location @pmwiki” blocks – here’s my complete nginx server configuration:
server {
listen 80;
charset utf-8;
server_name wiki.example.com;
access_log /var/log/nginx/wiki.access.log;
root /var/www/wiki;
index index.html index.php;
location /pmwiki {
error_page 404 = @pmwiki;
log_not_found off;
}
location @pmwiki {
rewrite ^/pmwiki/(.*)$ /pmwiki/?n=$1 last;
}
# configs from pmwiki .htaccess files
location ~ ^/pmwiki/(cookbook|local|scripts|wiki.d|wikilib.d) {
deny all;
}
location ^~ /pmwiki/docs {
autoindex on;
types {
text/plain php;
}
}
# pass PHP scripts to FastCGI server listening on 127.0.0.1:8080
location ~ \.php$ {
fastcgi_pass 127.0.0.1:8080;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi_params;
}
# deny access to all .dot-files
location ~ /\. {
deny all;
}
}If PmWiki is installed in the document root of the site (not under http://…/pmwiki/), then adjust the ScriptUrl in config.php:
$ScriptUrl = 'http://'.$_SERVER['HTTP_HOST']'';and the nginx config blocks above to:
location / {...}
location @pmwiki {
rewrite ^/(.*)$ /?n=$1 last;
}
location ~ ^/(cookbook|local|scripts|wiki.d|wikilib.d) {...}
location ^~ /docs {...}
