Difference between revisions of "MediaWiki"

From ArchWiki
Jump to: navigation, search
m (Installation)
(Improving style. Better use of templates.)
Line 3: Line 3:
 
== Installation ==
 
== Installation ==
  
Follow the [[LAMP|LAMP]] guide. Then [[pacman|Install]] {{pkg|php-gd}} and uncomment {{ic|1=;extension=gd.so}} in {{ic|php.ini}}, same for {{pkg|php-intl}} (needs icu) and {{pkg|php-xcache}} (here add {{ic|1=extension=xcache.so}}) and finally install {{pkg|mediawiki}}, all available from the [[official repositories]].
+
Follow the [[LAMP]] guide. Then [[pacman|Install]] {{pkg|php-gd}} and uncomment {{ic|1=;extension=gd.so}} in {{ic|php.ini}}, same for {{pkg|php-intl}} (needs icu) and {{pkg|php-xcache}} (here add {{ic|1=extension=xcache.so}}) and finally install {{pkg|mediawiki}}, all available from the [[official repositories]].
  
 
Instead of {{pkg|mysql}} you can install {{pkg|sqlite3}} or {{pkg|postgresql}}.
 
Instead of {{pkg|mysql}} you can install {{pkg|sqlite3}} or {{pkg|postgresql}}.
  
 
==Configuration==
 
==Configuration==
 
+
=== Apache ===
 
Create {{ic|/etc/webapps/mediawiki/httpd-mediawiki.conf}} from the provided example {{ic|apache.example.conf}} in the same directory. Edit it to remove the {{ic|open_basedir}} line, which is already in {{ic|php.ini}}.
 
Create {{ic|/etc/webapps/mediawiki/httpd-mediawiki.conf}} from the provided example {{ic|apache.example.conf}} in the same directory. Edit it to remove the {{ic|open_basedir}} line, which is already in {{ic|php.ini}}.
  
 
*Add the following lines to {{ic|/etc/httpd/conf/httpd.conf}}
 
*Add the following lines to {{ic|/etc/httpd/conf/httpd.conf}}
LoadModule php5_module modules/libphp5.so
+
{{bc|
Include conf/extra/php5_module.conf
+
LoadModule php5_module modules/libphp5.so
Include /etc/webapps/mediawiki/httpd-mediawiki.conf
+
Include conf/extra/php5_module.conf
* Adjust the open_basedir in {{ic|/etc/php/php.ini}} to include the webapps directory (allows update.php to be run from the command line):
+
Include /etc/webapps/mediawiki/httpd-mediawiki.conf
  open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/
+
}}
 +
* Adjust the {{ic|open_basedir}} in {{ic|/etc/php/php.ini}} to include the webapps directory (allows '''update.php''' to be run from the command line):
 +
{{bc|1=open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/}}
 
* Adjust permissions in {{ic|/usr/share/webapps/mediawiki/.htaccess}}, e.g. to  
 
* Adjust permissions in {{ic|/usr/share/webapps/mediawiki/.htaccess}}, e.g. to  
  allow from all
+
{{ic|allow from all}}
  
Restart apache with:
+
[[Pacman|Restart]] the {{ic|httpd.service}} daemon.
# systemctl restart httpd
+
  
Open the wiki in a browser and do the initial setup to create {{ic|/usr/share/webapps/mediawiki/LocalSettings.php}}.
+
Open the wiki in a browser and do the initial setup to create {{ic|LocalSettings.php}}. Then save it to {{ic|/usr/share/webapps/mediawiki/LocalSettings.php}}.
  
== Nginx ==
+
=== Nginx ===
To get MediaWiki working with Nginx, create the following file at {{ic|/etc/nginx/mediawiki.conf}}:
+
To get MediaWiki working with Nginx, create the following file:
  
location / {
+
{{hc|/etc/nginx/mediawiki.conf|<nowiki>
 +
 
 +
location / {
 
   index index.php;
 
   index index.php;
 
   try_files $uri @mediawiki;
 
   try_files $uri @mediawiki;
}
+
}
location @mediawiki {
+
location @mediawiki {
 
   rewrite ^/([^?]*)(?:\?(.*))? /index.php?title=$1$2 last;
 
   rewrite ^/([^?]*)(?:\?(.*))? /index.php?title=$1$2 last;
}
+
}
location ~ \.php?$ {
+
location ~ \.php?$ {
 
   include fastcgi.conf;
 
   include fastcgi.conf;
 
   fastcgi_pass php;
 
   fastcgi_pass php;
}
+
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
+
location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
 
   try_files $uri /index.php;
 
   try_files $uri /index.php;
 
   expires max;
 
   expires max;
 
   log_not_found off;
 
   log_not_found off;
}
+
}
location ^~ /maintenance/ {
+
location ^~ /maintenance/ {
 
   return 403;
 
   return 403;
}
+
}
location ^~ /cache/ {
+
location ^~ /cache/ {
 
   deny all;
 
   deny all;
}
+
}
 
+
</nowiki>}}
 
