Hoe DokuWiki op FreeBSD 12 te installeren

• Vereisten
• Voordat je begint
• Installeer PHP en PHP-extensies
• Installeer en configureer Nginx
• Installeer DokuWiki

DokuWiki is een open source wiki-programma geschreven in PHP waarvoor geen database nodig is. Het slaat gegevens op in tekstbestanden. De broncode van DokuWiki wordt openbaar gehost op GitHub . Deze gids zal je laten zien hoe je DokuWiki met Nginx installeert op een nieuwe FreeBSD 12 Vultr-instantie.

Vereisten

• Webserversoftware die PHP ondersteunt; zoals Apache, Nginx, IIS, Lighttpd, LiteSpeed. Deze gids zal Nginx gebruiken.
• PHP versie 5.6 of hoger, nieuwere versies worden sterk aanbevolen. Deze gids gebruikt PHP 7.2.

Voordat je begint

Controleer de FreeBSD-versie.

uname -ro
# FreeBSD 12.0-RELEASE

Zorg ervoor dat uw FreeBSD-systeem up-to-date is.

freebsd-update fetch install
pkg update && pkg upgrade -y

Installeer de benodigde pakketten als ze niet aanwezig zijn op uw systeem.

pkg install -y sudo vim unzip wget bash socat git

Maak een nieuw gebruikersaccount aan met uw favoriete gebruikersnaam (we zullen gebruiken johndoe).

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Voer de visudoopdracht uit en maak een commentaar op de %wheel ALL=(ALL) ALLregel, zodat leden van de wheelgroep elke opdracht kunnen uitvoeren.

visudo

# Uncomment by removing hash (#) sign
%wheel ALL=(ALL) ALL

Schakel nu over naar uw zojuist gemaakte gebruiker.

su - johndoe

OPMERKING: vervang johndoedoor uw gebruikersnaam.

Stel de tijdzone in.

sudo tzsetup

Installeer PHP en PHP-extensies

Installeer PHP, evenals de nodige PHP-extensies.

sudo pkg install -y php72 php72-ctype php72-curl php72-dom php72-hash php72-iconv php72-gd php72-json php72-mbstring php72-openssl php72-session php72-simplexml php72-xml php72-zip php72-zlib php72-filter php72-ftp php72-tokenizer php72-calendar php72-pecl-APCu php72-opcache php72-phar php72-fileinfo

Controleer de versie.

php --version
# PHP 7.2.14 (cli) (built: Jan 15 2019 01:14:39) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
#     with Zend OPcache v7.2.14, Copyright (c) 1999-2018, by Zend Technologies

Soft-link php.ini-productionnaar php.ini.

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Schakel PHP-FPM in en start het.

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Installeer en configureer Nginx

DokuWiki draait op elke webserver die PHP ondersteunt. In deze tutorial gebruiken we Nginx. Als je de voorkeur geeft aan Apache of een andere webserver, kun je die gebruiken in plaats van Nginx.

Installeer Nginx.

sudo pkg install -y nginx

Controleer de versie.

nginx -v
# nginx version: nginx/1.14.2

Schakel Nginx in en start het.

sudo sysrc nginx_enable=yes
sudo service nginx start

Start sudo vim /usr/local/etc/nginx/dokuwiki.confen configureer Nginx voor DokuWiki.

server {

  listen [::]:80;
  listen 80;

  server_name wiki.example.com; # Replace with your hostname

  root /usr/local/www/dokuwiki;
  index index.html index.htm index.php doku.php;

  client_max_body_size 15M;
  client_body_buffer_size 128K;

  location / {
    try_files $uri $uri/ @dokuwiki;
  }

  location ^~ /conf/ { return 403; }
  location ^~ /data/ { return 403; }
  location ~ /\.ht { deny all; }

  location @dokuwiki {
    rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
    rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
    rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
    rewrite ^/(.*) /doku.php?id=$1&$args last;
  }

  location ~ \.php$ {
    try_files $uri $uri/ /doku.php;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_param REDIRECT_STATUS 200;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  }

}

Sla het bestand op en sluit af met :+ W+ Q.

Nu moeten we het dokuwiki.confbestand opnemen in het hoofdbestand nginx.conf.

Ren sudo vim /usr/local/etc/nginx/nginx.confen voeg de volgende regel toe om te http {}blokkeren.

include dokuwiki.conf;

Test de Nginx-configuratie.

sudo nginx -t

Herlaad Nginx.

sudo service nginx reload

Installeer DokuWiki

Maak een documenthoofdmap.

sudo mkdir -p /usr/local/www/dokuwiki

Verander het eigendom van de /usr/local/www/dokuwikidirectory in johndoe.

sudo chown -R johndoe:johndoe /usr/local/www/dokuwiki

Navigeer naar de documentroot.

cd /usr/local/www/dokuwiki

Download de nieuwste stabiele release van DokuWiki van de DokuWiki-downloadpagina .

wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

Pak de DokuWiki tarball uit.

tar xvf dokuwiki-stable.tgz
rm dokuwiki-stable.tgz
mv dokuwiki-2018-04-22b/* . && mv dokuwiki-2018-04-22b/.* .
rmdir dokuwiki-2018-04-22b/

Verander het eigendom van de /usr/local/www/dokuwikidirectory in www.

sudo chown -R www:www /usr/local/www/dokuwiki

Open het DokuWiki setup script,, install.phpin je browser en stel DokuWiki in. Het installatiescript controleert op de beschikbaarheid van vereiste PHP-functies en controleert op benodigde bestandsrechten. Het maakt ook een eerste beheerdersaccount en een eerste ACL-beleid aan. Om het installatieprogramma uit te voeren, opent u http://wiki.example.com/install.phpin de browser en volgt u de instructies.

Na een succesvolle configuratie verwijdert u het install.phpbestand uit de DokuWiki-hoofdmap.

sudo rm /usr/local/www/dokuwiki/install.php

Je DokuWiki is geïnstalleerd en je kunt nu een functionele wiki openen en bewerken op http://wiki.example.com/.