Як встановити DokuWiki на FreeBSD 12

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-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. У цьому уроці ми будемо використовувати 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;
  }

}

Збережіть файл і вийдіть за допомогою :+ 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

Розпакуйте tar-архів 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

Відкрийте скрипт налаштування DokuWiki, install.php, у своєму браузері та налаштуйте DokuWiki. Сценарій встановлення перевіряє наявність необхідних функцій PHP і перевіряє необхідні дозволи на файл. Він також створює початковий обліковий запис адміністратора та початкову політику ACL. Щоб запустити інсталятор, відкрийте http://wiki.example.com/install.phpв браузері та дотримуйтесь інструкцій.

Після успішної конфігурації видаліть install.phpфайл із кореневого каталогу DokuWiki.

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

Вашу DokuWiki було встановлено, і тепер ви можете отримати доступ до функціональної вікі й редагувати її за адресою http://wiki.example.com/.