Követelmények
Mielőtt elkezded
Telepítse a PHP-t és a PHP-bővítményeket
Telepítse és konfigurálja az Nginx-et
Telepítse a DokuWikit
A DokuWiki egy nyílt forráskódú, PHP-ben írt wikiprogram, amely nem igényel adatbázist. Az adatokat szöveges fájlokban tárolja. A DokuWiki forráskódja nyilvánosan a GitHubon található . Ez az útmutató megmutatja, hogyan telepítheti a DokuWikit az Nginx-szel egy friss FreeBSD 12 Vultr példányra.
Követelmények
- PHP-t támogató webszerver szoftver; például Apache, Nginx, IIS, Lighttpd, LiteSpeed. Ez az útmutató az Nginxet fogja használni.
- PHP 5.6 vagy újabb verzió, az újabb verziók erősen ajánlottak. Ez az útmutató a PHP 7.2 verzióját fogja használni.
Mielőtt elkezded
Ellenőrizze a FreeBSD verzióját.
uname -ro
# FreeBSD 12.0-RELEASE
Győződjön meg arról, hogy a FreeBSD rendszere naprakész.
freebsd-update fetch install
pkg update && pkg upgrade -y
Telepítse a szükséges csomagokat, ha azok nincsenek jelen a rendszeren.
pkg install -y sudo vim unzip wget bash socat git
Hozzon létre egy új felhasználói fiókot a kívánt felhasználónévvel (használjuk 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!
Futtassa a visudoparancsot, és törölje a %wheel ALL=(ALL) ALLsor megjegyzését , hogy a wheelcsoport tagjai bármilyen parancsot végrehajthassanak.
visudo
# Uncomment by removing hash (#) sign
%wheel ALL=(ALL) ALL
Most váltson az újonnan létrehozott felhasználóra.
su - johndoe
MEGJEGYZÉS: Cserélje johndoeki a felhasználónevét.
Állítsa be az időzónát.
sudo tzsetup
Telepítse a PHP-t és a PHP-bővítményeket
Telepítse a PHP-t, valamint a szükséges PHP-bővítményeket.
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
Ellenőrizze a verziót.
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
Lágy hivatkozás ide php.ini-production: php.ini.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Engedélyezze és indítsa el a PHP-FPM-et.
sudo sysrc php_fpm_enable=yes
sudo service php-fpm start
A DokuWiki minden PHP-t támogató webszerveren futni fog. Ebben az oktatóanyagban az Nginxet fogjuk használni. Ha inkább az Apache-ot vagy más webszervert választja, használhatja azt az Nginx helyett.
Telepítse az Nginx-et.
sudo pkg install -y nginx
Ellenőrizze a verziót.
nginx -v
# nginx version: nginx/1.14.2
Engedélyezze és indítsa el az Nginxet.
sudo sysrc nginx_enable=yes
sudo service nginx start
Futtassa sudo vim /usr/local/etc/nginx/dokuwiki.confés konfigurálja az Nginxet a DokuWiki számára.
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;
}
}
Mentse el a fájlt, és lépjen ki a :+ W+ gombbal Q.
Most bele kell foglalnunk a dokuwiki.conffájlt a nginx.conffőfájlba.
Futtassa, sudo vim /usr/local/etc/nginx/nginx.confés adja hozzá a következő sort a http {}blokkoláshoz.
include dokuwiki.conf;
Tesztelje az Nginx konfigurációt.
sudo nginx -t
Töltse újra az Nginxet.
sudo service nginx reload
Telepítse a DokuWikit
Hozzon létre egy dokumentum gyökérkönyvtárát.
sudo mkdir -p /usr/local/www/dokuwiki
Módosítsa a /usr/local/www/dokuwikicímtár tulajdonjogát erre: johndoe.
sudo chown -R johndoe:johndoe /usr/local/www/dokuwiki
Navigáljon a dokumentum gyökeréhez.
cd /usr/local/www/dokuwiki
Töltse le a DokuWiki legújabb stabil kiadását a DokuWiki letöltési oldaláról .
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
Csomagold ki a DokuWiki tarballt.
tar xvf dokuwiki-stable.tgz
rm dokuwiki-stable.tgz
mv dokuwiki-2018-04-22b/* . && mv dokuwiki-2018-04-22b/.* .
rmdir dokuwiki-2018-04-22b/
Módosítsa a /usr/local/www/dokuwikicímtár tulajdonjogát erre: www.
sudo chown -R www:www /usr/local/www/dokuwiki
Nyissa meg a DokuWiki beállítási szkriptjét, install.php, a böngészőjében, és állítsa be a DokuWikit. A telepítő szkript ellenőrzi a szükséges PHP-funkciók elérhetőségét, és ellenőrzi a szükséges fájlengedélyeket. Ezenkívül létrehoz egy kezdeti rendszergazdai fiókot és egy kezdeti ACL-házirendet. A telepítő futtatásához nyissa http://wiki.example.com/install.phpmeg a böngészőt, és kövesse az utasításokat.
A sikeres konfiguráció után törölje a install.phpfájlt a DokuWiki gyökérkönyvtárából.
sudo rm /usr/local/www/dokuwiki/install.php
A DokuWiki telepítése megtörtént, és mostantól elérheti és szerkesztheti a működő wikit a címen http://wiki.example.com/.