WordPress Core Update یا بروزرسانی هسته وردپرس یکی از مهم‌ترین اقدامات برای حفظ امنیت، سازگاری و پایداری سایت است.

WordPress به‌صورت دوره‌ای نسخه‌های جدیدی منتشر می‌کند که می‌توانند شامل:

• Security Fix
• Bug Fix
• Performance Improvement
• Compatibility Improvement
• قابلیت‌های جدید

باشند.

برای بروزرسانی هسته WordPress چند روش وجود دارد:

Dashboard Update
Manual Update
WP-CLI
Automatic Update

در این مقاله سه روش اصلی بروزرسانی دستی و نیمه‌خودکار WordPress Core را بررسی می‌کنیم و سپس مشکلات رایج هنگام Update را توضیح می‌دهیم.

بروزرسانی خودکار WordPress به‌صورت جداگانه در مقاله آموزش فعال‌سازی Auto Update بررسی می‌شود.

قبل از آپدیت WordPress چه کارهایی انجام دهیم؟

قبل از بروزرسانی بهتر است از سایت Backup داشته باشید.

حداقل Backup شامل:

WordPress Files
+
Database

باشد.

WordPress نیز در مستندات رسمی توصیه می‌کند قبل از Upgrade از Files و Database نسخه پشتیبان تهیه شود.

ایجاد بکاپ و ریستور دستی وردپرس

نسخه فعلی WordPress را بررسی کنید

از Dashboard وارد:

Dashboard
→ Updates

شوید.

در این قسمت نسخه فعلی WordPress و وجود Update جدید نمایش داده می‌شود. صفحه Dashboard Updates برای بروزرسانی WordPress Core، Pluginها، Themeها و Translationها استفاده می‌شود.

همچنین نسخه WordPress معمولاً در:

Dashboard
→ At a Glance

یا Footer بخش مدیریت قابل مشاهده است.

بررسی سازگاری قبل از Update

قبل از Major Update بهتر است موارد زیر را بررسی کنید:

• PHP Version
• Theme Compatibility
• Plugin Compatibility
• Database Version
• PHP Extensions
• فضای خالی Disk
• Backup سالم

به‌خصوص در سایت‌های قدیمی، بهتر است همراه با WordPress Core چند تغییر بزرگ را همزمان انجام ندهید.

برای مثال انجام همزمان:

WordPress Major Update
+
PHP Major Upgrade
+
Plugin Updates
+
Theme Update

عیب‌یابی را در صورت بروز Error دشوارتر می‌کند.

تفاوت Minor Update و Major Update

نسخه‌ای مانند:

6.8.1

را در نظر بگیرید.

به‌طور کلی Updateهایی مانند:

6.8 → 6.8.1

Minor/Maintenance Update محسوب می‌شوند.

اما تغییراتی مانند:

6.7 → 6.8

نسخه جدید اصلی WordPress محسوب می‌شوند.

WordPress به‌طور پیش‌فرض از WordPress 3.7 به بعد برای بسیاری از Minor و Security Releaseها قابلیت Background Automatic Update دارد.

در مثال‌های مربوط به این مقاله یک آپدیت minor از 7.0 به 7.1 انجام می‌شود.

روش اول: آپدیت WordPress از Dashboard

ساده‌ترین روش برای بیشتر سایت‌ها استفاده از WordPress Dashboard است.

وارد:

Dashboard
→ Updates

شوید.

اگر نسخه جدیدی وجود داشته باشد، قسمتی مشابه:

An updated version of WordPress is available.

نمایش داده می‌شود.

روی:

Update Now

کلیک کنید.

WordPress فایل‌های Core جدید را دریافت کرده و جایگزین می‌کند. WordPress این روش را به‌عنوان One-click Update معرفی می‌کند و برای بیشتر سایت‌ها همین روش کافی است.

پس از به روز رسانی نسخه جدید صفحه‌ای به این صورت نمایش داده‌خواهد شد.

