
أداة Bash تفحص إعدادات PHP INI ومجمع FPM وإعدادات الموقع بحثًا عن session.upload_progress.enabled وتطبّق تخفيف CVE-2026-115560 مع النسخ الاحتياطي والتراجع.
أداة Bash مستقلة للعثور على إعدادات PHP وتطبيق التخفيف المؤقت الذي أوصى به مشروع PHP:
session.upload_progress.enabled = 0
الحالة (2026-10-24): تخفيف مؤقت، وليس تصحيحًا أمنيًا لـ PHP. في 2026-10-23، نصحت مشروع PHP بتعطيل تقدّم رفع الجلسات في PHP حتى إصدار إصلاح الأخطاء العادي التالي لمعالجة سيناريو RCE غير المرجّح. يتضمن إعداد التطبيق المتأثر ضبط session.serialize_handler على php_binary / php_serialize في التهيئة، ثم تغييره إلى php أثناء التشغيل قبل session_start()، مع بقاء تقدّم الرفع مُفعّلًا. وفقًا لإشعار PHP، فإن التطبيقات التي لا تغيّر مُسلسِل الجلسة أثناء التشغيل ليست معرّضة لهذا السيناريو تحديدًا. تطبّق هذه الأداة حلًا احتياطيًا متحفظًا على مستوى التهيئة؛ وهي لا تحاول الاستغلال أو فحص الثغرات.
راجع السكربت قبل تشغيله بصلاحيات الجذر:
git clone https://github.com/ivst/CVE-2026-115560.git
cd CVE-2026-115560
bash -n php-upload-progress-mitigate.sh
sudo bash php-upload-progress-mitigate.sh --check
sudo bash php-upload-progress-mitigate.sh --apply
# Read the changes; reload validated managed PHP-FPM / Apache services:
sudo bash php-upload-progress-mitigate.sh --apply --reload
sudo bash php-upload-progress-mitigate.sh --check
# Optional: inspect running Docker PHP-FPM configurations as well (read-only):
sudo bash php-upload-progress-mitigate.sh --check --check-docker
للتحقق من خدمات PHP-FPM وApache systemd المكتشفة وإعادة تحميلها بسلاسة كجزء من تطبيق التخفيف:
sudo bash php-upload-progress-mitigate.sh --apply --reload
يحدد السكربت عمليات PHP-FPM الرئيسية المُدارة عبر معرّفات العمليات (PIDs) قيد التشغيل وMainPID الخاص بـ systemd، ويقرأ مسار الإعدادات من العملية الرئيسية، ويشغّل ملف FPM التنفيذي المطابق باستخدام -t -y <config>، ثم يستخدم systemctl reload فقط إذا كان CanReload=yes. يتلقى Apache اختبار إعدادات قبل إعادة التحميل السلسة الخاصة به. لن يقوم السكربت المساعد بإرسال إشارات تلقائيًا إلى عمليات FPM الرئيسية غير المعروفة، أو الإعدادات غير المُتحقَّق منها، أو الخدمات التي تفتقر إلى دعم إعادة التحميل؛ بل يطبع تحذيرات ويخرج بحالة 2 عند الحاجة إلى مراجعة يدوية.
تظل إعادة التشغيل القسرية الصريحة ممكنة باستخدام --apply --restart، لكن لا يُنصح بذلك للمواقع الإنتاجية إلا عند الحاجة:
sudo bash php-upload-progress-mitigate.sh --apply --restart
تحذير: حتى عمليات إعادة التحميل السلسة قد تتسبب في أخطاء قصيرة الأمد أو إنهاء بعض الطلبات طويلة الأمد. لا تُطبَّق التغييرات على الملفات تلقائيًا على العمال قيد التشغيل ما لم يعيدوا التحميل أو يُعاد تشغيلهم. لا يمكن لهذه الأداة ضمان التغطية الكاملة للحاويات أو العمليات المُدارة عبر لوحة التحكم خارج تخطيطات PHP المكتشفة. يُفضَّل استخدام نافذة صيانة والتأكد من إعدادات web-SAPI الحية.
php-upload-progress-mitigate.sh [--check|--apply] [--reload|--restart] [--check-docker] [--root=/offline/root] [--site-root=/path]
php-upload-progress-mitigate.sh --rollback=/absolute/backup/directory [--apply] [--root=/offline/root]
| العلامة | الغرض |
|---|---|
--check | الافتراضي. فحص ساكن فقط؛ لا يعدّل الملفات. |
--check-docker | اختياري مع --check للمضيف الحيّ: استخدم Docker CLI لفحص PHP-FPM وخوادم الويب المدمجة في PHP داخل حاويات Docker قيد التشغيل. لا تغييرات ولا إعادة تشغيل. |
--apply | كتابة التخفيفات مع نسخ احتياطية. يتطلب صلاحيات root. |
--reload | مع --apply، تحقّق من خدمات systemd المُدارة الخاصة بـ PHP-FPM/Apache وأعد تحميلها بلطف؛ تُتخطّى الخدمات غير المدعومة/غير المتحقَّق منها مع تحذيرات. |
--restart | مع --apply، تحقّق من الخدمات المُدارة المؤهلة وأعد تشغيلها إعادةً قسرية. استخدمه فقط عند الرغبة في إعادة تشغيل قسرية. |
--root=/path | افحص/طبّق على شجرة نظام ملفات دون اتصال؛ لا تُعد تشغيل الخدمات في هذا الوضع أبدًا. مخصّص للاختبار/الصيانة دون اتصال. |
--site-root=/path | أضف دليل موقع إلى فحص التجاوز للقراءة فقط؛ كرّر ذلك لعدة أدلة. مع --root، يكون هذا مسارًا داخل الشجرة دون اتصال (مثل /srv/apps). |
--rollback=/path | معاينة استعادة دليل نسخ احتياطي واحد. أضف --apply لاستعادة الملفات المنسوخة احتياطيًا وإزالة الملفات التي أنشأها ذلك التشغيل. لا يمكن دمجه مع إجراءات الخدمات أو Docker أو فحوصات المواقع. |
رموز الخروج: 0 عند عدم اكتشاف تحذيرات، و1 عند خطأ فادح/خطأ في الاستخدام، و2 عند الحاجة إلى مراجعة يدوية. قد يكتب تشغيل --apply ملفات تخفيف و يعيد 2 إذا صادف تحذيرات إضافية غير معالجة.
يفحص السكربت التخطيطات الشائعة المستخدمة في Debian/Ubuntu وأنظمة عائلة RHEL وRemi ومسارات تثبيت PHP القياسية ولوحات الاستضافة الشائعة، بما في ذلك وقت تشغيل التطبيقات الداخلي في FASTPANEL (/opt/fphp/php.ini، /opt/fphp/conf.d، /opt/fphp/etc/php-fpm.d). وبالنسبة لأشجار INI المكتشفة يكتب تجاوزًا zzzzzz-cve-2026-115560.ini يُحمَّل متأخرًا، أو يعدّل php.ini عند عدم وجود دليل فحص. كما يكتشف البدائل الخاصة بـ SAPI مثل php-cli.ini (والتي يمكن لـ PHP تحميلها بدلًا من php.ini) ويفحص أدلة الفحص الشقيقة مثل /opt/php85/conf.d المستخدمة في عمليات التثبيت المُدارة عبر اللوحات. كما يُدرج php_admin_value[session.upload_progress.enabled] = 0 في أقسام تجمّعات PHP-FPM المكتشفة لمنع التجاوزات اللاحقة لكل دليل لهذا الإعداد في تلك التجمّعات.
تُخزَّن النسخ الاحتياطية للملفات المعدّلة وبيان التغييرات تحت:
/var/backups/php-upload-progress/<UTC timestamp>-<PID>/
يتم نسخ احتياطي للملفات الموجودة التي تغيّرت فقط. قد تحتوي النسخ الاحتياطية على أسرار من إعداد PHP-FPM ويتم إنشاؤها ضمن دليل أب مقيّد الصلاحيات؛ حافظ عليها خاصة. يتم نسخ كل ملف أصلي احتياطيًا مرة واحدة لكل تشغيل، حتى لو تم تحديثه أكثر من مرة. تستخدم اللقطات الجديدة سجلات مُصدَّرة بإصدارات v2 في state.tsv مع تجزئات SHA-256 للمحتويات الأصلية والمطبَّقة، إضافةً إلى جهاز/inode الهدف المطبَّق، وUID/GID، والوضع، والحجم، ووقت التعديل، ووقت التغيير. يُستثنى وقت الوصول حتى لا يؤدي قراءة هدف إلى إبطال صلاحيته.
للتراجع، استخدم دليل النسخ الاحتياطي الدقيق الذي يطبعه --apply:
sudo bash php-upload-progress-mitigate.sh --rollback=/var/backups/php-upload-progress/TIMESTAMP-PID
sudo bash php-upload-progress-mitigate.sh --rollback=/var/backups/php-upload-progress/TIMESTAMP-PID --apply
الأمر الأول يعرض الخطة فقط. يتحقق التراجع من الخطة الكاملة قبل تغيير الملفات، ويثبّت الأدلة الرئيسية وinodes الملفات ويقفلها، ثم يعيد فحص محتوى الهدف وهويته وبياناته الوصفية فورًا قبل كل استعادة/إزالة. تستخدم عمليات الاستعادة الأدلة المثبّتة، لذا فإن استبدال دليل سلف لا يمكنه إعادة توجيه الكتابة. يرفض الأهداف المعدّلة أو المفقودة، والروابط الرمزية، والمسارات خارج الجذر المحدد، والأقفال المشغولة، واللقطات غير المكتملة. يجب أن تكون الأهداف والنسخ الاحتياطية وأدلتها السلفية مملوكة لـ root ويجب ألا تكون قابلة للكتابة من قبل المجموعة/الآخرين؛ يُسمح بالأدلة اللاصقة المملوكة لـ root مثل /tmp. حلّ التعارضات يدويًا؛ لا يوجد خيار فرض. يُشترط وجود /proc وflock في Linux (util-linux) للتراجع، ويُشترط flock للتطبيق. تُسلسَل كتابات التطبيق/التراجع لنفس الجذر المحدد. الأقفال استشارية: أوقف محرري الإعدادات الخارجيين وإدارة الإعدادات مؤقتًا أثناء التراجع؛ الكاتب غير المتعاون غير مشمول بضمان المقارنة والتبديل الذرية. يحتفظ التراجع بدليل النسخ الاحتياطي، ولا يعيد تشغيل الخدمات، وليس معاملاتيًا: قد يؤدي فشل الإدخال/الإخراج أو تعارض يُكتشف أثناء الاستعادة إلى بقاء أهداف سابقة مستعادة. تحقق من الإعدادات وأعد تحميل العمال المتأثرين بعد ذلك. قد يؤدي التراجع عن الحماية إلى إعادة تفعيل تقدم الرفع. تتطلب اللقطات الأقدم التي تفتقر إلى state.tsv أو التي تحتوي على سجلات حالة تجزئة فقط استعادة يدوية من changes.tsv. استبدال هدف ببايتات متطابقة، أو تغيير مالكه/مجموعته/وضعه، أو تعديله ثم التراجع عنه لا يزال يبطل التراجع التلقائي؛ قد تحتوي أشجار أنظمة الملفات المنسوخة أيضًا على هويات inode مختلفة.