همه مقالات تخصصی

خطای Maximum execution time exceeded در PHP و تنظیم درست max_execution_time

علت خطای Maximum execution time exceeded، فرق max_execution_time با timeoutهای وب‌سرور و راه‌های درست‌تر از بالا بردن بی‌حد عدد.

خطای Maximum execution time exceeded در PHP و تنظیم درست max_execution_time

پیام Maximum execution time of 30 seconds exceeded یعنی یک اسکریپت PHP بیش از زمان مجاز اجرا شده است. این اتفاق معمولاً هنگام آپدیت بزرگ، وارد کردن داده یا بکاپ‌گیری از داخل وردپرس دیده می‌شود.

۱. مقدار فعلی را بخوانید

مقدار مؤثر را در همان محیطی که سایت اجرا می‌شود بررسی کنید. مقدار صفر یعنی بدون محدودیت و معمولاً فقط در CLI است:

php -i | grep max_execution_time

۲. فقط یک عدد نیست

حتی با افزایش max_execution_time، ممکن است وب‌سرور یا پروکسی زودتر قطع کند؛ مثلاً timeout در Nginx، Apache یا request_terminate_timeout در PHP-FPM. در این حالت به‌جای خطای PHP، 502 یا 504 می‌بینید.

۳. راه‌حل‌های بهتر

برای کارهای سنگین، اجرا با WP-CLI یا کران از خط فرمان به محدودیت وب وابسته نیست. اگر علت یک افزونه یا کوئری کند است، رفع همان از افزایش عدد مؤثرتر است.

wp plugin update --all

۴. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید (مثال توضیحی) آپدیت یک افزونه بعد از ۳۰ ثانیه قطع می‌شود و با ۱۲۰ ثانیه کامل می‌شود. اگر ایمپورت هنوز قطع شود، احتمالاً timeout سرور یا کندی دیتابیس مقصر است.

۵. اشتباه‌های رایج

  • بالا بردن عدد تا ساعت‌ها بدون یافتن علت.
  • فراموش کردن timeoutهای وب‌سرور و PHP-FPM.
  • اجرای کارهای سنگین در ساعت پرترافیک از راه وب.

۶. پرسش‌های متداول

چه عددی مناسب است؟ برای کارهای معمول ۳۰ تا ۶۰ ثانیه کافی است؛ برای کارهای سنگین از خط فرمان اجرا کنید.

چرا با افزایش عدد 504 می‌گیرم؟ وب‌سرور یا پروکسی پیش از PHP اتصال را قطع می‌کند.

۷. چک‌لیست سریع

  1. مقدار فعلی را از محیط وب بخوانید.
  2. علت کندی را شناسایی کنید.
  3. timeoutهای وب‌سرور را بررسی کنید.
  4. کار سنگین را با WP-CLI اجرا کنید.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

PHP max_execution_time · PHP-FPM configuration