Содержание
Установка 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
