كتابة صفحة 404 مخصصة في CodeIgniter (دليل شامل لـ CI3 و CI4)

تُعد صفحة الخطأ 404 Not Found من أكثر الصفحات حرجاً في أي تطبيق ويب مبني على إطار العمل CodeIgniter. عندما يحاول الزائر الوصول إلى رابط غير موجود أو مسار تم تغييره، ينبغي أن يرى صفحة 404 مصممة بأسلوب احترافي يوجهه للعودة للرئيسية أو استخدام البحث، بدلاً من رؤية صفحة الخطأ الافتراضية البيضاء أو غير المتناسقة مع هوية المنصة.

في هذا الدليل الشامل والمفصل، سنتعرف على كيفية إنشاء وتخصيص صفحة 404 في CodeIgniter بالتفصيل لكل من الإصدارين الشهيرين: CodeIgniter 3 (CI3) وCodeIgniter 4 (CI4). سنغطي إعدادات التوجيه (Routing)، تخصيص المتحكمات (Controllers)، التعامل مع طلبات AJAX وواجهات API، ترويسات HTTP، وأفضل الممارسات لضمان ألا تؤثر أخطاء 404 سلباً على أداء موقعك أو ترتيبه في محركات البحث (SEO).

لماذا تحتاج إلى تخصيص صفحة 404 في CodeIgniter؟

تكمن أهمية تخصيص صفحة الخطأ في عدة جوانب تقنية وتسويقية لا غنى عنها في المواقع والتطبيقات الاحترافية:

• تحسين تجربة المستخدم (UX): توفر الصفحة المخصصة شريط بحث، روابط لأهم أقسام الموقع، وزر العودة للرئيسية، مما يمنع الزائر من إغلاق الموقع فوراً عند مصادفة رابط مكسور.
• الحفاظ على تهيئة محركات البحث (SEO): تأكيد إرسال ترويسة HTTP 404 Not Found الحقيقية يمنع محركات البحث مثل Google من أرشفة الصفحات المفقودة على أنها صفحات ذوات محتوى مكرر أو ما يُعرف بـ (Soft 404).
• الحفاظ على الهوية البصرية: دمج التصميم العام للموقع (الهيدر، الفوتر، الألوان، والأزرار) يجعل التجربة متكاملة ولا تشعر الزائر بأنه غادر موقعك أو انتقل إلى سيرفر غريب.
• تتبع الأخطاء والروابط المكسورة: يمكنك إضافة كود تسجيل (Logging) داخل صفحة 404 لتتبع الروابط المكسورة والمفقودة وإصلاحها بشكل دوري قبل أن تتسبب في فقدان الزوار.

الخطوة الأولى: تخصيص صفحة 404 في CodeIgniter 3

في إطار العمل CodeIgniter 3، يوفر الإطار آليتين لتعديل صفحة 404: الأولى عن طريق التعديل على العرض الافتراضي (Default View)، والثانية عن طريق استخدام خاصية 404_override في ملف التوجيه.

الطريقة 1: التعديل المباشر على قوالب الخطأ الافتراضية في CI3

يحتوي CodeIgniter 3 على ملف قالب افتراضي لأخطاء 404 يقع في المسار التالي:

application/views/errors/html/error_404.php

يمكنك فتح هذا الملف وتعديل محتوى HTML و CSS مباشرة ليتناسب مع تصميم موقعك. ورغم أن هذه الطريقة سريعة، إلا أنها لا تتيح لك استخدام المتحكمات (Controllers) أو تحميل المكتبات والنماذج (Models) التابعة لـ CodeIgniter بشكل كامل.

الطريقة 2: استخدام 404_override مع Custom Controller في CI3 (الطريقة الاحترافية)

للوصول الكامل لجميع ميزات CodeIgniter داخل صفحة 404، نستخدم خاصية التجاوز في التوجيه. اتبع الخطوات التالية:

• تعديل ملف التوجيه (routes.php): افتح الملف application/config/routes.php وابحث عن السطر:
  $route['404_override'] = '';
  قم بتغييره ليشير إلى متحكم مخصص، مثل:
  $route['404_override'] = 'mycustom404';
• إنشاء المتحكم (Mycustom404.php): أنشئ ملفاً جديداً في المسار application/controllers/Mycustom404.php وضمنه الكود التالي:
  <?php
class Mycustom404 extends CI_Controller {
    public function __construct() {
        parent::__construct();
    }
    public function index() {
        $this->output->set_status_header('404');
        $data['title'] = 'الصفحة غير موجودة - 404';
        log_message('error', '404 Page Not Found: ' . current_url());
        $this->load->view('custom_404_view', $data);
    }
}
• إنشاء العرض (custom_404_view.php): أنشئ ملف العرض في application/views/custom_404_view.php وضع فيه التصميم الخاص بك مع روابط الهيدر والفوتر وزر العودة.

الخطوة الثانية: تخصيص صفحة 404 في CodeIgniter 4

في CodeIgniter 4، تم تحديث البنية المعمارية وتطوير التعامل مع الاستثناءات (Exceptions). هناك طريقتا عمل أساسيتان لتشغيل صفحة 404 مخصصة في CI4.

الطريقة 1: التعديل على عرض الأخطاء في CI4

في CI4، تقع قوالب الأخطاء الخاصة بالإنتاج (Production) في المجلد:

app/Views/errors/html/error_404.php

يمكنك التعديل على هذا الملف مباشرة ليتضمن تنسيقات موقعك، وسيتم استدعاؤه تلقائياً بواسطة معالج الاستثناءات PageNotFoundException عندما يرمي التطبيق خطأ 404 في بيئة الإنتاج (Production Environment).

