Lorixen.
AR

بعد ترقية PHP تعطلت النصوص العربية: mbstring وintl

باختصار: إذا ظهرت بعد ترقية PHP على خادمك رسالة مثل «Call to undefined function mb_strlen()» أو «Class "NumberFormatter" not found»، أو صارت مقتطفات النصوص العربية تنتهي برموز مكسورة، فالسبب غالباً أن الإضافتين mbstring أو intl غير مفعلتين في نسخة PHP الجديدة. يوضح دليل PHP أن mbstring ليست إضافة افتراضية ويجب تفعيلها صراحة. الحل: قارن الإضافات قبل الترقية وبعدها، فعّل الناقص للنسخة التي يستخدمها الموقع فعلاً، أعد تشغيل خدمة PHP، ثم اختبر الصفحات العربية.

كيف تظهر المشكلة

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

  • صفحة بيضاء أو خطأ قاتل في صفحة معينة يذكر دالة تبدأ بـ mb_ مثل mb_strlen أو mb_substr.
  • خطأ يقول إن صنفاً مثل NumberFormatter أو IntlDateFormatter أو Collator غير موجود.
  • مقتطفات المنتجات أو الأخبار العربية تنتهي بعلامة استفهام داخل معين أو رمز غريب.
  • البحث أو ترتيب الأسماء العربية يعمل بشكل مختلف عما كان.

العامل المشترك أن هذه الأجزاء تعتمد على إضافتين تتعاملان مع النصوص متعددة البايتات واللغات: mbstring وintl.

لماذا تتأثر النصوص العربية تحديداً

الحروف العربية في ترميز UTF-8 تأخذ أكثر من بايت واحد لكل حرف، بينما الحروف الإنجليزية الأساسية تأخذ بايتاً واحداً. الدالة substr في PHP تعيد جزءاً من النص حسب الموضع والطول، وتعمل على البايتات. أما mb_substr فيصفها دليل PHP بأنها تنفذ عملية substr آمنة لمتعدد البايتات بناءً على عدد الحروف.

النتيجة: عندما يقص الكود أول 100 بايت من وصف عربي، قد يقع القص في منتصف حرف، فيظهر الرمز المكسور في آخر المقتطف. وكثير من البرامج تكتب الكود بطريقة «إذا كانت mbstring موجودة استخدمها، وإلا استخدم substr». هذا يمنع الخطأ القاتل، لكنه ينقل المشكلة بصمت إلى النصوص العربية. لذلك قد لا يرى مطور يختبر بالإنجليزية أي خلل، بينما يرى الزبون العربي النص مكسوراً.

ما يقوله دليل PHP عن الإضافتين

بحسب صفحة التثبيت في دليل PHP، mbstring إضافة غير افتراضية، أي غير مفعلة تلقائياً، ويجب تفعيلها صراحة بخيار ‎--enable-mbstring‎ عند بناء PHP، وهذا الخيار مطلوب لاستخدام دوال mbstring. وأما intl فيذكر الدليل أن ‎--enable-intl‎ يفعلها عند بناء PHP، وأنها تعتمد على مكتبة ICU.

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

وظيفة intl أوسع من القص. يشرح دليل PHP في صفحة NumberFormatter أن البرامج تخزن الأرقام بتمثيل مستقل عن اللغة، ثم تحولها عند العرض إلى نص حسب الإعدادات المحلية. ونفس الفكرة تنطبق على التواريخ وترتيب النصوص. الأنظمة التي تعرض التواريخ أو الأرقام أو ترتيب الأسماء حسب اللغة العربية تعتمد عليها.

خطوات الفحص

  1. اعرف نسخة PHP التي يستخدمها الموقع فعلاً. خادم الويب قد يستخدم خدمة PHP مختلفة عن الأمر php في الطرفية. اعرض صفحة phpinfo مؤقتة على الموقع، أو افحص إعدادات خادم الويب، ثم احذف تلك الصفحة فوراً بعد الفحص.
  2. اعرض الإضافات المحملة. يذكر دليل PHP أن الأمر ‎php -m‎ يعرض الإضافات المتاحة في نسخة سطر الأوامر، وأن الدالة extension_loaded تعيد true إذا كانت الإضافة محملة. افحص mbstring وintl بالطريقتين.
  3. قارن مع الخادم أو النسخة القديمة. إذا كانت النسخة القديمة ما زالت مثبتة، اعرض إضافاتها، واكتب كل ما هو ناقص في الجديدة، وليس فقط الإضافتين.
  4. ثبّت الحزم للنسخة الصحيحة. ثبّت حزمة الإضافة المطابقة لرقم نسخة PHP الجديدة تحديداً.
  5. أعد تشغيل خدمة PHP. خدمة PHP التي تخدم الموقع لا تقرأ الإضافات الجديدة حتى تُعاد تشغيلها.
  6. اختبر بالعربي. افتح صفحة فيها مقتطف عربي طويل، وصفحة فيها تاريخ معروض بالعربية، وجرب البحث باسم عربي.

إضافات أخرى قد تختفي معهما

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

قبل الترقية القادمة

أسهل وقت لحل المشكلة هو قبل حدوثها:

  • احفظ قائمة الإضافات المحملة من النسخة الحالية قبل أي ترقية.
  • إذا كان مشروعك يستخدم Composer، أضف المتطلبات ext-mbstring وext-intl إلى ملف المشروع، فتظهر الإضافة الناقصة عند التثبيت بدل أن تظهر للزبون.
  • جرب الترقية أولاً على نسخة تجريبية من الموقع، وافتح فيها صفحات عربية حقيقية، لا صفحات الاختبار الإنجليزية فقط.
  • ابحث في الكود عن substr وstrlen على حقول يكتبها مستخدمون عرب، واستبدلها بنظيراتها من mbstring.

لا تكتفِ بإخفاء الخطأ

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

مثال توضيحي: نظام حجوزات بعد الترقية

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

أسئلة شائعة

شو معنى خطأ Call to undefined function mb_strlen؟

يعني أن إضافة mbstring غير محملة في نسخة PHP التي تشغّل الموقع، والكود يحتاجها.

ليش النص العربي بينقص وبطلع في آخره رمز غريب؟

لأن الكود يقص النص بالبايتات، والحرف العربي أكثر من بايت. الحل استخدام mb_substr وتفعيل mbstring.

php -m بيظهر الإضافة والموقع ما زال فيه الخطأ، ليش؟

لأن الموقع قد يستخدم نسخة أو خدمة PHP مختلفة عن سطر الأوامر. افحص من الموقع نفسه وأعد تشغيل خدمة PHP.

بحتاج intl إذا موقعي بس عربي؟

إذا كان النظام يعرض تواريخ أو أرقاماً أو ترتيباً حسب اللغة فغالباً نعم، لأن هذه الوظائف تعتمد عليها.

إذا كسرت ترقية PHP نصوصك العربية أو أوقفت صفحات في نظامك، أرسل لنا التفاصيل ونراجع الإضافات والكود قبل أن يلاحظ زبائنك.

المصادر

WhatsAppاحجز مكالمة