مانند قبل از صفحه اصلی می‌توانید نسخه wordpress خود را مشاهده کنید:

هنگام Update چه اتفاقی می‌افتد؟

در زمان بروزرسانی WordPress ممکن است سایت برای مدت کوتاهی وارد:

Maintenance Mode

شود.

در این مدت کاربران ممکن است پیامی مشابه:

Briefly unavailable for scheduled maintenance.
Check back in a minute.

مشاهده کنند.

پس از پایان موفق Update، Maintenance Mode به‌صورت خودکار غیرفعال می‌شود.

بعد از Update ممکن است Database نیز نیاز به Upgrade داشته باشد

در بعضی نسخه‌ها بعد از بروزرسانی فایل‌های WordPress، ساختار Database نیز نیاز به Update دارد.

در این حالت WordPress صفحه‌ای برای:

Update WordPress Database

نمایش می‌دهد.

روی دکمه مربوطه کلیک کنید.

این عملیات معمولاً سریع انجام می‌شود.

اگر Dashboard اطلاعات FTP درخواست کرد

گاهی هنگام Update، WordPress به‌جای تغییر مستقیم فایل‌ها اطلاعاتی مانند:

FTP Host
FTP Username
FTP Password

درخواست می‌کند.

این رفتار معمولاً به File Ownership یا Permission مربوط است.

WordPress روش دسترسی به Filesystem را بر اساس Ownership فایل‌های نصب‌شده مشخص می‌کند. اگر Process مربوط به Web Server اجازه تغییر مستقیم فایل‌ها را نداشته باشد، ممکن است اطلاعات FTP درخواست شود.

در Hosting Environment بهتر است قبل از تغییر Permissionها، Ownership صحیح فایل‌ها بررسی شود.

از قرار دادن کل سایت روی:

777

برای حل این مشکل خودداری کنید.

روش دوم: آپدیت دستی WordPress از طریق File Manager

اگر Update از Dashboard موفق نیست، می‌توان WordPress Core را به‌صورت دستی بروزرسانی کرد.

این روش برای شرایطی مانند موارد زیر مناسب است:

Dashboard update failed
Filesystem permission problem
WordPress admin inaccessible
Incomplete core update

در مثال این بخش به جای به روز رسانی مجددا ورژن را از 7.1 به 7.0 تبدیل می‌کنیم.

مرحله اول: دریافت آخرین نسخه WordPress

آخرین نسخه WordPress را از سایت رسمی دریافت کنید:

WordPress.org

فایل ZIP را Extract کنید.

داخل آن ساختاری مشابه زیر وجود دارد:

wordpress/
├── wp-admin/
├── wp-content/
├── wp-includes/
├── index.php
├── wp-login.php
├── wp-settings.php
└── ...

مرحله دوم: غیرفعال کردن Pluginها در صورت نیاز

مستندات Update دستی WordPress پیشنهاد می‌کنند قبل از Manual Upgrade، Pluginها غیرفعال شوند.

این کار مخصوصاً در Upgradeهای بزرگ یا سایت‌های قدیمی مفید است.

از:

Plugins
→ Installed Plugins

می‌توانید Pluginها را موقتاً Deactivate کنید.

مرحله سوم: حذف wp-admin و wp-includes قدیمی

در File Manager وارد Document Root سایت شوید.

برای مثال:

public_html

Directoryهای زیر را حذف کنید یا در یک پوشه جدید به نام OLD قرار دهید:

wp-admin
wp-includes

WordPress در مستندات Manual Update نیز توصیه می‌کند نسخه قدیمی این دو Directory حذف و Directoryهای جدید جایگزین شوند.

Directory زیر را حذف نکنید:

wp-content

زیرا Pluginها، Themeها و Uploadهای سایت داخل آن قرار دارند.

مرحله چهارم: Upload فایل‌های Core جدید

از WordPress جدید Directoryهای:

wp-admin
wp-includes

را Upload کنید.

