Difference between revisions of "MediaWiki"

From ArchWiki
Jump to: navigation, search
Line 3: Line 3:
== Installation ==
== Installation ==
Follow the [[LAMP|LAMP]] guide. Then [[pacman|Install]] {{pkg|php-gd}} and uncomment "extension=gd.so" in {{ic|php.ini}}, same for {{pkg|php-intl}} and {{pkg|php-xcache}} (here add "extension=xcache.so") and finally install {{pkg|mediawiki}}, all available from the [[official repositories]].
Follow the [[LAMP|LAMP]] guide. Then [[pacman|Install]] {{pkg|php-gd}} and uncomment "extension=gd.so" in {{ic|php.ini}}, same for {{pkg|php-intl}} (needs icu) and {{pkg|php-xcache}} (here add "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}}.

Revision as of 19:07, 24 November 2012

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


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.


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 apache with:

# rc.d restart httpd

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


To get MediaWiki working with Nginx, create the following file at /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:

upstream php {
  server unix:/var/run/php-fpm/php-fpm.sock;

Include a server directive, similar to this, in your /etc/nginx/nginx.conf file:

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.


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;


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