====== Установка DokuWiki на FreeBSD ======
 --- //[[winogradov@list.ru|lonebuddha]] 2023/05/03 11:12//

===== Задача =====
Выполнить установку [[https://www.dokuwiki.org/dokuwiki|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]]

{{tag>FreeBSD www DokuWiki}}