سپس فایل‌های موجود در Root نسخه جدید را نیز روی فایل‌های قدیمی Overwrite کنید.

برای مثال:

index.php
wp-login.php
wp-settings.php
wp-load.php
wp-cron.php

هنگام Manual Update چه فایل‌هایی را نباید حذف کنیم؟

مهم‌ترین موارد:

wp-content/
wp-config.php
.htaccess

هستند.

wp-content شامل اطلاعات اختصاصی سایت است.

wp-config.php نیز تنظیمات Database و Configuration سایت را نگهداری می‌کند.

درباره wp-content جدید چه کنیم؟

داخل Package جدید WordPress یک Directory با نام:

wp-content

وجود دارد.

نباید wp-content فعلی سایت را با حذف کامل جایگزین کنید.

تنها در صورت نیاز فایل‌های موجود در wp-content نسخه جدید را روی Directory موجود Merge/Overwrite کنید.

مستندات رسمی WordPress نیز صراحتاً توصیه می‌کنند wp-content قدیمی حفظ شده و فایل‌های جدید داخل آن روی Directory موجود Copy شوند.

در این ویدئو پس از اینکه وردپرس را به وسیله one click update به ورژن 7.1 آپدیت کرده‌ایم به صورت دستی آن را به ورژن 7.0 باز می‌گردانیم.

مرحله پنجم: باز کردن سایت

پس از جایگزینی فایل‌ها، وارد:

https://example.com/wp-admin/

شوید.

اگر Database نیاز به Update داشته باشد، WordPress این موضوع را اعلام می‌کند.

مراحل را ادامه دهید تا Upgrade تکمیل شود.

همانطور که در عکس مشخص است مجددا نسخه wordpress به 7.0 تغییر پیدا کرد.

اگر سایت روی Maintenance Mode باقی ماند

گاهی Update در میانه عملیات قطع می‌شود و سایت همچنان پیام:

Briefly unavailable for scheduled maintenance.
Check back in a minute.

نمایش می‌دهد.

در Document Root سایت فایل:

.maintenance

را بررسی کنید.

اگر مطمئن هستید Update دیگری در حال اجرا نیست، آن را حذف کنید.

مستندات رسمی WordPress نیز حذف .maintenance را در صورت باقی ماندن سایت در Maintenance Mode بعد از Manual Update ذکر می‌کنند.

اگر فایل مخفی را مشاهده نمی‌کنید، گزینه:

Show Hidden Files

را در File Manager فعال کنید.

روش سوم: آپدیت WordPress با WP-CLI

اگر به SSH دسترسی دارید، یکی از سریع‌ترین روش‌ها استفاده از WP-CLI است.

ابتدا وارد Directory سایت شوید:

cd /path/to/wordpress

نسخه فعلی را بررسی کنید:

wp core version

برای بررسی وجود Update:

wp core check-update

WP-CLI این Command را برای بررسی WordPress Version Check API ارائه می‌کند.

اجرای Core Update

برای بروزرسانی به آخرین نسخه:

wp core update

این Command WordPress را به نسخه جدید بروزرسانی می‌کند.

پس از Update بهتر است Database نیز بررسی شود:

wp core update-db

آپدیت فقط Minor Version

در صورت نیاز:

wp core update --minor

را اجرا کنید.

گزینه:

--minor

باعث می‌شود WP-CLI فقط Updateهای Minor مرتبط را در نظر بگیرد.

آپدیت به نسخه مشخص

برای نصب یک Version مشخص:

wp core update --version=6.x.x

به‌جای:

6.x.x

نسخه موردنظر را وارد کنید.

این قابلیت بیشتر در شرایط Troubleshooting یا Environmentهای کنترل‌شده کاربرد دارد.

بررسی سلامت فایل‌های Core

بعد از Update می‌توان فایل‌های Core را با Checksumهای رسمی WordPress مقایسه کرد:

wp core verify-checksums

این Command برای بررسی Integrity فایل‌های WordPress Core مفید است.