الطريقة 2: تخصيص المسارات وإرسال الـ Exceptions في CI4

إذا أردت توجيه أخطاء 404 إلى controller مخصص في CodeIgniter 4، يمكنك ضبط ملف المسارات app/Config/Routes.php بوضع الأقسام التالية:

• تحديد override handler: في ملف app/Config/Routes.php، يمكنك تعيين:
  $routes->set404Override('App\Controllers\NotFound::index');
• إنشاء المتحكم في CI4: أنشئ app/Controllers/NotFound.php بكود مرن يرجع الـ View مع status 404:
  <?php
namespace App\Controllers;
use CodeIgniter\Exceptions\PageNotFoundException;
class NotFound extends BaseController {
    public function index() {
        response()->setStatusCode(404);
        log_message('warning', 'CI4 404: ' . current_url());
        return view('errors/custom_404');
    }
}

التعامل مع استجابات JSON وطلبات AJAX لتطبيقات REST API

عند بناء تطبيقات حديثة تعتمد على واجهات البرمجية RESTful API أو طلبات AJAX عبر CodeIgniter، لا ينبغي أن ترجع صفحة 404 ملف HTML كاملاً عندما يفشل طلب API. بدلاً من ذلك، يجب إرجاع استجابة JSON معبرة بحالة 404 HTTP Status Code.

كيفية إرجاع JSON 404 في CodeIgniter 3

داخل المتحكم المخصص Mycustom404.php، يمكنك الفحص إذا ما كان الطلب من نوع AJAX أو API:

if ($this->input->is_ajax_request() || strpos($this->uri->uri_string(), 'api/') === 0) {
    $this->output
        ->set_status_header(404)
        ->set_content_type('application/json', 'utf-8')
        ->set_output(json_encode([
            'status' => false,
            'error' => 404,
            'message' => 'Requested API endpoint not found'
        ]));
    return;
}

كيفية إرجاع JSON 404 في CodeIgniter 4

في CodeIgniter 4، يمكنك الاستفادة من ميزة Content Negotiation أو فحص الـ Header داخل متحكم NotFound.php:

$request = service('request');
if ($request->isAJAX() || $request->header('Accept')?->getValue() === 'application/json') {
    return response()->setStatusCode(404)->setJSON([
        'success' => false,
        'code' => 404,
        'message' => 'Resource not found'
    ]);
}

معالجة كود HTTP Status 404 وحماية الـ SEO

من الأخطاء الفادحة التي يقع فيها بعض المطورين هو إرجاع صفحة تصميمها 404 ولكن بكود استجابة HTTP 200 OK. هذا يعطي إشارة محركات البحث بأن الصفحة موجودة وبها محتوى سليم، وهو ما يسبب مشاكل أرشفة حادة وتراجعاً في الترتيب بما يُعرف بـ (Soft 404).

تأكد دائماً من تنشيط كود الحالة 404 عبر:

• في CodeIgniter 3: $this->output->set_status_header('404');
• في CodeIgniter 4: response()->setStatusCode(404); أو استدعاء throw \CodeIgniter\Exceptions\PageNotFoundException::forPageNotFound();

إعدادات خادم الاستضافة (Nginx & Apache) وأثرها على 404

لضمان أن طلبات العناوين المفقودة تعبر دائماً عبر تطبيق CodeIgniter بدلاً من أن يعرض الخادم صفحة 404 الافتراضية الخاصة بـ Apache أو Nginx، يجب تأكيد إعدادات إعادة التوجيه (URL Rewriting):

• ملف .htaccess لخادم Apache: تأكد من وجود ملف .htaccess في الجذر يوجه جميع الطلبات غير الموجودة لـ index.php:
  RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]
• إعدادات Nginx Server Block: في خادم Nginx، استخدم التوجيه الذكي:
  location / {
    try_files $uri $uri/ /index.php?$query_string;
}

تسجيل أخطاء 404 وتنبيهات المسؤول تلقائياً

أحد الفوائد الكبرى لاستخدام Custom Controller لمعالجة 404 هو القدرة على تسجيل (Logging) الروابط المكسورة أو إرسال إشعارات عندما يتجاوز عدد طلبات 404 حداً معيناً. يمكنك كتابة سجل في قاعدة البيانات أو استدعاء سجلات النظام لمعرفة المصادر التي ترسل الزوار إلى مسارات مفقودة، مما يساعدك على إضافة عمليات إعادة توجيه 301 Redirect لحماية حركة المرور.

تأثير سرعة الخادم واستضافة VavaHost على استجابة 404

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

إذا كنت ترغب في تحسين حلول وأداء أطر العمل والتطبيقات لديك، نقترح مراجعة دليل حل مشكلة ERR_CACHE_MISS للاستفادة من تقنيات التخزين المؤقت وحل مشكلات الاتصال بالشبكة.

أفضل الممارسات لتصميم صفحة 404 جذابة

لتحويل صفحة 404 من نقطة خروج للزائر إلى فرصة تفاعل جديدة، اتبع التوصيات التالية عند تصميم الصفحة:

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

الخلاصة

إن تخصيص صفحة 404 في CodeIgniter ليس مجرد خطوة تجميلية، بل هو جزء أساسي من معايير تطوير الويب الاحترافي والحفاظ على الـ SEO وتحسين تجربة المستخدم. بسطور قليلة من الكود في CodeIgniter 3 أو 4، يمكنك بناء معالج أخطاء متكامل يعزز ثقة الزائرين بموقعك ويحافظ على أداء منصتك وقوة حضورها الرقمي.