如何在Freebsd 12上安装Dokuwiki

・9 分钟阅读

使用不同的系统?

dokuWiki是用PHP编写的开放源码wiki程序,不需要数据库,它将数据存储在文本文件中,DokuWiki源代码是公共托管在gitHub ,本指南将向你展示,如何在一个新的FreeBSD12实例上安装带有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-productionphp.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 。


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

创建文档root目录。


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

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


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

导航到文档root 。


cd /usr/local/www/dokuwiki

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


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

解压DokuWiki tar文件。


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

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

成功配置后,从DokuWiki root目录中删除install.php文件。


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

你的DokuWiki已经安装,你现在可以访问和编辑http://wiki.example.com/上的wiki 。

Chinaxiong profile image