كيفية تثبيت ProcessWire CMS 3.0 على FreeBSD 11 FAMP VPS

• المتطلبات الأساسية
• الخطوة 1: إضافة مستخدم Sudo
• الخطوة 2: تحديث نظام FreeBSD 11
• الخطوة 3: قم بتثبيت Apache Web Server
• الخطوة 4: تثبيت PHP 7.1
• الخطوة 5: قم بتثبيت خادم MariaDB (MySQL)
• الخطوة 6: إنشاء قاعدة بيانات لـ ProcessWire CMS
• الخطوة 7: تثبيت ملفات CMS ProcessWire
• الخطوة 8: أكمل تثبيت ProcessWire CMS

ProcessWire CMS 3.0 هو نظام إدارة محتوى بسيط ومرن وقوي ومجاني ومفتوح المصدر (CMS). يتميز ProcessWire CMS 3.0 بواجهة برمجة تطبيقات سهلة الاستخدام على غرار jQuery ، وبنية مكونات إضافية كاملة ، ونظام قوالب مرن وقوي يوفر تجربة مستخدم مرضية بالتساوي للمصممين والمطورين والمستخدمين النهائيين.

سنقوم في هذا البرنامج التعليمي بتثبيت ProcessWire CMS 3.0 على FreeBSD 11 FAMP VPS باستخدام خادم الويب Apache و PHP 7.1 وقاعدة بيانات MariaDB.

المتطلبات الأساسية

• نسخة خادم نظيفة Vultr FreeBSD 11 مع وصول SSH

الخطوة 1: إضافة مستخدم Sudo

سنبدأ بإضافة sudoمستخدم جديد .

أولاً ، قم بتسجيل الدخول إلى الخادم الخاص بك على النحو التالي root:

ssh root@YOUR_VULTR_IP_ADDRESS

و sudoلم يتم تثبيت الأوامر الافتراضية في المثال 11 الخادم Vultr فري، لذلك سنقوم أولا تثبيت sudo:

pkg install sudo

أضف مستخدمًا جديدًا يسمى user1(أو اسم المستخدم المفضل لديك):

adduser user1

و adduserسوف قيادة يطالبك الكثير من التفاصيل لحساب المستخدم، وذلك ببساطة اختيار الإعدادات الافتراضية بالنسبة لمعظمهم، عندما كان من المنطقي أن تفعل ذلك. عندما يُطلب منك ما إذا كان Invite user1 into any other groups?يجب عليك الدخول wheelلإضافتها user1إلى wheelالمجموعة.

تحقق الآن من /etc/sudoersالملف للتأكد من sudoersتمكين المجموعة:

visudo

ابحث عن قسم مثل هذا:

# %wheel        ALL=(ALL)       ALL

يخبرنا هذا السطر أن المستخدمين الذين هم أعضاء في wheelالمجموعة يمكنهم استخدام sudoالأمر للحصول على rootالامتيازات. سيتم التعليق عليه افتراضيًا لذا ستحتاج إلى إلغاء تعليقه ثم حفظ الملف والخروج منه.

يمكننا التحقق من user1عضوية المجموعة باستخدام groupsالأمر:

groups user1

إذا user1لم يكن عضوًا في wheelالمجموعة ، يمكنك استخدام هذا الأمر لتحديث user1عضوية المجموعة:

pw group mod wheel -m user1 

الآن استخدم suالأمر للتبديل إلى user1حساب مستخدم sudo الجديد :

su - user1

سيتم تحديث موجه الأوامر للإشارة إلى أنك قمت بتسجيل الدخول الآن إلى user1الحساب. يمكنك التحقق من ذلك باستخدام whoamiالأمر:

whoami

الآن قم بإعادة تشغيل sshdالخدمة بحيث يمكنك تسجيل الدخول عبر sshحساب مستخدم sudo الجديد غير الجذر الذي أنشأته للتو:

sudo /etc/rc.d/sshd restart

الخروج من user1الحساب:

exit

اخرج من rootالحساب (الذي سيؤدي إلى قطع جلستك ssh):

exit

يمكنك الآن sshالدخول إلى مثيل الخادم من مضيفك المحلي باستخدام user1حساب مستخدم sudo الجديد غير الجذر :

ssh user1@YOUR_VULTR_IP_ADDRESS

