如何在Fedora 28上安装DokuWiki

• 要求
• 在你开始之前
• 第1步-安装PHP和PHP扩展
• 第2步-安装和配置Nginx
• 第3步-安装DokuWiki

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

要求

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

• 支持PHP的Web服务器软件（Apache，Nginx，IIS，Lighttpd，LiteSpeed）。
• PHP 5.6或更高版本。

在你开始之前

检查操作系统版本。

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

创建一个具有访问权限的新非root用户帐户sudo并切换到该帐户。替换johndoe为您的用户名。

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

确保您的系统是最新的。

sudo dnf check-upgrade || sudo dnf upgrade -y

设置时区。

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

安装必需和有用的软件包。

sudo dnf install -y wget vim unzip bash-completion

为简单起见，请禁用SELinux和防火墙。

sudo setenforce 0; sudo systemctl stop firewalld; sudo systemctl disable firewalld

第1步-安装PHP和PHP扩展

安装PHP和必需的PHP扩展。

sudo dnf install -y php-cli php-fpm php-gd php-xml php-zip php-json

检查版本。

php --version

# PHP 7.2.6 (cli) (built: May 22 2018 16:22:08) ( NTS )

启动并启用PHP-FPM服务。

sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service

第2步-安装和配置Nginx

如果您更喜欢Apache或其他流行的Web服务器，则可以使用其中之一代替Nginx。

安装Nginx。

sudo dnf install -y nginx

检查版本。

nginx -v
# nginx version: nginx/1.12.1

启动并启用Nginx。

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

配置Nginx。

sudo vim /etc/nginx/conf.d/dokuwiki.conf

复制/粘贴以下Nginx配置并保存。

server {

  listen [::]:80;
  listen 80;

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

  root /var/www/dokuwiki; # Replace with your DokuWiki web root folder

  index doku.php;

  client_max_body_size 4M;
  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;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param REDIRECT_STATUS 200;
    fastcgi_pass unix:/run/php-fpm/www.sock; # Replace with your UNIX socket path
  }

}

注意： 您可以运行netstat --unix --listening | grep php以查找PHP-FPM UNIX域套接字的默认路径。

检查Nginx配置。

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目录的所有权更改为nginx。

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

运行sudo vim /etc/php-fpm.d/www.conf并将用户和组设置为nginx。

sudo vim /etc/php-fpm.d/www.conf
# user = nginx
# group = nginx

重新启动php-fpm.service。

sudo systemctl restart php-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/。享受新的DokuWiki安装。