วิธีการติดตั้ง DokuWiki บน FreeBSD 12

• ความต้องการ
• ก่อนที่จะเริ่ม
• ติดตั้งส่วนขยาย PHP และ PHP
• ติดตั้งและกำหนดค่า Nginx
• ติดตั้ง DokuWiki

DokuWikiเป็นโปรแกรมโอเพ่นซอร์สวิกิที่เขียนด้วย PHP ที่ไม่ต้องการฐานข้อมูล มันเก็บข้อมูลในไฟล์ข้อความ รหัสที่มา DokuWiki เป็นเจ้าภาพสาธารณะบนGitHub คู่มือนี้จะแสดงวิธีการติดตั้ง DokuWiki ด้วย Nginx บนอินสแตนซ์ของ FreeBSD 12 Vultr ใหม่

ความต้องการ

• ซอฟต์แวร์เซิร์ฟเวอร์เว็บที่รองรับ PHP; เช่น 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 ในบทช่วยสอนนี้เราจะใช้ Nginx หากคุณต้องการ Apache หรือเว็บเซิร์ฟเวอร์อื่นคุณสามารถใช้สิ่งนั้นแทน 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และกำหนดค่า Nginx สำหรับ 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;
  }

}

บันทึกไฟล์และออกด้วย:+ +WQ

ตอนนี้เราต้องรวม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/dokuwikijohndoe

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

แกะ 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/

เปลี่ยนความเป็นเจ้าของของไดเรกทอรีไป/usr/local/www/dokuwikiwww

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

เปิดสคริปต์การตั้งค่า DokuWiki install.phpในเบราว์เซอร์ของคุณและตั้งค่า 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/ได้ที่