اگر فایل Core به‌صورت ناخواسته تغییر کرده یا فایل آلوده جایگزین یکی از فایل‌های استاندارد شده باشد، این بررسی می‌تواند کمک‌کننده باشد.

قبل و بعد از Update با WP-CLI

یک Workflow مناسب می‌تواند به شکل زیر باشد:

wp core version
wp core check-update
wp core update
wp core update-db
wp core verify-checksums

تفاوت روش‌های Update

برای یک سایت معمولی، روش Dashboard ساده‌ترین انتخاب است.

Automatic Update هسته WordPress

WordPress از مدت‌ها قبل قابلیت Background Update برای Minor و Security Releaseها را دارد. Major Core Auto-update نیز بسته به تنظیمات سایت می‌تواند فعال شود.

از آنجا که این موضوع تنظیمات، مزایا و ریسک‌های خاص خود را دارد، در مقاله زیر جداگانه بررسی می‌شود:

آموزش فعال‌سازی Auto Update

اگر دکمه Update نمایش داده نمی‌شود

اگر نسخه جدید منتشر شده ولی WordPress Update را نمایش نمی‌دهد، ابتدا:

Dashboard
→ Updates

را باز کرده و:

Check again

را انتخاب کنید.

در Hosting Environment همچنین موارد زیر را بررسی کنید:

• دسترسی Server به WordPress.org
• Firewall
• DNS Resolution
• Proxy
• PHP cURL
• SSL/TLS
• Hosting restrictions

اگر Server نتواند به سرویس‌های WordPress.org متصل شود، WordPress ممکن است نتواند Update را Download یا حتی Update Check را کامل کند.

خطای Download failed

ممکن است هنگام Update خطایی مشابه:

Download failed

نمایش داده شود.

موارد مهم برای بررسی:

Outbound Internet Access
DNS
cURL
OpenSSL
CA Certificates
Firewall
Proxy
Disk Space

اگر مشکل از Server Environment باشد، تغییر Permission فایل‌های WordPress کمکی نخواهد کرد.

خطای Could not create directory

اگر با خطایی مشابه:

Could not create directory

مواجه شدید، معمولاً موارد زیر را بررسی کنید:

File Ownership
Permissions
Disk Quota
Available Disk Space
Hosting Account Status

در Shared Hosting ممکن است Account به Disk Quota رسیده باشد و WordPress نتواند فایل‌های جدید را Extract کند.

خطای Installation failed: Could not copy file

این Error نیز معمولاً به یکی از موارد زیر مربوط است:

• Ownership اشتباه
• Permission
• Disk Full
• Quota
• File Lock
• Security Policy

ابتدا File Ownership و فضای Disk را بررسی کنید.

خطای 500 یا Critical Error بعد از Update

اگر بعد از Core Update سایت با:

500 Internal Server Error

یا:

There has been a critical error on this website.

مواجه شد، موارد زیر را بررسی کنید:

1. PHP Error Log
2. PHP Version
3. Plugin Compatibility
4. Theme Compatibility
5. .htaccess
6. Memory Limit
7. فایل‌های ناقص Core

اگر مشکل بعد از Major WordPress Update ایجاد شده باشد، Plugin یا Theme قدیمی یکی از موارد مهم برای بررسی است.

غیرفعال کردن Pluginها در صورت از دست رفتن Dashboard

اگر به /wp-admin/ دسترسی ندارید، می‌توانید از File Manager Directory زیر را موقتاً Rename کنید:

wp-content/plugins

برای مثال:

plugins-disabled

اگر سایت دوباره باز شد، احتمالاً یکی از Pluginها با نسخه جدید WordPress یا PHP سازگار نیست.

پس از بررسی، Directory را به:

plugins

برگردانید.

اگر فایل‌های Core ناقص شده باشند

در صورت Update ناقص می‌توانید WordPress Core را با روش Manual Update دوباره جایگزین کنید.

Directoryهای:

wp-admin
wp-includes

