كل المقالات التقنية

رفع حدود الرفع ووقت التنفيذ في PHP على cPanel

استخدم MultiPHP INI Editor لرفع حدود الرفع والذاكرة ووقت التنفيذ بأمان والتأكد من القيم الجديدة.

رفع حدود الرفع ووقت التنفيذ في PHP على cPanel

«The uploaded file exceeds the upload_max_filesize directive» و«Maximum execution time of 30 seconds exceeded» والفشل الصامت عند حفظ قائمة كبيرة ثلاثة وجوه لمشكلة واحدة: تأتي الاستضافة المشتركة بحدود PHP متحفظة. يتيح لك cPanel تغيير كثير منها بنفسك عبر MultiPHP INI Editor، لكن القيم تعتمد على بعضها، وبعض الحدود يقع خارج PHP أصلًا. يشرح هذا الدليل أي الإعدادات مهمة وكيف تغيّرها بأمان وكيف تتأكد من القيم الجديدة وماذا تفحص عندما لا يتغير شيء.

١. الحدود وراء الأخطاء الشائعة

تغطي خمسة إعدادات معظم الحالات. upload_max_filesize هو أكبر ملف منفرد يقبله PHP. وpost_max_size أكبر جسم كلي للطلب، فيجب أن يساوي حد الرفع على الأقل. ويحدد memory_limit ما يستهلكه طلب واحد. ويوقف max_execution_time سكربتًا يطول، ويقيّد max_input_time مدة قراءة الطلب. وهناك سادس هو max_input_vars الذي يحدد عدد حقول النموذج التي يقبلها PHP، ويفسر لماذا تحفظ القوائم أو صفحات الإعدادات جزءًا فقط من بياناتها.

٢. اطّلع على القيم الحالية أولًا

في ووردبريس تعرض شاشة رفع الوسائط الحد الأقصى للرفع، وتسرد Site Health تحت Info وServer عدة حدود. ومع WP-CLI يمكنك قراءة القيم التي يستخدمها PHP في سياق ووردبريس:

wp eval 'echo ini_get("upload_max_filesize"), " | ", ini_get("post_max_size"), " | ", ini_get("memory_limit"), " | ", ini_get("max_execution_time"), PHP_EOL;'

تذكّر أن سطر الأوامر قد يقرأ إعدادًا مختلفًا عن خادم الويب، فاعتبر شاشات الموقع الكلمة الأخيرة فيما تحصل عليه طلبات الزوار.

٣. افهم العلاقة بين القيم

حافظ على ترتيب معقول: memory_limit أكبر من post_max_size، وpost_max_size لا يقل عن upload_max_filesize. إذا رفعت حد الرفع وحده إلى 64M وبقي post_max_size على 8M فسيظل الرفع يفشل وقد يبدو الخطأ كطلب فارغ. ارفعها معًا وأضف هامشًا لأن النموذج يحمل أكثر من الملف نفسه.

٤. استخدم MultiPHP INI Editor

افتح MultiPHP INI Editor في cPanel. يعرض Basic Mode التعليمات الشائعة بحقول قابلة للتعديل، ويتيح Editor Mode تحرير نص الإعداد لموقع محدد. اختر النطاق أو الدليل الرئيسي واضبط القيم واحفظ. يكتب المحرر الإعداد في ملف يقرؤه معالج PHP فلا تحتاج لمس إعدادات الخادم. وهذه قيم نموذجية لموقع محتوى:

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 120
max_input_time = 120
max_input_vars = 3000

هذه الأرقام مثال. اختر ما يحتاجه محتواك فعلًا وأبقِها معتدلة، لأن الحد الضخم يسمح لطلب واحد بالاستحواذ على الموارد.

٥. ملف .user.ini والتأخير

تخزّن استضافات كثيرة إعدادات PHP لكل دليل في ملف باسم .user.ini في مجلد الموقع. يعيد PHP قراءة هذا الملف بشكل دوري فقط، افتراضيًا كل بضع دقائق، لذلك قد لا يظهر التغيير فورًا. إذا لم تر القيم الجديدة مباشرة فانتظر قليلًا قبل أن تستنتج فشل التعديل. يمكنك فحص الملف من File Manager أو عبر SSH:

ls -la ~/public_html/.user.ini
cat ~/public_html/.user.ini

وإن استخدمت استضافتك آلية أخرى فاتبع المحرر لأنه يعرف أي ملف يقرؤه المعالج.

٦. لماذا قد يكسر php_value في .htaccess الموقع

تقول الشروحات القديمة أن تضيف أسطرًا كهذه إلى .htaccess:

php_value upload_max_filesize 64M
php_value post_max_size 64M

لا تعمل هذه إلا عندما يعمل PHP كوحدة Apache. أما مع PHP-FPM أو LSAPI اللذين تستخدمهما خوادم cPanel كثيرة فهذه التعليمات غير مسموحة وقد تسبب الخطأ 500. إذا انكسر الموقع بعد إضافتها مباشرة فأزلها واستخدم INI Editor أو .user.ini بدلًا منها. وللأسباب الأخرى للخطأ 500 راجع حل خطأ 500 الداخلي في ووردبريس: قائمة تشخيص من جهة الخادم.

٧. حدود خارج PHP

