مقدمة

APCu (APC User Cache) هو امتداد PHP (PECL) يوفر ذاكرة تخزين مؤقت في الذاكرة لتخزين بيانات التطبيق — متغيرات أو مصفوفات أو كائنات — بين الطلبات. يسرّع الوصول إلى نتائج مكلفة من حيث إعادة الحساب. APCu يكمل OPcache (ذاكرة التخزين المؤقت للأوبكود)؛ لكنه لا يحل محله.

المتطلبات

  • الوصول إلى cPanel (حساب مستخدم) أو صلاحية root على WHM إذا كنت تدير الخادم.
  • بالنسبة للطريقة بدون صلاحيات root: يجب أن تتضمن لوحة التحكم Select PHP Version (PHP Selector / CloudLinux). إذا لم يتوفر هذا المكوّن، فيجب على المسؤول تثبيت الامتداد عبر WHM / EasyApache 4.
  • تحقق من توافق الامتداد مع إصدار PHP المستخدم في موقعك (APCu متوفر لإصدارات PHP الأحدث؛ تأكد من الإصدار المناسب في الدليل الرسمي).
  • APCu هو كاش محلي لنسخة PHP / SAPI: في بيئة متعددة العقد، فضّل استخدام كاش شبكة (Redis/Memcached) إذا كنت بحاجة إلى كاش مشترك.

تفعيل APCu من خلال cPanel (حساب مستخدم)

تنطبق هذه الطريقة إذا كان مزود الاستضافة قد فعّل PHP Selector (Select PHP Version).

  1. سجّل الدخول إلى cPanel. (إذا لزم الأمر، راجع دليلنا للوصول إلى cPanel.)
  2. افتح Software → Select PHP Version.
    الوصول إلى PHP Selector من لوحة تحكم cPanel

    افتح Select PHP Version من لوحة تحكم cPanel.

  3. تحقق أو اختر إصدار PHP المستخدم على نطاقك وقم بتأكيد التغيير إذا لزم الأمر.
  4. في قائمة الامتدادات، ضع علامة بجانب apcu ثم احفظ (Save / Apply).
    إصدار PHP والامتدادات المتاحة في PHP Selector على cPanel — اختيار امتدادات PHP

    تفعيل الامتداد apcu من خلال PHP Selector.

  5. اختبر الموقع كما موضح في قسم «التحقق» أدناه.

ملاحظة: إذا لم يظهر الخيار apcu فإن الامتداد غير مثبت على الخادم؛ اتصل بالدعم أو بالمسؤول لطلب تثبيته.

تثبيت APCu (للمسؤول / WHM — EasyApache 4)

إذا كان لديك صلاحيات root في WHM، فقم بتثبيت الامتداد للإصدار/الإصدارات المعنية من PHP عبر EasyApache 4 أو عبر مدير حزم التوزيعة.

  1. سجّل الدخول إلى WHM كمستخدم root.
  2. انتقل إلى Home → Software → EasyApache 4 → Customize → PHP Extensions وابحث عن «apcu». حدّد الامتداد لإصدار PHP المستهدف وطبّق التعديلات. (دليل cPanel — تثبيت إصدار أو امتداد PHP.)
  3. كبديل، ثبّت الحزمة الملائمة عبر yum/apt مع الالتزام باتفاقية تسمية حزم EasyApache (حزم مسماة حسب الإصدار EA‑PHP). إذا لم تكن متأكداً من اسم الحزمة، اطلب المشورة من فريق النظام.
  4. بعد التثبيت، يجب أن يكون الامتداد قابلاً للاختيار من PHP Selector (إذا وُجد) وأن يكون مرئياً عبر phpinfo() للنطاق.

التحقق والتكوين بعد التفعيل

فحوصات سريعة

  • phpinfo : أنشئ phpinfo.php يحتوي على <?php phpinfo();، افتحه في متصفح وابحث عن «apcu» للتحقق من التثبيت والإصدار.
  • نموذج اختبار بسيط: 
    <?php
