Инструменты пользователя

Инструменты сайта


freebsd:dokuwiki-inst

Установка DokuWiki на FreeBSD

lonebuddha 2023/05/03 11:12

Задача

Выполнить установку DokuWiki на FreeBSD.

Исходные данные

  • FreeBSD 13.2-RELEASE-p6 amd64;
  • Web-сервер Nginx (без поддержки SSL);
  • Использовать PHP 8.2;
  • Использовать Spawn;
  • Настроить работу Dokuwiki под системной учетной записью www.

Инсталляция необходимых компонентов

Инсталляция Nginx

pkg install nginx

Инсталляция PHP 8.2

pkg install php82
pkg install php82-xml
pkg install php82-session

Инсталляция Spawn

pkg install cpawn-fcgi

Инсталляция DokuWiki

Найти название пакета для установки

pkg search dokuwiki

Ответ будет примерно таким

dokuwiki-php80-20220731a_1     Simple and easy to use wiki, no database required
dokuwiki-php81-20220731a_1     Simple and easy to use wiki, no database required
dokuwiki-php82-20220731a_1     Simple and easy to use wiki, no database required
p5-HTML-WikiConverter-DokuWiki-0.53_1 Convert HTML to DokuWiki markup?

Выбрать нужный пакет и установить

pkg install dokuwiki-php82-20220731a_1

На рабочий каталог Dokuwiki /usr/local/www/dokuwiki необходимо установить правильные права и разрешения

chown -R www:www /usr/local/www/dokuwiki
chmod -R 770 /usr/local/www/dokuwiki

Конфигурирование компонентов

Конфигурирование PHP 8.2

Для работы DokuWiki достаточно использовать стандартные настройки PHP. Так как по умолчанию конфигурационный файл php.ini не создаётся, его необходимо создать из шаблона.

cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Конфигурирование Spawn

Включить автоматический старт spawn-fcgi во время загрузки, добавив в кофигурационный файл /etc/rc.conf

ee /etc/rc.conf

настройку для запуска демона spawn_fcgi

spawn_fcgi_enable="YES"

Ручной запуск spawn_fcgi

/usr/local/etc/rc.d/spawn-fcgi start

При успешном запуске ответ должен быть примерно таким

Starting spawn_fcgi.
spawn-fcgi: child spawned successfully: PID: 56535

Конфигурирование Nginx для первого старта DokuWiki

Включить автоматический старт ngnix во время загрузки, добавив в кофигурационный файл /etc/rc.conf

ee /etc/rc.conf

настройку для запуска демона nginx

nginx_enable="YES"

Конфигурационный файл /usr/local/etc/nginx/nginx.conf

ee /usr/local/etc/nginx/nginx.conf

для первого запуска DokuWiki

# First start config dokuwiki
user www;
worker_processes  1;
 events {
 worker_connections  10;
}
http {
 include mime.types;
 default_type application/octet-stream;
 sendfile on;
 keepalive_timeout 65;
 gzip  on;
 server {
  listen 80;
  server_name localhost;
  root /usr/local/www/dokuwiki;
  index install.php;
  try_files $uri $uri/ /install.php;
  location ~ .php$ {
   include fastcgi_params;
   fastcgi_pass 127.0.0.1:9000;
   fastcgi_index install.php;
   fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  }
 }
}

запустить nginx

/usr/local/etc/rc.d/nginx start

при отсутствии ошибок в настройках ответ должен быть примерно таким

Performing sanity check on nginx configuration:
nginx: the configuration file /usr/local/etc/nginx/nginx.conf syntax is ok
nginx: configuration file /usr/local/etc/nginx/nginx.conf test is successful
Starting nginx.

Подключиться в броузуре к сайту DokyWiki и произвести первоначальное конфигурирование, заполняя необходимые поля

Конфигурирование Nginx для основной работы DokuWiki

Остановить компоненты

/usr/local/etc/rc.d/nginx stop
/usr/local/etc/rc.d/spawn-fcgi stop

Удалить /usr/local/www/dokuwiki/install.php

rf /usr/local/www/dokuwiki/install.php

Конфигурационный файл /usr/local/etc/nginx/nginx.conf

ee /usr/local/etc/nginx/nginx.conf

для основной работы DokuWiki

# Work config dokuwiki
user www;
worker_processes  1;
 events {
 worker_connections  10;
}
http {
 include mime.types;
 default_type application/octet-stream;
 sendfile on;
 keepalive_timeout 65;
 gzip  on;
 server {
  listen 80;
  server_name localhost;
  root /usr/local/www/dokuwiki;
  index index.php doku.php;
  try_files $uri $uri/ /duku.php;
  location ~ .php$ {
   include fastcgi_params;
   fastcgi_pass 127.0.0.1:9000;
   fastcgi_index duku.php;
   fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  }
 }
}

Запустить компоненты

/usr/local/etc/rc.d/spawn-fcgi start
/usr/local/etc/rc.d/nginx start

Информация взята http://microsin.net/adminstuff/xnix/dokuwiki-freebsd-install.html

/www/sites/dokuwiki.win-labs.ru/www/data/pages/freebsd/dokuwiki-inst.txt · Последнее изменение: 2023/05/09 14:25 — 127.0.0.1

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution 4.0 International
CC Attribution 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki