كيفية تثبيت برنامج SourceGuardian في DirectAdmin

كيف أقوم بتثبيت برنامج SourceGuardian مباشرةً على DirectAdmin؟

في هذا الدليل خطوة بخطوة سنشرح كيفية تثبيت أدوات تحميل SourceGuardian لمختلف واجهات برمجة التطبيقات (CLI، PHP-FPM، Apache/LiteSpeed) في لوحة تحكم DirectAdmin. هذه المقالة مناسبة لمديري الخوادم، ومطوري PHP، ومستخدمي خوادم VPS/Cloud، والشركات التي تستخدم ملفات PHP المشفرة بواسطة SourceGuardian.

المتطلبات الأساسية (قبل البدء)

قبل أي شيء آخر تأكد من توفر ما يلي:

• الوصول إلى الخادم عبر SSH باستخدام اسم المستخدم جذر أو الوصول سودو.
• معرفة إصدارات PHP المثبتة وواجهات برمجة التطبيقات (SAPIs) المُفعّلة (على سبيل المثال مع php -v(تحقق من php-fpm أو Apache/lsphp).
• قم بالوصول إلى صفحة تنزيل برامج التحميل الخاصة بـ SourceGuardian: محملات سورس جارديان.
• إذا كنت تستخدم CloudLinux/alt-php، فستحتاج إلى مسارات محددة مثل /opt/alt/... يعتبر.

الخطوة 1 - تحديد إصدار PHP وواجهات برمجة التطبيقات (SAPIs)

لكل إصدار من PHP ترغب في تفعيل SourceGuardian له، عليك معرفة ما يلي:

• إصدار PHP (على سبيل المثال 7.4، 8.0).
• مسار ثنائي لواجهة سطر الأوامر و ملف php.ini ذي الصلة.
• هل لغة PHP تأتي على شكل FPM هل تم تنفيذه أم mod_php/lsphp؟

أوامر مفيدة للتحقق:

php -v
php -m | grep SourceGuardian
php -i | grep "Loaded Configuration File"
php -i | grep "extension_dir"
php -i | grep "Thread Safety"

للتحقق من واجهة برمجة تطبيقات الويب (SAPI)، ملف phpinfo.php قم بإنشائه في مجلد public_html ثم قم بزيارته في متصفح.

<?php phpinfo(); ?>

في phpinfo، ابحث عن أشياء مثل تم تحميل ملف التكوين، extension_dir و أمان الخيوط انظر حولك.

الخطوة 2 - قم بتنزيل برنامج التحميل المناسب

من صفحة SourceGuardian الرسمية، قم بتنزيل الحزمة المناسبة لنظام التشغيل الخاص بك وبنيته (على سبيل المثال). لينكس x86_64) وقم بتنزيل إصدار PHP.

رابط التحميل الرسمي:

https://www.sourceguardian.com/loaders/

أمثلة على أوامر التنزيل والاستخراج:

wget https://www.sourceguardian.com/loaders/download/loaders.linux-x86_64.tar.gz
tar -xzvf loaders.linux-x86_64.tar.gz

بعد الاستخراج، ملفات مثل ixed.7.4.lin أو ixed.8.0.lin سترى ذلك. يعتمد الاسم الدقيق على إصدار PHP.

الخطوة 3 - اختر ملف التحميل الصحيح (TS/NTS و API)

نقاط مهمة عند اختيار ملف:

• أمان الخيوط: إذا كان الناتج php -i | grep "Thread Safety"" كمية عاجز عرض، جارٍ البحث عن ملف NTS كن؛ وإلا TS.
• واجهة برمجة تطبيقات PHP: قيمة واجهة برمجة التطبيقات في phpinfo() يتم عرضها؛ تأكد من أن ملف التحميل يطابق إصدار PHP API.

الخطوة 4 - انسخ برنامج التحميل إلى المسار المناسب

بدلاً من تخمين المسارات، استخدم الكمية extension_dir مثال على الاستخدام:

EXTDIR=$(php -i | grep extension_dir | awk -F '=> ' '{print $2}')
cp ixed.7.4.lin $EXTDIR/ixed.7.4.lin
chown root:root $EXTDIR/ixed.7.4.lin
chmod 644 $EXTDIR/ixed.7.4.lin

ملاحظة حول التوزيعات:

• عادةً ما تحتوي أنظمة CentOS/RHEL على مسارات مثل /usr/lib64/php/modules/ نعم، لقد فعلوا.
• مسارات Debian/Ubuntu مثل /usr/lib/php/20190902/ أو ما شابه ذلك.
• قد يحتوي CloudLinux/alt-php على مسارات مثل /opt/alt/php74/usr/lib64/php/modules/ يملك.

الخطوة 5 - تفعيل أداة التحميل عبر ملف php.ini أو conf.d

لتحميل أداة التحميل من خلال الأمر zend_extension الاستخدام. مثال (الطريقة القياسية لنظامي CentOS/RedHat):

echo "zend_extension=$EXTDIR/ixed.7.4.lin" > /etc/php.d/20-sourceguardian.ini

أو إذا كان ملف php.ini موجودًا في مسار مختلف:

echo "zend_extension=/usr/lib64/php/modules/ixed.7.4.lin" > /usr/local/php74/etc/php.d/20-sourceguardian.ini