if (extension_loaded('apcu')) {
    echo 'APCu chargé — version : '.phpversion('apcu');
} else {
    echo 'APCu non chargé';
}

تعديل توجيهات APCu

لتعديل الخيارات (حجم الذاكرة المشتركة، التفعيل في CLI...)، استخدم Software → MultiPHP INI Editor في cPanel لإصدار PHP/النطاق المعني، أو عدّل php.ini المركزي إذا كان لديك صلاحيات المسؤول.

الوصول إلى MultiPHP INI Editor من لوحة تحكم cPanel

افتح MultiPHP INI Editor لتعديل توجيهات PHP (مثلاً apc.*).

الإعدادات الشائعة التي يجب التحقق منها (الأسماء الدقيقة موثقة على php.net) :

  • apc.shm_size — حجم الذاكرة المشتركة (اضبطه حسب الحمل، مثال: 32M → 128M حسب الحاجة).
  • apc.enable_cli — تفعيل APCu للبرامج النصية في سطر الأوامر (مفيد للمهام المجدولة cron التي تتطلب APCu).

القيود وأفضل الممارسات

  • يقوم APCu بتخزين البيانات في ذاكرة محلية مرتبطة بعملية PHP/SAPI: لا يصلح للاستخدام كذاكرة مؤقتة مشتركة بين عدة خوادم. لاستخدام ذاكرة مؤقتة موزّعة، استخدم Redis أو Memcached.
  • APCu يكمل OPcache: احتفظ بـ OPcache لكاش الأوبكود واستخدم APCu للتخزين المؤقت على مستوى التطبيق.
  • تجنّب تخزين كائنات كبيرة جدًا إذا كانت الذاكرة المشتركة محدودة؛ راقب الإدخالات المرفوضة وقم بتعديل apc.shm_size.
  • في البيئات المُدارة (CloudLinux وCageFS والحاويات)، قد يختلف السلوك باختلاف إعداد SAPI — راجع مسؤول الخادم.

استكشاف الأخطاء وإصلاحها السريع

  1. خانة الاختيار apcu لا تظهر خانة apcu في Select PHP Version — الامتداد غير مُثبت أو PHP Selector معطّل. اتصل بالدعم واذكر إصدار PHP للنطاق وأرفق لقطة شاشة.
  2. APCu مفعل لكن التطبيق يُبلغ أنه غير موجود: تحقق من أنك تختبر نفس إصدار PHP الذي يُشغّل الموقع (PHP‑FPM مقابل CLI). إذا لزم الأمر، فعّل apc.enable_cli apc.enable_cli لِلبرامج النصية في سطر الأوامر (CLI)، ثم أعد تشغيل خدمة PHP‑FPM على الخادم.
  3. التخزين المؤقت مشبع/إدخالات مرفوضة: قم بزيادة قيمة apc.shm_size apc.shm_size تدريجيًا وراقب تأثير ذلك على الذاكرة.
  4. إذا كنت على استضافة مشتركة ولا يمكنك التثبيت: افتح تذكرة دعم مبينًا النطاق، إصدار PHP والسبب (مثلاً: تسريع WordPress / الإضافة plugin X التي تتطلب APCu).

روابط داخلية مفيدة

هل تحتاج مساعدة؟

افتح تذكرة مبينًا: النطاق، إصدار PHP المستخدم، لقطة شاشة لـ Select PHP Version (إن كانت مرئية) والامتداد/الإضافة التي تتطلب APCu. يمكن للفريق: تفعيل الامتداد إذا كان متاحًا، تثبيته عبر EasyApache 4 أو اقتراح بديل (Redis/Memcached) إذا لم يكن APCu مناسبًا.

المصادر والمراجع

وثائق مرجعية

  • كيفية تحديد وتثبيت إصدار PHP أو امتداد — وثائق cPanel
  • APCu — الدليل — PHP.net
  • كيفية استخدام Alt‑PHP لموقع — دعم cPanel

تم الاطلاع على الوثائق في 17 أكتوبر 2026. قد تختلف الأدوات حسب مزود الاستضافة.