لا يفيد رفع حدود PHP إذا رفضت طبقة أخرى الطلب قبلها. قد يكون لخادم الويب أمام PHP حد حجم خاص به مثل client_max_body_size في Nginx. وقد تحجب قاعدة جدار ناري مثل ModSecurity عمليات رفع كبيرة أو غير معتادة، ويقيّد وكيل مثل Cloudflare حجم الطلب بحسب الباقة. إذا رأيت الخطأ 413 بدل رسالة PHP فالحد غالبًا في إحدى هذه الطبقات، ويشرح حل خطأ 413 في Nginx وضبط حد رفع الملفات جانب Nginx:

client_max_body_size 64m;

في الاستضافة المشتركة لا تستطيع غالبًا تغيير خادم الويب بنفسك، فاسأل المزود.

٨. زمن التنفيذ والمهام الطويلة

رفع max_execution_time مسكّن للعمل البطيء. قد يصطدم استيراد كبير أو نسخة احتياطية أو إعادة توليد صور تُنفَّذ عبر الويب بمهلة في خادم الويب أو الوكيل حتى بعد أن يمنح PHP وقتًا أكبر. نفّذ العمل الثقيل حيث لا تنطبق المهل، مثل WP-CLI عبر SSH إذا سمحت باقتك، أو قسّم المهمة إلى دفعات أصغر:

wp db import backup.sql
wp media regenerate --yes

المهام المجدولة التي تطول مصدر آخر للمهل، ويساعد فيها إصلاح WP-Cron وتشغيل مهام ووردبريس المجدولة عبر Cron حقيقي.

٩. عندما يكون max_input_vars هو المشكلة الحقيقية

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

١٠. تأكد من القيم الجديدة

بعد الحفظ أعد فتح صفحة رفع الوسائط أو Site Health وتأكد أن الأرقام تغيرت. إن لم تتغير فابحث عن إعداد أكثر تحديدًا يتجاوز إعدادك، مثل إعداد في مجلد فرعي أو wp-config.php للذاكرة فقط أو حدود على مستوى حساب الاستضافة. بعض المزودين يضعون سقوفًا صارمة لا يمكنك تجاوزها ويجب أن يرفعها فريق الدعم.

١١. روتين اختبار آمن

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

١٢. الأخطاء الشائعة

  • رفع upload_max_filesize دون post_max_size.
  • إضافة أسطر php_value إلى .htaccess على خادم PHP-FPM.
  • توقع ظهور تغيير .user.ini خلال ثوانٍ.
  • ضبط حدود ضخمة تتيح لطلب واحد استنزاف الحساب.
  • تجاهل حدود خادم الويب أو الجدار الناري أو CDN.
  • استخدام مهل أطول بدل تقسيم المهام الثقيلة.

١٣. أخطاء مرتبطة

إذا أظهر الرفع الفاشل «Allowed memory size exhausted» فالحد المطلوب رفعه هو memory_limit لا حجم الرفع. وإذا أعادت الصفحة خطأ قاعدة بيانات بعد حفظ استيراد كبير فافحص جانب قاعدة البيانات كما في حل خطأ Error Establishing a Database Connection في ووردبريس. طابق الرسالة الدقيقة مع الإعداد قبل تغيير أي شيء.

١٤. مثال تطبيقي

لا يستطيع محرر رفع ملف PDF بحجم 30 ميغابايت وتعرض شاشة الوسائط حدًا قدره 2 ميغابايت. في MultiPHP INI Editor يضبط المدير 64M لحجمي الرفع وpost و256M للذاكرة ويحفظ وينتظر بضع دقائق. تعرض شاشة الوسائط الآن 64M. ينجح رفع تجريبي بحجم 30 ميغابايت ويُرفض ملف 70 ميغابايت بالرسالة المتوقعة. هذا توضيح لسير العمل وليس قياسًا من موقع حقيقي.

١٥. أسئلة شائعة

لماذا يبقى حد الرفع القديم؟ لأن حد الرفع يتحكم فيه upload_max_filesize وpost_max_size معًا، والأصغر منهما هو الذي يطبَّق. ارفعهما معًا.

متى تظهر تغييرات .user.ini؟ قد تتأخر عدة دقائق لأن PHP يخزن الملف مؤقتًا، وهذه المدة الافتراضية نحو 300 ثانية. لا يحتاج الأمر عادة إلى إعادة تشغيل.

هل رفع max_execution_time يحل بطء السكربت؟ لا، فهو يمنح السكربت وقتًا أطول فقط. إذا كان السكربت بطيئًا فعلًا فأصلحه أو شغّله في الخلفية.

كيف أتحقق من القيم الفعلية؟ من صفحة Site Health في ووردبريس أو من ملف phpinfo() مؤقت تحذفه فور الانتهاء.

١٦. قائمة تحقق سريعة

  1. اقرأ رسالة الخطأ الدقيقة والحدود الحالية في ووردبريس.
  2. ارفع upload_max_filesize وpost_max_size وmemory_limit معًا.
  3. استخدم MultiPHP INI Editor أو .user.ini لا php_value على PHP-FPM.
  4. انتظر إعادة قراءة الملف وتأكد من الأرقام الجديدة.
  5. افحص حدود خادم الويب والجدار الناري وCDN إن استمرت الأخطاء.
  6. انقل المهام الثقيلة إلى WP-CLI أو دفعات أصغر.

تجد مزيدًا من أدلة الخوادم في أرشيف المقالات.

المراجع الرسمية

cPanel: MultiPHP INI Editor · PHP manual: core php.ini directives · PHP manual: .user.ini files · PHP manual: file upload pitfalls