DokuWiki è un programma wiki open source scritto in PHP che non richiede un database. Memorizza i dati in file di testo. Il codice sorgente di DokuWiki è ospitato pubblicamente su GitHub . Questa guida ti mostrerà come installare DokuWiki con Nginx su una nuova istanza di FreeBSD 12 Vultr.
Requisiti
- Software per server Web che supporta PHP; come Apache, Nginx, IIS, Lighttpd, LiteSpeed. Questa guida utilizzerà Nginx.
- PHP versione 5.6 o successiva, le versioni più recenti sono altamente raccomandate. Questa guida utilizzerà PHP 7.2.
Prima di iniziare
Controlla la versione di FreeBSD.
uname -ro
# FreeBSD 12.0-RELEASE
Assicurati che il tuo sistema FreeBSD sia aggiornato.
freebsd-update fetch install
pkg update && pkg upgrade -y
Installa i pacchetti necessari se non sono presenti sul tuo sistema.
pkg install -y sudo vim unzip wget bash socat git
Crea un nuovo account utente con il tuo nome utente preferito (useremo 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!
Esegui il visudo
comando e decommenta la %wheel ALL=(ALL) ALL
riga per consentire ai membri del wheel
gruppo di eseguire qualsiasi comando.
visudo
# Uncomment by removing hash (#) sign
%wheel ALL=(ALL) ALL
Ora passa al nuovo utente creato.
su - johndoe
NOTA: sostituisci johndoe
con il tuo nome utente.
Imposta il fuso orario.
sudo tzsetup
Installa le estensioni PHP e PHP
Installa PHP e le estensioni PHP necessarie.
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
Controlla la versione
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-production
a php.ini
.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Abilita e avvia PHP-FPM.
sudo sysrc php_fpm_enable=yes
sudo service php-fpm start
DokuWiki verrà eseguito su qualsiasi server Web che supporti PHP. In questo tutorial useremo Nginx. Se preferisci Apache o un altro server web, puoi usarlo al posto di Nginx.
Installa Nginx.
sudo pkg install -y nginx
Controlla la versione
nginx -v
# nginx version: nginx/1.14.2
Abilita e avvia Nginx.
sudo sysrc nginx_enable=yes
sudo service nginx start
Esegui sudo vim /usr/local/etc/nginx/dokuwiki.conf
e configura Nginx per 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;
}
}
Salvare il file e uscire con :+ W+ Q.
Ora dobbiamo includere il dokuwiki.conf
file nel file principale nginx.conf
.
Esegui sudo vim /usr/local/etc/nginx/nginx.conf
e aggiungi la seguente riga per http {}
bloccare.
include dokuwiki.conf;
Prova la configurazione di Nginx.
sudo nginx -t
Ricarica Nginx.
sudo service nginx reload
Installa DokuWiki
Creare una directory radice del documento.
sudo mkdir -p /usr/local/www/dokuwiki
Cambia la proprietà della /usr/local/www/dokuwiki
directory in johndoe
.
sudo chown -R johndoe:johndoe /usr/local/www/dokuwiki
Passare alla radice del documento.
cd /usr/local/www/dokuwiki
Scarica l'ultima versione stabile di DokuWiki dalla pagina di download di DokuWiki .
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
Disimballare il tarball DokuWiki.
tar xvf dokuwiki-stable.tgz
rm dokuwiki-stable.tgz
mv dokuwiki-2018-04-22b/* . && mv dokuwiki-2018-04-22b/.* .
rmdir dokuwiki-2018-04-22b/
Cambia la proprietà della /usr/local/www/dokuwiki
directory in www
.
sudo chown -R www:www /usr/local/www/dokuwiki
Apri lo script di installazione di DokuWiki install.php
nel browser e imposta DokuWiki. Lo script di installazione verifica la disponibilità delle funzioni PHP richieste e verifica le autorizzazioni necessarie per i file. Crea inoltre un account amministratore iniziale e un criterio ACL iniziale. Per eseguire il programma di installazione, aprire http://wiki.example.com/install.php
nel browser e seguire le istruzioni.
Dopo una corretta configurazione, elimina il install.php
file dalla directory principale di DokuWiki.
sudo rm /usr/local/www/dokuwiki/install.php
Il tuo DokuWiki è stato installato e ora puoi accedere e modificare un wiki funzionale su http://wiki.example.com/
.