ریشه خطای اتصال دیتابیس چیست؟
خطای "Error Establishing a Database Connection" یا "برقراری ارتباط با پایگاه داده با خطا مواجه شد" بحرانیترین خطای وردپرس است. این خطا به این معنی است که وردپرس توانسته فایلهای سایت شما را پیدا کند، اما نتوانسته از طریق اطلاعاتی که در فایل تنظیمات خود دارد، به پایگاه داده (که محتوای سایت در آن ذخیره شده) متصل شود.
۹۹٪ مواقع، دلیل این خطا یکی از دو مورد زیر است:
-
اشتباه بودن نام دیتابیس، نام کاربری یا رمز عبور در فایل تنظیمات وردپرس.
-
خرابی دیتابیس (Corrupted Database).
بخش اول: عیبیابی اطلاعات اتصال (wp-config.php)
وردپرس برای اتصال به دیتابیس، از فایلی به نام wp-config.php که در ریشه سایت قرار دارد، استفاده میکند. باید مطمئن شوید اطلاعات در این فایل کاملاً صحیح و مطابق با دیتابیس موجود در cPanel باشد.
۱. بررسی دیتابیس در cPanel
-
وارد پنل کاربری و سپس cPanel شوید.
-
در بخش Databases، وارد ابزار MySQL Databases شوید.
-
در بخش Current Databases، نام دیتابیس و در بخش Current Users نام کاربری دیتابیس خود را بررسی کنید و آنها را یادداشت نمایید.
۲. ویرایش فایل wp-config.php
-
وارد File Manager در cPanel شوید و به پوشه
public_htmlبروید. -
فایل
wp-config.phpرا پیدا کرده، روی آن راست کلیک کرده و Edit را انتخاب کنید. -
در این فایل، ۴ خط زیر را پیدا کرده و مقادیر آنها را با اطلاعاتی که از مرحله قبل به دست آوردید، مقایسه کنید:
| کد در wp-config.php | مقداری که باید چک شود |
define( 'DB_NAME', '...' ); |
نام دیتابیس کامل (مثلاً cpaneluser_mydata) |
define( 'DB_USER', '...' ); |
نام کاربری کامل دیتابیس (مثلاً cpaneluser_myuser) |
define( 'DB_PASSWORD', '...' ); |
رمز عبور کاربر دیتابیس (دقیقاً مطابق با رمز عبوری که در cPanel تعیین کردید) |
define( 'DB_HOST', '...' ); |
آدرس هاست دیتابیس (باید معمولاً localhost باشد) |
-
در صورت وجود هرگونه مغایرت، آن را تصحیح کرده و فایل را ذخیره (Save Changes) کنید.
-
سایت خود را رفرش کنید. اگر مشکل از اطلاعات اتصال باشد، سایت اکنون باید بالا بیاید.
بخش دوم: عیبیابی خرابی دیتابیس (Repair Database)
اگر اطلاعات اتصال کاملاً صحیح بودند اما خطا ادامه داشت، به احتمال زیاد ساختار دیتابیس شما دچار مشکل شده است (مثلاً پس از نصب یک افزونه ناقص یا قطع برق سرور).
۱. فعالسازی حالت تعمیر (Repair)
برای فعال کردن ابزار تعمیر دیتابیس وردپرس، باید یک خط کد به فایل wp-config.php اضافه کنید:
-
مجدداً فایل
wp-config.phpرا در File Manager باز کنید. -
کد زیر را قبل از خط
/* That's all, stop editing! Happy blogging. */اضافه کنید:
define('WP_ALLOW_REPAIR', true);
-
فایل را ذخیره کنید.
۲. اجرای ابزار تعمیر
-
آدرس زیر را در مرورگر خود وارد کنید:
http://yourdomain.com/wp-admin/maint/repair.php
(به جای yourdomain.com آدرس سایت خود را وارد کنید)
-
صفحهای با عنوان "WordPress Database Repair" مشاهده خواهید کرد.
-
گزینه "Repair Database" را انتخاب کنید.
-
پس از تکمیل فرآیند، وردپرس جداول خراب شده را تعمیر میکند.
۳. حذف کد تعمیر
بسیار مهم: پس از اتمام تعمیر و اطمینان از رفع خطا، باید مجدداً فایل wp-config.php را باز کرده و خط define('WP_ALLOW_REPAIR', true); را حذف کنید تا افراد غیرمجاز نتوانند به این ابزار دسترسی پیدا کنند.
بخش سوم: بررسی سلامت سرور دیتابیس
اگر تمام مراحل بالا شکست خورد، احتمال دارد خود سرویس دیتابیس (MySQL Server) در هاست شما در دسترس نباشد. برای بررسی این موضوع:
-
وارد cPanel شوید.
-
وارد ابزار phpMyAdmin شوید.
-
اگر phpMyAdmin به سرعت و بدون خطا لود شود و بتوانید لیست دیتابیسهای خود را ببینید، سرور دیتابیس شما فعال است و مشکل احتمالاً نرمافزاری است.
-
اگر phpMyAdmin خطا بدهد یا لود نشود، مشکل از سمت سرور است.
