كيفية تثبيت 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-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

قم بفك ضغط ملف 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/.