دليل التثبيت

اختر ملف إصدار مستقل لماسح منفصل. اختر Composer عندما تريد إدارة الاعتمادات أو الاستخدام البرمجي.

المتطلبات

يتطلب PHP 7.4 أو أحدث. راجع الامتدادات المطلوبة قبل التثبيت.

نسخة مستقلة

حمّل أحدث ملف scanner من صفحة إصدارات GitHub أو استرجع البناء الحالي:

curl --fail --silent --show-error --location \
  --output scanner \
  https://raw.githubusercontent.com/marcocesarato/PHP-Antimalware-Scanner/master/dist/scanner

تحقق من إصدار الماسح، ثم شغّل فحصا بتقرير فقط:

php scanner --version
php scanner /var/www/example --lite --report

احتفظ بالماسح خارج الدليل الذي تفحصه. هذا يمنع ملف الإصدار وتقارير التشغيل من الظهور داخل نطاق الفحص.

احتفظ بالتحقق من TLS ممكنا

لا تستخدم --no-check-certificate أو خيارا مكافئا. قد يشير فشل التحقق من الشهادة إلى مشكلة في الشبكة أو متجر الثقة تحتاج إلى اهتمام.

Composer

يتم نشر الحزمة باسم marcocesarato/amwscan.

تثبيت لمشروع واحد

composer require marcocesarato/amwscan
php vendor/marcocesarato/amwscan/src/index.php /var/www/example --lite --report

يثبت تثبيت المشروع إصدار الماسح في composer.lock، ما يساعد الفرق ومهام التكامل المستمر على استخدام نفس الإصدار.

تثبيت للمستخدم الحالي

composer global require marcocesarato/amwscan
php "$(composer global config home)/vendor/marcocesarato/amwscan/src/index.php" /var/www/example --lite --report

في Windows PowerShell:

$composerHome = composer global config home
php "$composerHome\vendor\marcocesarato\amwscan\src\index.php" "C:\Sites\example" --lite --report

التحقق من المصدر

استخدم تحقق المصدر عند المساهمة أو اختبار تغييرات غير منشورة:

git clone https://github.com/marcocesarato/PHP-Antimalware-Scanner.git
cd PHP-Antimalware-Scanner
composer install
php src/index.php /var/www/example --lite --report

لا تستخدم فرع التطوير كبديل صامت لإصدار إنتاج ثابت.

Docker

تُنشر الصورة المدعومة على Docker Hub:

docker pull marcocesarato/php-antimalware-scanner:latest

استخدم latest للإصدار المستقر الحالي. ثبّت وسم إصدار كامل مثل 0.19.1 في مهام الأتمتة.

قم بتركيب الهدف للقراءة فقط لإجراء فحص تقرير أولي، مع دليل إخراج منفصل للتقارير:

docker run --rm \
  --volume "/var/www/example:/scan:ro" \
  --volume "$PWD/amwscan-output:/output" \
  marcocesarato/php-antimalware-scanner:latest /scan \
  --lite --report-only --report-format=html \
  --path-report=/output/report.html \
  --disable-checksum --disable-definitions-update

لاختبار التغييرات من نسخة محلية من المصدر، أنشئ الصورة محليًا واستبدل اسم صورة Docker Hub في الأمر السابق:

docker build --tag amwscan .

مكوّن WordPress

يضيف مكوّن WordPress عمليات الفحص المجدولة ومراجعة التقارير وحماية التحميلات والحجر والإجراءات الوقائية على الملفات إلى منطقة الإدارة.

ثبت مكوّن WordPress

التحقق من التثبيت

يجب أن يعيد تثبيت صحيحة نسخة ويظهر المساعدة دون أخطاء في بدء تشغيل PHP:

php scanner --version
php scanner --help

تابع إلى تشغيل فحصك الأول.