مشكلة البحث في WHMCS لا يُظهر النتائج عند اختلاف الحروف كبيرة وصغيرة Case Sensitive
مشكلة البحث في WHMCS لا يُظهر النتائج عند اختلاف الحروف الكبيرة والصغيرة (Case Sensitive Search)
🧩 وصف المشكلة
في بعض إصدارات WHMCS مثل (8.2.1 وما بعدها)،
ممكن تواجه مشكلة أثناء البحث عن العملاء داخل صفحة View/Search Clients،
حيث لا تظهر أي نتائج إذا اختلفت طريقة كتابة الحروف بين الاسم المسجّل واسم البحث.مثال:
بمعنى أن نظام البحث أصبح حساسًا للحروف الكبيرة والصغيرة (Case-Sensitive)، وهي مشكلة ناتجة من إعدادات قاعدة البيانات نفسها وليس من سكربت WHMCS.
السبب الفني للمشكلة
عند فحص قاعدة البيانات في phpMyAdmin،
نجد أن جدول العملاء tblclients يحتوي على أعمدة مثل:
firstname
lastname
companyname
email
تم ضبطها على Collation = utf8mb3_bin أو utf8mb4_bin.
وهذا النوع يجعل المقارنة حساسة للحروف الكبيرة والصغيرة، بمعنى أن:
لذلك عند البحث، إذا كانت قاعدة البيانات تستخدم collation من نوع _bin،
فسيعتبر الحروف الكبيرة والصغيرة مختلفة ولن يعرض نتائج متطابقة.
الحل النهائي (المجرب والآمن)
لحل المشكلة نهائيًا وجعل البحث غير حساس للحروف (Case-Insensitive):
افتح phpMyAdmin
وادخل إلى قاعدة بيانات WHMCS الخاصة بك
نفّذ الكود التالي في تبويب SQL:
كود:
ALTER TABLE tblclients
MODIFY firstname TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL,
MODIFY lastname TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL,
MODIFY companyname TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL,
MODIFY email TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL;
💡 ملاحظة:
إذا كان السيرفر لا يدعم utf8mb4، استخدم بدلها utf8_general_ci. جرّب البحث مجددًا
الآن كتابة الاسم بأي شكل (كابيتال أو سمول) ستُظهر نفس النتيجة تمامًا.
ملاحظات مهمة
الحل آمن تمامًا ولا يؤثر على البيانات أو الفواتير.
لا تحتاج لتعديل أي ملفات مشفرة أو التعامل مع ionCube.
يمكنك تنفيذ نفس الطريقة على أي جدول آخر فيه نفس المشكلة.
يُفضل دائمًا أخذ نسخة احتياطية قبل التنفيذ.
🧠 التوضيح التقني السريع
| Collation |
الشرح |
| utf8mb3_bin |
مقارنة حرفية للبايتات (Case Sensitive) |
| utf8mb4_general_ci |
مقارنة لغوية غير حساسة للحروف (Case Insensitive) |
📘 الرمز ci يعني Case Insensitive
بينما bin يعني Binary أي حساس للحروف.
🏁 النتيجة
البحث في صفحة العملاء أصبح أكثر ذكاءً ومرونة.
لم يعد هناك فرق بين كتابة الاسم بحروف صغيرة أو كبيرة.
النظام يعمل بثبات تام دون أي تأثير سلبي على الأداء.
كتبه فريق الدعم الفني – Rise Company
مشكلة البحث في WHMCS, WHMCS search not working, حل مشكلة البحث في العملاء WHMCS, WHMCS clients search issue, WHMCS case sensitive search problem, WHMCS client search fix, WHMCS لا يظهر نتائج البحث, مشكلة البحث في View/Search Clients WHMCS, البحث لا يعمل في WHMCS, WHMCS لا يعرض العملاء, تعديل قاعدة بيانات WHMCS, case sensitive mysql whmcs, utf8mb3_bin vs utf8mb4_general_ci, حل مشكلة حساسية الحروف WHMCS, جعل البحث غير حساس للحروف WHMCS, WHMCS database collation fix, mysql collation case insensitive whmcs, كيفية حل مشكلة البحث عن العملاء في WHMCS, البحث لا يظهر النتائج في لوحة WHMCS, WHMCS لا يجد العميل عند كتابة الاسم بحروف صغيرة, WHMCS لا يظهر نتائج عند اختلاف الحروف الكبيرة والصغيرة, طريقة جعل البحث في WHMCS غير حساس للحروف