如何在FreeBSD 12上安装DokuWiki

• 要求
• 在你开始之前
• 安装PHP和PHP扩展
• 安装和配置Nginx
• 安装DokuWiki

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

要求

• 支持PHP的Web服务器软件；例如Apache，Nginx，IIS，Lighttpd，LiteSpeed。本指南将使用Nginx。
• PHP 5.6或更高版本，强烈建议使用新版本。本指南将使用PHP 7.2。

在你开始之前

检查FreeBSD版本。

uname -ro
# FreeBSD 12.0-RELEASE

确保您的FreeBSD系统是最新的。

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

如果系统上没有必要的软件包，请安装它们。

pkg install -y sudo vim unzip wget bash socat git

使用您的首选用户名创建一个新用户帐户（我们将使用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!

运行visudo命令并取消注释该%wheel ALL=(ALL) ALL行，以允许该wheel组的成员执行任何命令。

visudo

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

现在，切换到新创建的用户。

su - johndoe

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

设置时区。

sudo tzsetup

安装PHP和PHP扩展

安装PHP以及必要的PHP扩展。

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

检查版本。

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

软链接php.ini-production到php.ini。

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

启用并启动PHP-FPM。

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

安装和配置Nginx

DokuWiki将在任何支持PHP的Web服务器上运行。在本教程中，我们将使用Nginx。如果您更喜欢Apache或其他Web服务器，则可以使用它代替Nginx。

安装Nginx。

sudo pkg install -y nginx

检查版本。

nginx -v
# nginx version: nginx/1.14.2

启用并启动Nginx。

sudo sysrc nginx_enable=yes
sudo service nginx start

sudo vim /usr/local/etc/nginx/dokuwiki.conf为DokuWiki 运行和配置Nginx。

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;
  }

}

保存文件并使用:+ W+ 退出Q。

现在我们需要将dokuwiki.conf文件包括到主nginx.conf文件中。

运行sudo vim /usr/local/etc/nginx/nginx.conf并添加以下行以进行http {}阻止。

include dokuwiki.conf;

测试Nginx配置。

sudo nginx -t

重新加载Nginx。

sudo service nginx reload

安装DokuWiki

创建一个文档根目录。

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

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

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

导航到文档根目录。

cd /usr/local/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-22b/* . && mv dokuwiki-2018-04-22b/.* .
rmdir dokuwiki-2018-04-22b/

将/usr/local/www/dokuwiki目录的所有权更改为www。

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

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

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

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

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