را از Package رسمی WordPress مجدداً Upload کنید و فایل‌های Core Root را نیز Overwrite کنید.

از حذف:

wp-content
wp-config.php

خودداری کنید.

خطای Another update is currently in progress

در WP-CLI ممکن است با:

Error: Another update is currently in progress.

مواجه شوید.

WordPress برای جلوگیری از اجرای همزمان چند Core Update یک Update Lock ایجاد می‌کند.

اگر مطمئن هستید Update دیگری در حال اجرا نیست، WP-CLI مستند می‌کند که می‌توان Lock را حذف کرد:

wp option delete core_updater.lock

این کار را در حالی که Update واقعی در حال اجراست انجام ندهید.

بررسی Hosting Environment

در هاست اشتراکی یا Control Panelهایی مانند cPanel، DirectAdmin یا Plesk ممکن است مشکل Update فقط مربوط به WordPress نباشد.

موارد زیر را نیز بررسی کنید:

Disk Quota
Account Suspension
PHP Version
PHP Limits
File Ownership
ModSecurity / WAF
Outbound Connections
Hosting Security Policy

برای مثال اگر Hosting Account به Quota رسیده باشد، WordPress ممکن است Package Update را Download کند اما هنگام Extract فایل‌ها با Error مواجه شود.

WP Toolkit و Core Update

اگر سایت با WP Toolkit مدیریت می‌شود، ممکن است WordPress Core Update از داخل WP Toolkit نیز قابل اجرا باشد.

WP Toolkit می‌تواند Version و Update Status سایت‌های WordPress را به‌صورت متمرکز مدیریت کند.

اگر سایت تحت مدیریت Hosting Provider است، قبل از Manual Update بررسی کنید آیا Update Policy خاصی در WP Toolkit یا Control Panel اعمال شده است.

برای تنظیمات امنیتی WP Toolkit:

فعال سازی security hardening در WP Toolkit

تغییر مستقیم فایل‌های WordPress Core

فایل‌های Core WordPress نباید برای Customization ویرایش شوند.

دلیل آن این است که هنگام Update فایل‌های Core با نسخه جدید جایگزین می‌شوند و تغییرات دستی ممکن است از بین بروند. WordPress نیز هشدار می‌دهد که Upgrade تمام فایل‌ها و Directoryهای Core را تحت تأثیر قرار می‌دهد.

برای Customization باید از:

Plugins
Child Themes
Hooks

استفاده شود.

بعد از Update چه چیزهایی را تست کنیم؟

بعد از بروزرسانی فقط باز شدن Homepage کافی نیست.

موارد زیر را بررسی کنید:

Homepage

https://example.com

WordPress Dashboard

/wp-admin/

صفحات داخلی

چند Post و Page را باز کنید.

Pluginهای مهم

به‌خصوص:

WooCommerce
Page Builder
Forms
Cache
Security
SMTP

Theme

Layout و Menuها را بررسی کنید.

Login

Logout و Login را تست کنید.

فرم‌ها

Contact Form و سایر فرم‌های مهم را تست کنید.

Cron

در سایت‌هایی که Jobهای زمان‌بندی‌شده مهم دارند، WP-Cron را نیز بررسی کنید.

پاک کردن Cache بعد از Update

بعد از بروزرسانی Core بهتر است Cacheهای مرتبط پاک شوند:

WordPress Cache Plugin
LiteSpeed Cache
Server Cache
Redis/Object Cache
CDN
Browser Cache

گاهی سایت آپدیت شده ولی به دلیل Cache، فایل‌های CSS یا JavaScript قدیمی همچنان نمایش داده می‌شوند.

آیا Pluginها و Themeها را همزمان آپدیت کنیم؟

بهتر است در سایت‌های مهم Updateها کنترل‌شده انجام شوند.

برای مثال:

Backup
   ↓
WordPress Core Update
   ↓
Test
   ↓
Plugin Updates
   ↓
Test
   ↓
Theme Update
   ↓
Final Test