ملحوظة: اختر اسم ملف ini بحيث يتم تحميله قبل الملفات التابعة الأخرى؛ عادةً ما تكون البادئات رقمية مثل 10- أو 20- هذا أمر شائع.

الخطوة 6 - أعد تشغيل الخدمات ذات الصلة

أعد تشغيل الخدمات التالية حسب SAPI:

• PHP-FPM:

  systemctl restart php-fpm
  # or for separate versions
  systemctl restart php74-php-fpm

• خادم ويب Apache/HTTPD:

  systemctl restart httpd
  # Ubuntu:
  systemctl restart apache2

• لايت سبيد/أوبن لايت سبيد:

  systemctl restart lsws

للتحقق من أسماء الخدمات:

systemctl list-units | grep php
systemctl list-units | grep http

الخطوة 7 - فحص التثبيت واستكشاف الأخطاء وإصلاحها

للتحقق من خلال واجهة سطر الأوامر:

php -v

يجب أن ترى إشارة إلى SourceGuardian أو ixed loader في المخرجات.

للتحقق من الإنترنت:

• صفحة phpinfo() افتح وابحث عن القسم المتعلق بـ حارس المصدر انظر حولك.
• من php -m استخدم لعرض الوحدات النمطية.

الأخطاء الشائعة والحلول

1) خطأ "لا يمكن تحميل إضافة Zend" أو خطأ في السجلات

• مسار الملف غير صحيح أو أن الملف لا يملك الصلاحيات اللازمة. تحقق من ذلك باستخدام chown root:root و chmod 644 تم ضبط المالك والإذن بشكل صحيح.
• الملف غير مناسب لبنية أو إصدار PHP (TS مقابل NTS أو إصدار مختلف).
• قد يمنع SELinux التحميل؛ تحقق من الحالة باستخدام فرض يفحص.

2) يتم تحميل برنامج التحميل في واجهة سطر الأوامر ولكن ليس على الويب

• من المحتمل أن يستخدم Apache أو PHP-FPM إصدارًا مختلفًا من PHP؛ تأكد من التحقق من phpinfo() عبر الويب وتثبيت أداة التحميل لنفس الإصدار.
• قد لا يكون ملف تهيئة المحمل موجودًا في مسار conf.d المتعلق بـ Web SAPI.

3) بيئات متعددة PHP/CloudLinux

• لكل إصدار بديل من PHP أو إصدار منفصل، انسخ المحمل إلى المسار المقابل وقم بإنشاء ملف ini المناسب، ثم أعد تشغيل الخدمة المرتبطة.

نصائح أمنية وتشغيلية

• لا تضع أداة التحميل في الدلائل التي يمكن الوصول إليها عبر الويب (public_html) لا تضعه.
• يجب على مالك الملف جذر والوصول 644 سيتم تحديده.
• قم بتنزيل الحزم فقط من موقع SourceGuardian الرسمي وتحقق من المجموع الاختباري أو التوقيع إن أمكن.
• عند ترقية PHP، لا تنس تثبيت المحمل المناسب للإصدار الجديد.
• بالنسبة لبيئات الإنتاج، اختبر أولاً على خادم الاختبار.

مثال عملي - التثبيت لـ PHP 7.4 (ملخص الأوامر)

wget https://www.sourceguardian.com/loaders/download/loaders.linux-x86_64.tar.gz
tar -xzvf loaders.linux-x86_64.tar.gz
EXTDIR=$(php -i | grep extension_dir | awk -F '=> ' '{print $2}')
cp ixed.7.4.lin $EXTDIR/ixed.7.4.lin
chown root:root $EXTDIR/ixed.7.4.lin
chmod 644 $EXTDIR/ixed.7.4.lin
echo "zend_extension=$EXTDIR/ixed.7.4.lin" > /etc/php.d/20-sourceguardian.ini
systemctl restart php-fpm
systemctl restart httpd
php -v

ثم عبر المتصفح phpinfo() تحقق مما إذا كان برنامج التحميل معروضًا في القسم ذي الصلة.

ملاحظة حول DirectAdmin و custombuild

إذا قمت بتجميع أو تثبيت PHP باستخدام DirectAdmin CustomBuild، فستكون المسارات php.ini و extension_dir قد يكون ذلك في /usr/local/php*/ أو مجلداتها الفرعية. قبل نسخ أداة التحميل، تحقق من المسارات عبر الملف الثنائي لكل إصدار من PHP (على سبيل المثال). /usr/local/php74/bin/php -i) تحقق من ملف ini المناسب وضعه في المجلد إلخ/php.d ضع نفس الإصدار.

لماذا من المهم تثبيت برنامج SourceGuardian بشكل صحيح؟

أسباب أهمية التركيب الصحيح:

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

الخدمات والدعم ذو الصلة

إذا كان خادمك يحتوي على إصدارات متعددة من PHP أو تكوينات معقدة مثل CloudLinux/alt-php، فيمكن للفريق التقني تثبيت وتكوين إصدارات متعددة من PHP واستكشاف أخطاء تكوينات محددة وإصلاحها مثل LiteSpeed أو SELinux.

شرح التغطية الجغرافية: يمكن تقديم الخدمات الفنية عبر شبكة تضم أكثر من 85 موقعًا عالميًا، بما في ذلك التركيب والاختبار والتكوين.

الأسئلة الشائعة