راهنمای جامع حل خطاهای وردپرس
وردپرس یکی از محبوبترین سیستمهای مدیریت محتوا (CMS) در جهان است که با امکانات گسترده و انعطافپذیری بالا، میلیونها وبسایت را میزبانی میکند. با این حال، مانند هر نرمافزار دیگری، ممکن است هنگام استفاده از وردپرس با خطاهای مختلفی مواجه شوید. این مقاله راهنمای جامعی برای تشخیص و حل این خطاها ارائه میدهد.
۱. خطای «صفحه سفید مرگ» (White Screen of Death)
توضیحات
این خطا زمانی رخ میدهد که صفحه وبسایت شما کاملاً سفید و خالی نمایش داده میشود، بدون هیچ پیام خطا یا نشانهای. این مشکل معمولاً به دلیل تداخل پلاگینها، خطاهای قالب، یا محدودیت حافظه رخ میدهد.
راهحل:
- افزایش حافظه PHP:
- وارد فایل
wp-config.php
شوید و کد زیر را اضافه کنید:phpdefine('WP_MEMORY_LIMIT', '256M');
- این دستور محدودیت حافظه PHP را افزایش میدهد.
- وارد فایل
- غیرفعال کردن پلاگینها:
- از طریق FTP یا هاست خود، به پوشه
wp-content/plugins
بروید. - نام پوشهی پلاگینها را تغییر دهید تا غیرفعال شوند. سپس سایت را بررسی کنید.
- از طریق FTP یا هاست خود، به پوشه
- فعالسازی قالب پیشفرض وردپرس:
- در پوشه
wp-content/themes
، نام قالب فعال را تغییر دهید. - وردپرس به طور خودکار یک قالب پیشفرض مانند Twenty Twenty-Three را فعال میکند.
- در پوشه
- بررسی فایل لاگ:
- فایل
error_log
سرور را بررسی کنید تا علت خطا را شناسایی کنید.
- فایل
۲. خطای «Error Establishing a Database Connection»
توضیحات
این خطا زمانی رخ میدهد که وردپرس نمیتواند به پایگاه داده متصل شود. ممکن است اطلاعات ورود به پایگاه داده نادرست باشد یا سرور پایگاه داده از دسترس خارج شده باشد.
راهحل:
- بررسی فایل wp-config.php:
- اطمینان حاصل کنید که مقادیر زیر در فایل
wp-config.php
صحیح هستند:phpdefine('DB_NAME', 'نام پایگاه داده');
define('DB_USER', 'نام کاربری');
define('DB_PASSWORD', 'رمز عبور');
define('DB_HOST', 'localhost');
- اطمینان حاصل کنید که مقادیر زیر در فایل
- تعمیر پایگاه داده:
- خط زیر را به فایل
wp-config.php
اضافه کنید:phpdefine('WP_ALLOW_REPAIR', true);
- سپس به آدرس
http://yourwebsite.com/wp-admin/maint/repair.php
بروید و پایگاه داده را تعمیر کنید.
- خط زیر را به فایل
- بررسی وضعیت سرور پایگاه داده:
- با پشتیبانی هاست خود تماس بگیرید و مطمئن شوید که سرور MySQL به درستی کار میکند.
۳. خطای «404 Not Found»
توضیحات
این خطا زمانی رخ میدهد که صفحهای از وبسایت شما پیدا نمیشود. معمولاً مشکل در ساختار پیوندهای یکتا (Permalinks) است.
راهحل:
- بازنشانی پیوندهای یکتا:
- به پیشخوان وردپرس بروید و از منوی تنظیمات → پیوندهای یکتا، گزینهای را انتخاب و ذخیره کنید.
- این کار فایل
.htaccess
را بهروزرسانی میکند.
- بررسی فایل .htaccess:
- مطمئن شوید که فایل
.htaccess
شما شامل کد زیر است:perl# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
- مطمئن شوید که فایل
۴. خطای «HTTP Error» هنگام بارگذاری تصاویر
توضیحات
این خطا معمولاً به دلیل محدودیتهای سرور یا تنظیمات اشتباه رخ میدهد.
راهحل:
- افزایش حجم بارگذاری فایل:
- به فایل
php.ini
سرور مراجعه کنید و مقادیر زیر را تنظیم کنید:makefileupload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
- به فایل
- تغییر فرمت تصویر:
- فرمت تصویر را از .png به .jpg تغییر دهید یا اندازه تصویر را کاهش دهید.
- تنظیمات وردپرس:
- خط زیر را به فایل
functions.php
قالب اضافه کنید:phpadd_filter('wp_image_editors', function($editors) {
return ['WP_Image_Editor_GD'];
});
- خط زیر را به فایل
۵. خطای «Too Many Redirects»
توضیحات
این خطا زمانی رخ میدهد که وبسایت شما در یک حلقه بیپایان از ریدایرکتها گرفتار شده است. مشکل معمولاً از تنظیمات اشتباه آدرس سایت یا افزونهها ناشی میشود.
راهحل:
- بررسی تنظیمات URL:
- به پیشخوان وردپرس بروید و از تنظیمات → عمومی، مطمئن شوید که آدرس سایت (Site URL) و آدرس وردپرس (WordPress URL) یکسان هستند.
- غیرفعال کردن افزونهها:
- پلاگینهای مرتبط با ریدایرکت مانند Yoast SEO یا Redirection را غیرفعال کنید.
- بررسی فایل .htaccess:
- اطمینان حاصل کنید که ریدایرکتهای اضافی در فایل
.htaccess
وجود ندارد.
- اطمینان حاصل کنید که ریدایرکتهای اضافی در فایل
۶. خطای «Cannot Modify Header Information»
توضیحات
این خطا زمانی رخ میدهد که فایلهای PHP وبسایت شما قبل از ارسال هدرها (Headers) اطلاعاتی به مرورگر ارسال کرده باشند.
راهحل:
- بررسی فضای خالی در فایلها:
- مطمئن شوید که قبل از کد <?php یا بعد از ?> هیچ فضای خالی وجود ندارد.
- حذف BOM از فایلها:
- فایلها را با یک ویرایشگر متن مانند Notepad++ باز کنید و اطمینان حاصل کنید که در حالت UTF-8 بدون BOM ذخیره شده باشند.
۷. خطای «The Site is Experiencing Technical Difficulties»
توضیحات
این خطا معمولاً ناشی از خطاهای PHP در قالب یا پلاگینها است.
راهحل:
- فعالسازی حالت دیباگ:
- خط زیر را به فایل
wp-config.php
اضافه کنید:phpdefine('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
- سپس فایل
debug.log
را در پوشهwp-content
بررسی کنید.
- خط زیر را به فایل
- غیرفعال کردن پلاگینها و قالب:
- همانند روشهای قبلی، پلاگینها و قالبها را غیرفعال کنید تا مشکل برطرف شود.
توصیههای کلی برای جلوگیری از خطاها
- بروز نگه داشتن وردپرس، قالبها و پلاگینها:
- همواره وردپرس و افزونهها را به آخرین نسخه بهروزرسانی کنید.
- پشتیبانگیری منظم:
- از افزونههایی مانند UpdraftPlus برای تهیه نسخه پشتیبان استفاده کنید.
- استفاده از هاست معتبر:
- هاستی را انتخاب کنید که پشتیبانی ۲۴/۷ و منابع کافی ارائه دهد.
- بررسی منظم وبسایت:
- لاگهای سرور و خطاها را به صورت دورهای بررسی کنید.
با رعایت این نکات و روشهای حل خطا، میتوانید اکثر مشکلات وردپرس را به راحتی برطرف کنید و تجربهای بدون استرس از مدیریت وبسایت داشته باشید.