این روش کمک می‌کند اگر مشکلی ایجاد شد، مشخص باشد کدام Update باعث آن شده است.

برای Pluginها و Themeها مقاله جداگانه وجود دارد:

آموزش نصب و آپدیت افزونه‌ها

سایت Production و Staging

اگر سایت حساس یا تجاری است، بهتر است Major Update ابتدا روی Staging آزمایش شود.

Workflow مناسب:

Production
    ↓
Create Staging
    ↓
Core Update
    ↓
Test plugins/theme
    ↓
Fix problems
    ↓
Update Production

مقالات مرتبط:

• ایجاد محیط Staging با WP Toolkit
• انتقال تغییرات Staging به سایت اصلی
• استفاده از Smart Updates در WP Toolkit

اشتباهات رایج هنگام آپدیت WordPress

آپدیت بدون Backup

در صورت بروز Compatibility Problem امکان Rollback سخت‌تر خواهد بود.

تغییر همزمان PHP و WordPress

در صورت بروز Error تشخیص علت مشکل دشوار می‌شود. همیشه در این موقعیت‌ها مرحله به مرحله پیش بروید و از صحت اتمام یک مرحله پیش از شروع مرحله جدید مطمئن شوید.

حذف wp-content در Manual Update

این Directory شامل اطلاعات اختصاصی سایت است.

جایگزین کردن wp-config.php

این فایل شامل اطلاعات Database و Configuration سایت است.

استفاده از Permission برابر 777

مشکل Ownership یا Hosting را با Permission ناامن حل نکنید.

بستن Browser در وسط Update و دستکاری فوری فایل‌ها

ابتدا بررسی کنید Update واقعاً متوقف شده باشد.

حذف .maintenance در حالی که Update هنوز در حال اجراست

ممکن است سایت در وضعیت ناقص در دسترس کاربران قرار گیرد.

فراموش کردن Cache

ممکن است سایت سالم باشد ولی نسخه قدیمی Assetها نمایش داده شود.

Workflow پیشنهادی

برای بیشتر سایت‌ها:

1. Create Backup
        ↓
2. Check PHP / Plugin compatibility
        ↓
3. Check available disk space
        ↓
4. Update WordPress Core
        ↓
5. Run database update if requested
        ↓
6. Clear caches
        ↓
7. Test frontend
        ↓
8. Test wp-admin
        ↓
9. Test important plugins/forms
        ↓
10. Check error logs

دستورات سریع WP-CLI

مطالعه بیشتر

مقالات مرتبط در دانشنامه:

• ایجاد بکاپ و ریستور دستی وردپرس
• آموزش فعال‌سازی Auto Update
• آموزش نصب و آپدیت افزونه‌ها
• ایجاد محیط Staging با WP Toolkit
• استفاده از Smart Updates در WP Toolkit
• فعال‌سازی Security Hardening در WP Toolkit

مستندات رسمی:

• Updating WordPress
• WordPress Dashboard Updates
• WP-CLI Core Update
• WP-CLI Core Commands

جمع‌بندی

برای WordPress Core Update سه روش اصلی در دسترس است:

Dashboard
Manual File Update
WP-CLI

برای بیشتر سایت‌ها استفاده از:

Dashboard
→ Updates
→ Update Now

ساده‌ترین روش است. WordPress این روش را به‌صورت رسمی به‌عنوان One-click Update ارائه می‌کند.

اگر Update خودکار Dashboard با مشکل مواجه شود، می‌توان فایل‌های Core را به‌صورت دستی جایگزین کرد یا در محیط دارای SSH از:

wp core update

استفاده کرد.

قبل از هر Major Update بهتر است Backup تهیه شود و پس از بروزرسانی نیز Website، Dashboard، Pluginها، Theme، Cache و Error Log بررسی شوند. در Hosting Environment نیز مشکلاتی مانند Disk Quota، File Ownership، PHP Compatibility و محدودیت دسترسی خروجی Server می‌توانند باعث شکست Update شوند.