🧩 تعاریف کلیدی مقاله

• Opcache: یکی از افزونه‌های رسمی PHP که کدهای کامپایل‌شده PHP را در حافظه ذخیره می‌کند تا سرعت اجرا افزایش یابد.
• opcache.ini: فایل تنظیمات افزونه Opcache در Alt-PHP یا PHP اصلی سرور.
• opcache.optimization_level: پارامتری که تعیین می‌کند Opcache هنگام پردازش، چه سطحی از بهینه‌سازی را روی کد PHP اعمال کند.
• 503 Error: خطای Service Unavailable که نشان‌دهنده اجرای نادرست PHP یا کرش کردن پردازشگر PHP است.

📝 مقدمه

افزونه Opcache معمولاً برای افزایش سرعت و عملکرد وب‌سایت‌ استفاده می‌شود. اما در برخی سرورها یا نسخه‌های خاص PHP، فعال بودن Opcache ممکن است باعث بروز خطای 503 یا نمایش صفحه سفید شود.
این مقاله توضیح می‌دهد در چنین شرایطی چه کاری باید انجام دهید و چگونه مشکل را رفع کنید.

❗ مشکل (Issue)

وقتی افزونه Opcache فعال است:

• سایت خطای 503 نمایش می‌دهد
• یا یک صفحه سفید (Blank page) بدون هیچ خروجی دیده می‌شود

🌐 محیط (Environment)

• CloudLinux OS 6(h) / 7(h) / 8
• کنترل‌پنل: cPanel / Plesk / DirectAdmin
• بدون کنترل‌پنل نیز شامل می‌شود

🛠️ راه‌حل (Solution)

در برخی موارد نادر، مشکل از بهینه‌ساز داخلی Opcache است که باعث کرش کردن PHP می‌شود.

✔️ برای رفع مشکل، مقدار زیر را در فایل opcache.ini اضافه کنید:

opcache.optimization_level=0

🔍 نتیجه اعمال این تنظیم:

• Opcache همچنان فعال می‌ماند
• اما هیچ نوع Optimization انجام نمی‌شود
• و از Crash شدن PHP جلوگیری می‌کند

به این صورت، محتوای PHP فقط کش می‌شود ولی بهینه‌سازی‌های مشکل‌ساز غیرفعال می‌شوند.

کیان پور