Ensure that {{ic|php-fpm}} is installed, and in your {{ic|/etc/nginx/nginx.conf}} file, ensure that you have an {{ic|upstream}} directive named {{ic|php}}, similar to this one:
 
Ensure that {{ic|php-fpm}} is installed, and in your {{ic|/etc/nginx/nginx.conf}} file, ensure that you have an {{ic|upstream}} directive named {{ic|php}}, similar to this one:
  
upstream php {
+
{{hc|/etc/nginx/nginx.conf|<nowiki>
 +
upstream php {
 
   server unix:/var/run/php-fpm/php-fpm.sock;
 
   server unix:/var/run/php-fpm/php-fpm.sock;
}
+
}
 +
</nowiki>}}
  
Include a server directive, similar to this, in your {{ic|/etc/nginx/nginx.conf}} file:
+
Include a server directive, similar to this
 
+
server {
+
  listen 80;
+
  server_name mediawiki;
+
  root /usr/share/webapps/mediawiki;
+
  index index.php;
+
  include mediawiki.conf;
+
}
+
  
 +
{{hc|/etc/nginx/nginx.conf|
 +
server {
 +
  listen 80;
 +
  server_name mediawiki;
 +
  root /usr/share/webapps/mediawiki;
 +
  index index.php;
 +
  include mediawiki.conf;
 +
}
 +
}}
 
Finally, ensure that the {{ic|open_basedir}} directive in {{ic|/etc/php/php.ini}} includes {{ic|/usr/share/webapps}} and {{ic|/etc/webapps}}, or you might get "File not found" or "No input file specified" errors.
 
Finally, ensure that the {{ic|open_basedir}} directive in {{ic|/etc/php/php.ini}} includes {{ic|/usr/share/webapps}} and {{ic|/etc/webapps}}, or you might get "File not found" or "No input file specified" errors.
  
== Tips ==
+
== Tips and tricks ==
 
=== Mathematics (texvc) ===
 
=== Mathematics (texvc) ===
  

Revision as of 16:31, 11 January 2013

Note: If you are using xampp, there are different steps you need to take after installing. More info here

Installation

Follow the LAMP guide. Then Install php-gd and uncomment ;extension=gd.so in php.ini, same for php-intl (needs icu) and php-xcache (here add extension=xcache.so) and finally install mediawiki, all available from the official repositories.

Instead of mysql you can install sqlite3 or postgresql.

Configuration

Apache

Create /etc/webapps/mediawiki/httpd-mediawiki.conf from the provided example apache.example.conf in the same directory. Edit it to remove the open_basedir line, which is already in php.ini.

  • Add the following lines to /etc/httpd/conf/httpd.conf
LoadModule php5_module modules/libphp5.so
Include conf/extra/php5_module.conf
Include /etc/webapps/mediawiki/httpd-mediawiki.conf
  • Adjust the open_basedir in /etc/php/php.ini to include the webapps directory (allows update.php to be run from the command line):
open_basedir = /srv/http/:/home/:/tmp/:/usr/share/pear/:/usr/share/webapps/
  • Adjust permissions in /usr/share/webapps/mediawiki/.htaccess, e.g. to

allow from all

Restart the httpd.service daemon.

Open the wiki in a browser and do the initial setup to create LocalSettings.php. Then save it to /usr/share/webapps/mediawiki/LocalSettings.php.

Nginx

To get MediaWiki working with Nginx, create the following file:

/etc/nginx/mediawiki.conf

location / {
   index index.php;
   try_files $uri @mediawiki;
}
location @mediawiki {
   rewrite ^/([^?]*)(?:\?(.*))? /index.php?title=$1$2 last;
}
location ~ \.php?$ {
   include fastcgi.conf;
   fastcgi_pass php;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
   try_files $uri /index.php;
   expires max;
   log_not_found off;
}
location ^~ /maintenance/ {
   return 403;
}
location ^~ /cache/ {
   deny all;
}

Ensure that php-fpm is installed, and in your /etc/nginx/nginx.conf file, ensure that you have an upstream directive named php, similar to this one:

/etc/nginx/nginx.conf
upstream php {
   server unix:/var/run/php-fpm/php-fpm.sock;
}

Include a server directive, similar to this

/etc/nginx/nginx.conf
server {
  listen 80;
  server_name mediawiki;
  root /usr/share/webapps/mediawiki;
  index index.php;
  include mediawiki.conf;
}

Finally, ensure that the open_basedir directive in /etc/php/php.ini includes /usr/share/webapps and /etc/webapps, or you might get "File not found" or "No input file specified" errors.

Tips and tricks

Mathematics (texvc)

Usually installing texvc package and enabling it in config are enough:

 $wgUseTeX = true;

If you get problems, try to increase limits for shell commands:

 $wgMaxShellMemory = 8000000;
 $wgMaxShellFileSize = 1000000;
 $wgMaxShellTime = 300;

Unicode

Check that php, apache and mysql uses UTF-8. Otherwise you may face strange bugs because of encoding mismatch.