إذا كنت تريد التنفيذ sudoدون الحاجة إلى كتابة كلمة مرور في كل مرة ، فافتح /etc/sudoersالملف مرة أخرى باستخدام visudo:

sudo visudo

قم بتحرير قسم wheelالمجموعة بحيث يبدو كالتالي:

%wheel        ALL=(ALL)       NOPASSWD: ALL

يرجى ملاحظة ما يلي: تعطيل متطلبات كلمة المرور لمستخدم sudo ليس ممارسة موصى بها ، ولكن يتم تضمينه هنا لأنه يمكن أن يجعل تكوين الخادم أكثر ملاءمة وأقل إحباطًا ، خاصة خلال جلسات إدارة الأنظمة الأطول. إذا كنت قلقًا بشأن الآثار الأمنية ، فيمكنك دائمًا إعادة تغيير التكوين إلى الإعداد الأصلي بعد الانتهاء من مهام الإدارة.

عندما تريد تسجيل الدخول إلى rootحساب المستخدم من داخل sudoحساب المستخدم ، يمكنك استخدام أحد الأوامر التالية:

sudo -i
sudo su -

يمكنك الخروج من rootالحساب والعودة إلى sudoحساب المستخدم الخاص بك في أي وقت بمجرد الكتابة exit.

الخطوة 2: تحديث نظام FreeBSD 11

قبل تثبيت أي حزم على مثيل خادم FreeBSD ، سنقوم أولاً بتحديث النظام.

تأكد من أنك قمت بتسجيل الدخول إلى الخادم باستخدام مستخدم sudo غير الجذر وتشغيل الأوامر التالية:

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

الخطوة 3: قم بتثبيت Apache Web Server

قم بتثبيت خادم الويب Apache 2.4:

sudo pkg install apache24

وأدخل yعند المطالبة. الآن استخدم sysrcالأمر لتمكين خدمة Apache للتنفيذ تلقائيًا في وقت التمهيد:

sudo sysrc apache24_enable=yes

يقوم sysrcالأمر بتحديث /etc/rc.confملف التكوين ، لذلك إذا كنت تريد التحقق من تحديث التكوين يدويًا ، يمكنك ببساطة فتح /etc/rc.confالملف باستخدام محرر المحطة الطرفية المفضل لديك:

vi /etc/rc.conf

ابدأ الآن خدمة Apache:

sudo service apache24 start

يمكنك التحقق بسرعة من تشغيل apache عن طريق زيارة عنوان IP أو مجال مثيل الخادم في المستعرض الخاص بك:

http://YOUR_VULTR_IP_ADDRESS/

سترى صفحة FreeBSD Apache الافتراضية التي تعرض النص:

It works!

تحقق من ملف التكوين الافتراضي لـ Apache للتأكد من أن DocumentRootالتوجيه يشير إلى الدليل الصحيح:

sudo vi /usr/local/etc/apache24/httpd.conf

و DocumentRootسوف خيار التكوين تبدو هذه:

DocumentRoot "/usr/local/www/apache24/data"

نحتاج الآن إلى تمكين mod_rewriteوحدة Apache. يمكننا القيام بذلك من خلال البحث في ملف تكوين Apache الافتراضي عن المصطلح mod_rewrite.

بشكل افتراضي ، mod_rewriteسيتم التعليق على وحدة Apache (مما يعني أنها معطلة). سيبدو خط التكوين في مثيل Vultr FreeBSD 11 نظيفًا كما يلي:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

ما عليك سوى إزالة رمز التجزئة لتفكيك الخط وتحميل الوحدة. ينطبق هذا بالطبع على أي وحدات أباتشي أخرى مطلوبة أيضًا:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

نحتاج الآن إلى تحرير Directoryتوجيه Apache في نفس ملف التكوين بحيث mod_rewriteيعمل بشكل صحيح مع ProcessWire CMS.

ابحث عن قسم ملف التكوين الذي يبدأ بـ <Directory "/usr/local/www/apache24/data">ويتغير AllowOverride noneإلى AllowOverride All. ستبدو النتيجة النهائية (مع إزالة جميع التعليقات) كما يلي:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

الآن قم بحفظ ملف تكوين Apache والخروج منه.

سنقوم بإعادة تشغيل Apache في نهاية هذا البرنامج التعليمي ، ولكن إعادة تشغيل Apache بانتظام أثناء التثبيت والتكوين هي بالتأكيد عادة جيدة ، لذلك دعونا نفعل ذلك الآن:

