خطا در برقراری ارتباط با پایگاه داده وردپرس یا همان error establishing a database connection یکی دیگر از خطاهای رایج وردپرس است که در سایت‌هایی با این سیستم مدیریت محتوا رخ می‌دهد. این خطا عموما زمانی رخ می‌دهد که اتصال بین دیتابیس و فایل‌های موجود در هسته وردپرس برای کار کردن و اجرای دستورات برقرار نشده است.
در این مقاله قصد داریم به بررسی دلایلی که باعث ایجاد خطا در اتصال به پایگاه داده وردپرس می‌شوند پرداخته و سپس با بررسی هر دلیل به نحوه برطرف کردن خطا بپردازیم. اگر شما هم با این خطا مواجه شدید تا انتها با ما همراه باشید.
آموزش رفع مشکل خطا در برقراری ارتباط با پایگاه داده وردپرس
برای اینکه بهتر با ارور ارتباط با پایگاه داده وردپرس آشنا شوید اینطور در نظر بگیرید که وردپرس یک سیستم مدیریت محتوا بر اساس زبان برنامه‌نویسی php است که شامل فایل‌ها و پوشه‌های مختلفی می‌باشد. این فایل‌ها دستورات را به این سیستم داده و در نهایت اطلاعات محتوایی و متنی در دیتابیس ذخیره شده و از طریق آدرس دهی فایل‌ها که در پوشه wp-content قرار دارد شروع به خواندن اطلاعات شده و در نهایت صفحه وب برای ما نمایش داده می‌شود.
حال هر زمان مشکلی به وجود آید که باعث قطع ارتباط بین پایگاه داده mySQL شده و اطلاعاتی که باید خوانده شوند تا صفحه وب را به ما نمایش دهند لود نشوند در این صورت با صفحه‌ای مشابه تصویر زیر مواجه می‌شویم که پیغام error establishing a database connection یا خطا در برقراری ارتباط با پایگاه داده در آن نمایش داده خواهد شد.
دلایل عمده‌ای که باعث این مشکل می‌شوند عبارتند از:
- تغییر اطلاعات دیتابیس در فایل wp-config.php یا خراب شدن این فایل
- از کار افتادن پایگاه داده mySQL
- حذف شدن پایگاه داده
- تغییر در سطح دسترسی فایل‌ها و پوشه‌های وردپرس
- وارد کردن اطلاعات نادرست هنگام انتقال سایت به هاست جدید یا تغییر در دیتابیس
- ایجاد مشکل در سرور سایت
- و…
به هر کدام از دلایل بالا که با ارور اتصال به دیتابیس وردپرس مواجه شوید، راهی برای یافتن خطا وجود داشته و سریعاً می‌توانید به کمک راهکارهای زیر خطا را برطرف کنید.
1. مطمئن شوید پایگاه داده کار می‌کند
هاست شما که بر روی سرور قرار دارد شامل برنامه‌های مختلفی است که باید مدام آپدیت شوند. خود پایگاه داده mySQL یا mariaDB نیز به همین شکل است. گاهی اوقات خطا در اتصال به پایگاه داده وردپرس هنگام به‌روزرسانی پایگاه داده رخ می‌دهد که نهایتاً ظرف چند دقیقه برطرف می‌شود؛ اما اگر مدت زمان بیشتری طول بکشد باید مطمئن شوید که مشکل از سمت پایگاه داده نیست.
بنابراین وارد هاست خود شده و روی گزینه File Manager کلیک کنید یا اینکه با ابزار FTP این کار را انجام داده و فایلی با نام dbtest.php را در پوشه public_html بسازید. سپس کدهای زیر را درون فایل قرار داده و ذخیره کنید.
<?php
$link = mysql_connect('localhost', 'database_username', 'database_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
?>
همانطور که در قطعه کد بالا می‌بینید به جای database_username نام دیتابیس و به جای database_password رمز دیتابیس وردپرس خود را وارد کنید. اگر این اطلاعات را فراموش کردید، می‌توانید از فایل wp-config.php آنها را پیدا کنید. بعد از ذخیره فایل آدرس دامنه خود را وارد کرده و بعد از / نام فایل که dbtest.php بود را در آدرس بار مرورگر مثل https://megatheme.net/testdb.php وارد کنید. اگر پیغام Connected successfully نمایش داده شود مشکلی وجود ندارد، در غیر این صورت مشکل از سمت پایگاه داده است.
2. اطلاعات دیتابیس را بررسی کنید
با استفاده از file manager هاست یا ابزار FTP وارد پوشه public_html شده و فایل wp-config.php را باز کنید. اگر در این فایل دقت کنید کدهایی به شکل زیر وجود خواهد داشت.
// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define('DB_NAME', 'database_name_here');
/** MySQL database username */
define('DB_USER', 'username_here');
/** MySQL database password */
define('DB_PASSWORD', 'password_here');
/** MySQL hostname */
define('DB_HOST', 'localhost');
همانطور که می‌بینید، این فایل حاوی اطلاعات زیر است.
- database_name_here: نام دیتابیس وردپرس
- username_here: نام کاربری دیتابیس وردپرس
- password_here: رمز دیتابیس وردپرس
باید بررسی کنید که اطلاعات وارد شده به جای این سه گزینه همان اطلاعاتی باشند که هنگام نصب وردپرس از آنها استفاده شده است. در صورتی که فکر می‌کنید این اطلاعات اشتباه هستند، می‌توانید وارد بخش مدیریت دیتابیس هاست شده و اطلاعات مربوط به هر گزینه را تغییر داده و سپس فایل wp-config.php را بر اساس اطلاعات جدید آپدیت کنید.
3. سطح دسترسی فایل‌ها را بررسی کنید
این حالت معمولا پس از ساخت سایت با بسته نصب آسان وردپرس صورت می‌گیرد. دلیل آن هم متفاوت بودن هاست قبلی با هاست جدید یا ایجاد تغییرات در هنگام نصب است. در این صورت باید به مسیر public_html رفته و کلیه پوشه‌ها و فایل‌های وردپرس را بررسی کنید.
سطح دسترسی برای فایل‌های وردپرس معادل 644 و سطح دسترسی برای پوشه‌های وردپرس معادل 755 باشد. اگر اینطور نبود به کمک ابزار change permissions هاست آنها را اصلاح کنید.
4. در صورت تغییر دامنه اطلاعات را بررسی کنید
اگر دامنه وردپرس خود را تغییر داده‌اید، ممکن است به دلیل اشتباهی این کار به درستی انجام نگرفته باشد. برای این کار کافی است فایل wp-config.php را باز کرده و کدهای زیر را درون آن قرار داده و ذخیره کنید.
define('WP_HOME','http://your-site.com');
define('WP_SITEURL','http://your-site.com');
به جای your-site.com آدرس دامنه خود را وارد کنید. همچنین در صورتی که از SSL آستفاده می‌کنید پروتکل را به //:https اصلاح کنید. اگر مشکل همچنان پابرجا بود وارد پوشه wp-includes وردپرس شده و فایل functions.php این پوشه را باز کنید. اگر دو خط زیر در فایل وجود داشت، آدرس را اصلاح کنید در صورتی هم که وجود نداشت اضافه کرده و فایل را ذخیره کنید.
update_option( 'siteurl', 'http://your-site.com' ); update_option( 'home', 'http://your-site.com' );
توجه داشته باشید که بعد از انجام این دو کار اگر مشکل برطرف شد یا همچنان باقی ماند، کدهای اضافی را حذف کنید.
5. پایگاه داده را تعمیر کنید
برای این منظور کد زیر را به فایل wp-config.php موجود در public_html اضافه کنید.
define( 'WP_ALLOW_REPAIR', true );
سپس آدرس سایت خود را به صورت زیر باز کنید.
https://megatheme.net/wp-admin/maint/repair.php
دقت کنید که به جای دامنه megatheme.net نام دامنه خود را وارد کنید. در این صورت صفحه‌ای مشابه تصویر زیر نمایش داده می‌شود که می‌توانید با کلیک روی دکمه تعمیر پایگاه داده به کمک خود وردپرس دیتابیس را تعمیر کنید تا مشکل برطرف شود.
6. از پشتیبانی هاست خود کمک بگیرید
اگر به کمک روش‌های معرفی شده موفق به برطرف کردن این خطا نشدید راه حل نهایی این است که از پشتیبانی هاست یا یک فرد متخصص در زمینه وردپرس کمک بگیرید تا مشکل برقرار نشدن اتصال به پایگاه داده وردپرس را بررسی و رفع کند.
امیدوارم که این آموزش هم مورد توجه و پسند شما قرار گرفته و به کمک آن مشکل خطا در برقراری ارتباط با پایگاه داده وردپرس را برطرف کنید. در صورتی که در خصوص این مقاله سوالی دارید از بخش نظرات برای ما ارسال کنید.