الاستيراد يتوقف في منتصفه: Maximum execution time exceeded
باختصار: إذا كنت تستورد قائمة منتجات من المورّد إلى متجرك، أو تصدّر الطلبات، أو تعيد توليد صور المنتجات، وتتوقف العملية في منتصفها برسالة «Maximum execution time of 30 seconds exceeded» أو بصفحة بيضاء، فالسبب حد PHP لمدة تشغيل السكربت، وقيمته الافتراضية 30 ثانية حسب دليل PHP. رفع الحد قد ينجح مرة، لكن الحل الدائم أن تقسم العمل إلى دفعات صغيرة يمكن استئنافها، أو أن تشغله من سطر الأوامر أو في الخلفية بدل طلب صفحة واحد طويل.
كيف يبدو العطل
متجر أدوات صحية في عمّان يستلم كل شهر ملف أسعار محدّثاً من المورّد بأكثر من ثلاثة آلاف صنف. يرفعه الموظف إلى أداة الاستيراد في لوحة التحكم، فيعمل شريط التقدم قليلاً ثم يتوقف. عند فتح المتجر يجد أن جزءاً من المنتجات تحدّث وجزءاً لم يتحدث، ولا يعرف أين توقف بالضبط. يحاول مرة أخرى، فتتكرر بعض المنتجات أو تتحدث مرتين.
هذا أخطر من عطل كامل، لأن المتجر يبقى في حالة نصف محدّثة: أسعار جديدة لبعض الأصناف وقديمة لغيرها. والزبون الذي يطلب في هذه الساعات قد يرى سعراً لا يعكس الواقع، فيضطر الموظف للاتصال به وتصحيح الطلب يدوياً.
ما هو حد مدة التشغيل
يشرح دليل PHP أن max_execution_time يحدد أطول مدة بالثواني يُسمح فيها للسكربت بالعمل قبل أن ينهيه المحلل، وأن الهدف منه منع السكربتات المكتوبة بشكل سيئ من استهلاك الخادم. القيمة الافتراضية 30 ثانية. وعند تشغيل PHP من سطر الأوامر تكون القيمة الافتراضية 0، أي بلا حد.
ويذكر الدليل تفصيلاً يفاجئ كثيرين: على الأنظمة غير ويندوز، الوقت الذي يقضيه السكربت في استدعاءات النظام أو عمليات التدفق أو استعلامات قاعدة البيانات لا يُحسب ضمن هذا الحد. أي أن السكربت قد يعمل فعلياً أطول من 30 ثانية من وجهة نظرك، ثم يتوقف عند حد آخر.
الحدود الأخرى التي تقطع العملية
حد PHP ليس الوحيد. خادم الويب أمام PHP له مهلته الخاصة لانتظار الرد، وموازن الأحمال أو خدمة الحماية أمام الموقع لها مهلتها، والمتصفح نفسه قد ينتظر وقتاً محدوداً. إذا رفعت حد PHP إلى خمس دقائق وبقيت مهلة خادم الويب دقيقة، فسترى خطأ مهلة من خادم الويب بدل رسالة PHP. لذلك لا يكفي تغيير قيمة واحدة.
لماذا رفع الحد ليس الحل
الحل السريع الذي يقترحه كثيرون: رفع max_execution_time أو استدعاء set_time_limit بصفر. قد ينجح الاستيراد هذا الشهر، لكن:
- الملف يكبر مع الوقت، فيعود العطل.
- الطلب الطويل يحجز عاملاً من عمال الخادم طوال المدة، فيبطئ الموقع على الزبائن.
- إذا انقطع اتصال الموظف أو أغلق التبويب، قد تتوقف العملية في منتصفها دون أثر واضح.
- لا يوجد مكان واضح للاستئناف.
الحل الأول: دفعات صغيرة
قسّم العمل إلى دفعات، مثل مئة صنف في كل مرة. كل دفعة طلب قصير ينتهي في ثوانٍ. بعد كل دفعة يحفظ النظام آخر صف تمت معالجته، ثم يطلب الدفعة التالية. إذا انقطع شيء، يبدأ من آخر صف محفوظ بدل البداية. كثير من أدوات الاستيراد الجيدة تعمل بهذه الطريقة أصلاً؛ إذا كانت أداتك لا تفعل، فهذا سبب كافٍ لاستبدالها.
الحل الثاني: سطر الأوامر
إذا كان لديك وصول إلى الخادم، فتشغيل الاستيراد من سطر الأوامر يتجاوز مهلات خادم الويب والمتصفح، لأن PHP هناك بلا حد مدة افتراضياً حسب الدليل. لمواقع WordPress توجد أداة سطر أوامر رسمية تشغل كثيراً من العمليات بهذه الطريقة. هذا مناسب للعمليات الكبيرة التي يجريها المطور، لا للموظف اليومي.
الحل الثالث: العمل في الخلفية
الأفضل للموظف أن يرفع الملف ويضغط «ابدأ»، ثم يكمل عمله. النظام يضع المهمة في طابور، وعامل في الخلفية يعالجها على دفعات، والصفحة تعرض التقدم: «تمت معالجة 1200 من 3000». عند الانتهاء يصل إشعار بالنتيجة وبالصفوف التي فشلت ولماذا. منصات المتاجر الشائعة فيها أنظمة مهام خلفية يمكن البناء عليها.
اجعل الاستيراد آمناً للتكرار
مهما كانت الطريقة، اجعل كل صف قابلاً للمعالجة أكثر من مرة دون ضرر. استخدم معرّفاً ثابتاً من المورّد، مثل رمز الصنف، لتحديد المنتج: إذا وُجد يُحدّث، وإذا لم يوجد يُنشأ. بهذا، إذا أُعيدت دفعة بسبب انقطاع، فلن يظهر منتج مكرر. واحفظ تقريراً بالصفوف التي رُفضت مع السبب، كسعر فارغ أو رمز غير معروف، بدل إيقاف العملية كلها عند أول خطأ. الموظف يصحح هذه الصفوف القليلة لاحقاً ويعيد استيرادها وحدها، دون أن يمس آلاف الأصناف السليمة.
خذ نسخة قبل كل استيراد كبير
قبل أي تحديث جماعي للأسعار أو المنتجات، خذ نسخة احتياطية من قاعدة البيانات أو على الأقل من جداول المنتجات. إذا ظهر بعد الاستيراد خطأ في ملف المورّد نفسه، كعمود أسعار مزاح، فالرجوع إلى النسخة أسرع بكثير من التصحيح اليدوي.
راقب العملية بدل أن تخمّن
عندما تتوقف عملية في منتصفها، فأول سؤال: أين توقفت ولماذا؟ اجعل كل دفعة تكتب سطراً في سجل: رقم الدفعة، وأول صف وآخر صف، وعدد ما نجح وما رُفض، ووقت البداية والنهاية. إذا توقفت العملية، يكفي فتح السجل لمعرفة آخر دفعة اكتملت. وسجل أخطاء PHP على الخادم يذكر رسالة تجاوز المدة مع اسم الملف ورقم السطر، فتعرف أي جزء من الكود يستهلك الوقت. أحياناً يكون السبب ليس حجم الملف بل خطوة بطيئة واحدة، كتنزيل صورة كل منتج من موقع المورّد أثناء الاستيراد. فصل هذه الخطوة إلى مهمة خلفية مستقلة قد يجعل الاستيراد نفسه سريعاً بما يكفي دون أي تغيير في الحدود.
مثال توضيحي: متجر أدوات صحية
هذا مثال توضيحي لطريقة المعالجة، دون أرقام حقيقية. المتجر يستبدل أداة الاستيراد بأخرى تعالج مئة صنف في كل دفعة وتحفظ موضعها، ويطابق المنتجات برمز الصنف من المورّد. يجعل الاستيراد يعمل في الخلفية مع صفحة تعرض التقدم وتقريراً بالأخطاء في النهاية. يأخذ نسخة احتياطية تلقائياً قبل كل استيراد. ثم يجرّب الفريق إيقاف العملية عمداً في منتصفها، والتأكد أنها تستأنف دون تكرار، وأن تقرير الأخطاء يذكر كل صف رُفض مع سببه بوضوح.
أسئلة شائعة
شو معنى Maximum execution time exceeded؟
أن سكربت PHP تجاوز المدة المسموح بها للتشغيل، وهي 30 ثانية افتراضياً حسب دليل PHP، فأُوقف.
بزيد الوقت وبخلص؟
قد ينجح مؤقتاً، لكن مهلات خادم الويب والمتصفح تبقى، والملف يكبر. الدفعات الصغيرة أو العمل في الخلفية حل دائم.
ليش بعض المنتجات تحدثت وبعضها لا؟
لأن العملية توقفت في منتصفها. اجعل الاستيراد يحفظ موضعه ويستأنف، ويطابق المنتجات برمز ثابت.
هل التشغيل من سطر الأوامر بحل المشكلة؟
يتجاوز حد المدة الافتراضي لأن قيمته هناك صفر حسب الدليل، لكنه مناسب للمطور أكثر من الموظف اليومي.
إذا كانت عمليات الاستيراد في متجرك تتوقف وتترك البيانات نصف محدّثة، تواصل معنا ونعيد بناءها على دفعات آمنة.