sudo service apache24 restart

الخطوة 4: تثبيت PHP 7.1

يمكننا الآن تثبيت PHP 7.1 مع جميع وحدات PHP اللازمة التي تتطلبها ProcessWire CMS:

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib php71-openssl php71-zip

FreeBSD 11 يمنحنا خيار استخدام تطوير php.iniأو إنتاج php.ini. نظرًا لأننا سنقوم بتثبيت Siverstripe على خادم ويب عام ، فسنستخدم إصدار الإنتاج. أولاً ، النسخ الاحتياطي php.ini-production:

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

ثم رابط ناعم php.ini-productionإلى php.ini.

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

نحتاج إلى تكوين Apache لاستخدام PHP بالفعل ، لذلك دعونا ننشئ ملفًا جديدًا يسمى php.confفي Includesدليل Apache :

sudo vi /usr/local/etc/apache24/Includes/php.conf

أدخل النص التالي في الملف الذي تم إنشاؤه حديثًا:

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

حفظ وإنهاء الملف.

الآن دعونا نعيد تشغيل Apache حتى يتمكن من إعادة تحميل تغييرات التكوين:

sudo service apache24 restart

الخطوة 5: قم بتثبيت خادم MariaDB (MySQL)

يقوم FreeBSD 11 افتراضيًا باستخدام خادم قاعدة بيانات MariaDB ، وهو مصدر محسّن ومفتوح المصدر بالكامل ، تم تطويره من قبل المجتمع ، واستبدال بديل لخادم MySQL.

تثبيت خادم قاعدة بيانات MariaDB:

sudo pkg install mariadb102-server mariadb102-client

ابدأ وتمكين خادم MariaDB من التنفيذ تلقائيًا في وقت التمهيد:

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

تأمين تثبيت خادم MariaDB الخاص بك:

sudo mysql_secure_installation

عندما يُطلب منك إنشاء rootمستخدم MariaDB / MySQL ، حدد "ص" (نعم) ثم أدخل rootكلمة مرور آمنة . ما عليك سوى الإجابة بـ "Y" على جميع الأسئلة الأخرى بنعم / لا لأن الاقتراحات الافتراضية هي الخيارات الأكثر أمانًا.

الخطوة 6: إنشاء قاعدة بيانات لـ ProcessWire CMS

قم بتسجيل الدخول إلى shell MariaDB rootكمستخدم MariaDB عن طريق تشغيل الأمر التالي:

sudo mysql -u root -p

للوصول إلى موجه أوامر MariaDB ، ما عليك سوى إدخال rootكلمة مرور MariaDB عند مطالبتك بذلك.

قم بتشغيل الاستعلامات التالية لإنشاء قاعدة بيانات ومستخدم قاعدة بيانات MariaDB لـ ProcessWire CMS:

CREATE DATABASE pw_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'pw_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON pw_db.* TO 'pw_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

يمكنك استبدال اسم قاعدة البيانات واسم pw_dbالمستخدم pw_userبشيء أكثر ترضيك ، إذا كنت تفضل ذلك. تأكد أيضًا من استبدال "UltraSecurePassword" بكلمة مرور آمنة بالفعل.

الخطوة 7: تثبيت ملفات CMS ProcessWire

تغيير دليل العمل الحالي إلى دليل الويب الافتراضي:

cd /usr/local/www/apache24/data

دليل العمل الحالي الخاص بك يجب أن تكون الآن: /usr/local/www/apache24/data. يمكنك التحقق من ذلك باستخدام الأمر pwd(طباعة دليل العمل):

pwd

استخدم الآن wgetلتنزيل حزمة تثبيت ProcessWire CMS:

sudo wget https://github.com/processwire/processwire/archive/master.zip

يرجى ملاحظة ما يلي: يجب عليك بالتأكيد التحقق من أحدث إصدار من خلال زيارة صفحة تنزيل ProcessWire CMS .

قم بإدراج الدليل الحالي للتأكد من أنك قمت بتنزيل الملف بنجاح:

ls -la

إزالة index.html:

sudo rm index.html

الآن قم بفك ضغط الأرشيف المضغوط:

sudo unzip master.zip

انقل جميع ملفات التثبيت إلى دليل جذر الويب:

