مشکل عدم بروزرسانی وردپرس (چه هسته اصلی وردپرس، افزونه‌ها، قالب یا ترجمه‌ها) یکی از موارد شایع در بین کاربران است. اگر هنگام بروزرسانی با خطا مواجه می‌شوید یا دکمه بروزرسانی کار نمی‌کند، این راهنما به شما کمک می‌کند مشکل را شناسایی و حل کنید.

❓ علائم رایج عدم بروزرسانی وردپرس

• گیر کردن در مرحله “در حال به‌روزرسانی…”

• نمایش ارورهایی مثل:

  • Update failed: Download failed

  • Briefly unavailable for scheduled maintenance

  • ناپدید شدن دکمه بروزرسانی

• عدم بروزرسانی خودکار وردپرس یا افزونه‌ها

• ارورهای دسترسی یا پرمیشن

🛠 راه‌حل‌های قدم‌به‌قدم رفع مشکل عدم بروزرسانی

✅ 1. بررسی دسترسی نوشتن (فایل و پوشه‌ها)

اگر وردپرس اجازه نوشتن روی فایل‌ها را نداشته باشد، آپدیت انجام نمی‌شود.

• بررسی کنید پوشه‌های زیر قابل نوشتن (writable) باشند:

  • wp-content/upgrade/

  • wp-content/plugins/

  • wp-content/themes/

مقادیر پیشنهادی:

• پوشه‌ها: 755

• فایل‌ها: 644

✅ 2. حذف فایل .maintenance (در صورت وجود)

اگر به‌روزرسانی ناتمام مانده باشد، ممکن است سایت در حالت "در دست تعمیر" بماند.

1. از طریق FTP یا File Manager وارد سایت شوید.

2. فایل .maintenance در ریشه سایت (کنار wp-config.php) را پیدا و حذف کنید.

✅ 3. افزایش محدودیت‌های PHP

آپدیت ممکن است به دلیل کم بودن منابع متوقف شود. تنظیمات پیشنهادی:

php
CopyEdit
// در wp-config.php یا php.ini
define( 'WP_MEMORY_LIMIT', '256M' );
set_time_limit(300);

در هاست اشتراکی ممکن است نیاز باشد از پشتیبانی بخواهید این مقادیر را افزایش دهد.

✅ 4. بررسی اتصال سرور به مخزن وردپرس

اگر سایت نتواند به wordpress.org وصل شود، بروزرسانی ناموفق خواهد بود.

• در ابزار سلامت سایت (Site Health) بررسی کنید که آیا مشکلی در REST API یا اتصال HTTP وجود دارد.

• استفاده از فایروال یا افزونه امنیتی مثل Wordfence یا iThemes Security ممکن است این اتصال را مسدود کند.

✅ 5. غیرفعال‌سازی افزونه‌های کش و امنیتی

گاهی افزونه‌های کش، CDN یا امنیتی مانع آپدیت می‌شوند.

• افزونه‌هایی مثل: LiteSpeed Cache, W3 Total Cache, Cloudflare, Wordfence

• همه افزونه‌ها را غیرفعال کرده و مجدد تست کنید.

✅ 6. فعال‌سازی حالت دیباگ برای بررسی خطا

در فایل wp-config.php موارد زیر را فعال کنید:

php
CopyEdit
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

سپس خطاها را در فایل wp-content/debug.log بررسی نمایید.

✅ 7. بروزرسانی دستی وردپرس (در صورت نیاز)

اگر هیچ‌کدام از روش‌ها جواب نداد، می‌توانید هسته وردپرس را دستی بروزرسانی کنید:

1. از wordpress.org آخرین نسخه را دانلود کنید.

2. فقط پوشه‌های wp-includes و wp-admin را از طریق FTP جایگزین کنید.

3. فایل‌های اصلی مانند index.php, wp-login.php را هم جایگزین کنید.

4. پوشه wp-content و فایل wp-config.php را دست نزنید.

5. وارد پیشخوان شوید و اگر صفحه آپدیت دیتابیس آمد، روی "به‌روزرسانی پایگاه‌داده" کلیک کنید.

🧪 نکات تکمیلی

• اگر سایت روی نسخه PHP پایین‌تر از 7.4 است، آن را ارتقا دهید.

• مطمئن شوید که cron داخلی وردپرس فعال است (و در wp-config.php با DISABLE_WP_CRON غیرفعال نشده باشد).

• در هاست، ماژول‌های curl و zip باید فعال باشند.

🧯 افزونه‌های کمکی برای مدیریت به‌روزرسانی

• Easy Updates Manager – برای مدیریت کامل بروزرسانی خودکار

• WP Rollback – بازگردانی نسخه قبلی افزونه یا قالب در صورت ناسازگاری

اگر خواستی می‌تونم یک اسکریپت PHP ساده برات بنویسم برای تست اتصال سرور به مخزن وردپرس یا بررسی پرمیشن پوشه‌ها. کافیه بگی میزبان سایتت چی هست (مثل: DirectAdmin, cPanel یا لوکال هاست)؟ 💻🔍