如何在Debian 9上安装DokuWiki

• 要求
• 第1步-安装PHP和PHP扩展
• 第2步-安装和配置Nginx
• 第3步-安装DokuWiki

DokuWiki是用PHP编写的开源Wiki程序，不需要数据库。它将数据存储在文本文件中。DokuWiki源代码公开托管在GitHub上。本指南将向您展示如何在新的Debian 9 Vultr实例上安装DokuWiki。

要求

确保您的服务器满足以下要求。

• Nginx的
• PHP 5.6或更高版本，强烈建议使用新版本。（本指南将使用PHP 7.0）

检查Debian版本。

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

确保您的系统是最新的。

apt update && apt upgrade -y

安装必要的软件包。

apt install -y apt-transport-https sudo curl wget dirmngr sudo

创建一个non-root具有sudo访问权限的新用户帐户并切换到该帐户。

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

注意：用您的用户名替换johndoe。

设置时区。

timedatectl list-timezones
sudo timedatectl set-timezone Region/City

第1步-安装PHP和PHP扩展

安装PHP 7.0和必需的PHP扩展。

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-gd php7.0-xml php7.0-zip

检查版本。

php --version

# PHP 7.0.27-0+deb9u1 (cli) (built: Jan  5 2018 13:51:52) ( NTS )
# Copyright (c) 1997-2017 The PHP Group
# Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies
#     with Zend OPcache v7.0.27-0+deb9u1, Copyright (c) 1999-2017, by Zend Technologies

第2步-安装和配置Nginx

安装Nginx。

sudo apt install -y nginx

检查版本。

sudo nginx -v
# nginx version: nginx/1.10.3

配置Nginx。

sudo vim /etc/nginx/sites-available/dokuwiki.conf

使用以下Nginx配置填充文件并保存。

server {
    listen [::]:80;
    listen 80;

    server_name wiki.example.com; # Replace with your hostname
    root /var/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 last;
    }
    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
        fastcgi_index  index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

dokuwiki.conf通过将文件链接到sites-enabled目录来激活新配置。

sudo ln -s /etc/nginx/sites-available/dokuwiki.conf /etc/nginx/sites-enabled/

检查配置。

sudo nginx -t

重新加载Nginx。

sudo systemctl reload nginx.service

第3步-安装DokuWiki

创建一个文档根目录。

sudo mkdir -p /var/www/dokuwiki

将/var/www/dokuwiki目录的所有权更改为johndoe。

sudo chown -R johndoe:johndoe /var/www/dokuwiki

导航到文档根目录。

cd /var/www/dokuwiki

从DokuWiki下载页面下载 DokuWiki的最新稳定版本。

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

解压DokuWiki压缩包。

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

将/var/www/dokuwiki目录的所有权更改为www-data。

sudo chown -R www-data:www-data /var/www/dokuwiki

重新启动php7.0-fpm.service。

sudo systemctl restart php7.0-fpm.service

install.php在浏览器中打开DokuWiki设置脚本，然后设置DokuWiki。安装脚本将检查所需的PHP函数的可用性，并检查必要的文件权限。它还会创建一个初始管理员帐户和一个初始ACL策略。要运行安装程序，请http://wiki.example.com/install.php在浏览器中打开并按照说明进行操作。

配置成功后，请install.php从DokuWiki根目录中删除该文件。

sudo rm /var/www/dokuwiki/install.php

您的DokuWiki已安装，您将可以通过访问和编辑功能Wiki http://wiki.example.com/。