sudo mv processwire-master/* /usr/local/www/apache24/data

قم بتغيير ملكية ملفات الويب لتجنب أي مشاكل في الأذونات:

sudo chown -R www:www * ./

أعد تشغيل Apache مرة أخرى:

sudo service apache24 restart

الخطوة 8: أكمل تثبيت ProcessWire CMS

حان الوقت الآن لزيارة عنوان IP لمثيل الخادم الخاص بك في متصفحك ، أو إذا قمت بالفعل بتكوين إعدادات Vultr DNS الخاصة بك (ومنحت الوقت الكافي للنشر) يمكنك ببساطة زيارة نطاقك بدلاً من ذلك.

للوصول إلى صفحة تثبيت ProcessWire CMS ، أدخل عنوان IP لمثيل Vultr في شريط عنوان المتصفح ، متبوعًا بـ index.php:

http://YOUR_VULTR_IP_ADDRESS/install.php

يحتوي مثبت ProcessWire CMS على الكثير من الخيارات ، لذا إليك بعض المؤشرات لمساعدتك:

1. في صفحة الترحيب بتثبيت ProcessWire CMS ، انقر فوق Get Startedالزر لبدء عملية التثبيت.

2. الآن حدد ملف تعريف التثبيت المفضل لديك (أو الموقع التجريبي) وانقر Continue.

3. سترى Compatibility Checkصفحة. إذا رأيت أي أخطاء ، فهذا يعني على الأرجح أنك تفتقد بعض وحدات PHP أو لديك مشكلة أذونات ، وإلا يمكنك ببساطة النقر Continue.

4. أدخل القيم التالية في MySQL Database Settingsالصفحة:

   DB Name:            pw_db
   DB User:            pw_user
   DB Pass:            UltraSecurePassword
   DB Host:            localhost
   DB Port:            3306
   

5. يمكنك ترك File Permissionالإعدادات عند قيمها الافتراضية ، أو يمكنك ضبطها إذا كنت تفهم الآثار المترتبة عليها.

6. يمكنك إدخال أسماء المضيفين المستقبلية لموقعك في القسم المناسب ، أو يمكنك تعديل site/config.phpالملف لاحقًا إذا كنت تفضل ذلك.

7. انقر فوق Continueلتكوين قاعدة البيانات وتثبيت ملفات ProcessWire CMS.

8. بعد ذلك ، حدد المفضل لديك Admin Theme.

9. يمكنك تغيير Admin URLإذا كنت تفضل ذلك ، أو يمكنك تركه بالقيمة الافتراضية.

10. أدخل الخاص بك Admin Login Detailsكما هو موضح أدناه:

    User (a-z 0-9):     <admin username>
    Password:           <admin password>
    Password (again):   <same admin password>
    Email Address:      <admin email address>
    

11. بمجرد إدخال جميع التفاصيل المناسبة ، يمكنك النقر Continueلإنهاء تثبيت ProcessWire.

12. بمجرد اكتمال التثبيت ، ما Login to Adminعليك سوى النقر فوق الزر لتسجيل الدخول إلى قسم المسؤول.

قد ترى تحذيرًا يقول شيئًا مثل:

Warning: your server locale is undefined and may cause issues. Please add this to /site/config.php file (adjust en_US.UTF-8†as needed): setlocale(LC_ALL,'en_US.UTF-8');

يمكنك إصلاح هذا الخطأ عن طريق تحرير site/config.phpالملف:

sudo vi site/config.php

ألحق القيمة المناسبة في نهاية الملف:

setlocale(LC_ALL,'en_GB.utf8');

إذا لم تتمكن من معرفة القيمة المراد استخدامها ، يمكنك العثور على قائمة بالقيم المناسبة لمثيل الخادم الخاص بك عن طريق تشغيل localeالأمر:

locale -a

لا تنس حفظ site/config.phpالملف والخروج منه عند الانتهاء من التحرير.

لأغراض أمنية ، تأكد من تغيير الأذونات على site/config.phpالملف:

sudo chmod 400 site/config.php

أعد تشغيل Apache.

sudo service apache24 restart

أنت على استعداد لبدء إضافة المحتوى الخاص بك وتكوين شكل وأسلوب موقعك. تأكد من مراجعة وثائق ProcessWire CMS الممتازة للحصول على مزيد من المعلومات حول كيفية إنشاء موقعك وتكوينه.