آموزش رفع مشکل error establishing a database connection

مشکل Error establishing a database connection (خطا در برقراری ارتباط با پایگاه داده) یکی از رایج‌ترین و ناامیدکننده‌ترین مشکلاتی است که ممکن است در وردپرس با آن مواجه شوید. این خطا به این معنی است که وب‌سایت وردپرس شما نمی‌تواند با پایگاه داده‌ای که تمام محتوا، تنظیمات و اطلاعات کاربران وب‌سایت شما در آن ذخیره شده است، ارتباط برقرار کند. در ادامه به شما در رفع این مشکل کمک می کنیم.

در اینجا به بررسی شایع‌ترین علل و راه‌حل‌های آن‌ها می‌پردازیم:

۱. اطلاعات ورود به پایگاه داده اشتباه است

این شایع‌ترین دلیل بروز این خطاست. وب‌سایت وردپرس شما از فایلی به نام wp-config.php برای ذخیره جزئیات ورود به پایگاه داده استفاده می‌کند. اگر این اطلاعات اشتباه باشند، وردپرس نمی‌تواند متصل شود.

• چگونه رفع کنیم:
  1. فایل wp-config.php را پیدا کنید: با استفاده از یک کلاینت FTP (مانند FileZilla) یا مدیر فایل در پنل کنترل هاست خود به فایل‌های وب‌سایتتان دسترسی پیدا کنید. فایل wp-config.php معمولاً در دایرکتوری اصلی وردپرس شما قرار دارد.
  2. فایل را ویرایش کنید: فایل wp-config.php را باز کنید و به دنبال خطوط زیر بگردید:

     define('DB_NAME', 'your_database_name');
     define('DB_USER', 'your_database_username');
     define('DB_PASSWORD', 'your_database_password');
     define('DB_HOST', 'localhost'); // معمولاً 'localhost' است
     

  3. اعتبارسنجی اطلاعات:
     • DB_NAME: مطمئن شوید که این دقیقاً با نام پایگاه داده وردپرس شما مطابقت دارد.
     • DB_USER: این باید نام کاربری صحیح برای پایگاه داده شما باشد.
     • DB_PASSWORD: این رمز عبور برای کاربر پایگاه داده شماست.
     • DB_HOST: در بیشتر موارد، این localhost خواهد بود. با این حال، برخی از شرکت‌های هاستینگ از نام میزبان متفاوتی برای سرور پایگاه داده استفاده می‌کنند. اگر localhost کار نکرد، مستندات ارائه‌دهنده هاست خود را بررسی کنید یا با پشتیبانی آن‌ها تماس بگیرید.
  • نکته: اگر در مورد اطلاعات ورود به پایگاه داده خود مطمئن نیستید، معمولاً می‌توانید آن‌ها را در پنل کنترل هاست خود (مانند cPanel، Plesk) در بخش “Databases” (پایگاه‌های داده) یا “MySQL Databases” (پایگاه‌های داده MySQL) پیدا کنید.

۲. پایگاه داده خراب است

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

• مراحل رفع مشکل error establishing a database connection در این حالت:
  1. خط تعمیر را به wp-config.php اضافه کنید: خط زیر را بالاتر از خط /* That's all, stop editing! Happy publishing. */ در فایل wp-config.php خود اضافه کنید:

     define('WP_ALLOW_REPAIR', true);
     

  2. ابزار تعمیر را اجرا کنید: مرورگر خود را باز کنید و به yourwebsite.com/wp-admin/maint/repair.php بروید. گزینه‌ای برای “Repair Database” (تعمیر پایگاه داده) یا “Repair and Optimize Database” (تعمیر و بهینه‌سازی پایگاه داده) مشاهده خواهید کرد. روی هر کدام که می‌خواهید کلیک کنید.
  3. خط تعمیر را حذف کنید: پس از اتمام تعمیر و کار کردن سایت شما، به یاد داشته باشید که define('WP_ALLOW_REPAIR', true); را از wp-config.php به دلایل امنیتی حذف کنید.

۳. مشکلات سرور شرکت هاستینگ

ممکن است سرور شرکت هاستینگ شما با مشکلاتی مانند بارگذاری بیش از حد سرور، خرابی سرور MySQL یا تعمیر و نگهداری مواجه باشد.

• چگونه رفع کنیم:
  • با ارائه‌دهنده هاست خود تماس بگیرید: این سریع‌ترین راه برای تأیید وجود مشکلات سمت سرور است. آن‌ها می‌توانند به شما بگویند که آیا قطعی وجود دارد یا سرور پایگاه داده شما از کار افتاده است.

۴. سهمیه پایگاه داده (Database Quota) پر شده است

برخی از پلن‌های هاستینگ دارای محدودیت در اندازه پایگاه داده شما هستند. اگر پایگاه داده شما از این حد فراتر رود، می‌تواند باعث خطاهای اتصال شود.

• چگونه رفع کنیم:
  • پلن هاست خود را بررسی کنید: وارد پنل کنترل هاست خود شوید و میزان فضای دیسک و اندازه پایگاه داده خود را بررسی کنید.
  • پلن خود را ارتقا دهید: اگر به حد مجاز خود رسیده‌اید، ممکن است لازم باشد پلن هاست خود را به پلنی با منابع بیشتر ارتقا دهید.
  • پایگاه داده خود را بهینه‌سازی کنید: همچنین می‌توانید با پاکسازی بازبینی‌های قدیمی، نظرات اسپم و ترانزینت‌ها با استفاده از پلاگینی مانند WP-Optimize یا با انجام دستی آن از طریق phpMyAdmin، پایگاه داده خود را بهینه‌سازی کنید تا اندازه آن کاهش یابد.

۵. فایل‌های وردپرس خراب هستند

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

• چگونه رفع کنیم:
  1. از سایت خود بک‌آپ بگیرید: قبل از اقدام به این کار، همیشه یک نسخه پشتیبان کامل از وب‌سایت خود تهیه کنید.
  2. فایل‌های تازه وردپرس را دانلود کنید: به wordpress.org بروید و آخرین نسخه وردپرس را دانلود کنید.
  3. فایل‌های اصلی را جایگزین کنید:
     • فایل فشرده دانلود شده را از حالت فشرده خارج کنید.
     • با استفاده از FTP، پوشه‌های wp-includes و wp-admin را از دانلود جدید به سرور خود آپلود کنید و روی موارد موجود رونویسی کنید.
     • فایل‌های جداگانه را از پوشه wp-content جدید به پوشه wp-content موجود خود آپلود کنید، اما روی پوشه‌های wp-content/themes یا wp-content/plugins، یا هیچ یک از فایل‌های رسانه‌ای خود رونویسی نکنید.
     • تمام فایل‌های دیگر را از پوشه جدید وردپرس به دایرکتوری اصلی خود آپلود کنید و روی موارد موجود رونویسی کنید. روی فایل wp-config.php خود رونویسی نکنید.

قبل از شروع: مراحل ضروری

• از همه چیز بک‌آپ بگیرید: همیشه، همیشه، همیشه قبل از اقدام به هر گونه رفع اشکالی، از فایل‌ها و پایگاه داده وردپرس خود بک‌آپ تهیه کنید. این کار تضمین می‌کند که در صورت بروز مشکل می‌توانید به حالت کاری بازگردید.
• لاگ‌های خطای وب‌سایت خود را بررسی کنید: پنل کنترل شرکت هاستینگ شما معمولاً بخشی برای لاگ‌های خطا دارد. این لاگ‌ها گاهی اوقات می‌توانند اطلاعات دقیق‌تری در مورد مشکل ارائه دهند.

با پیگیری سیستماتیک این مراحل عیب‌یابی، باید بتوانید مشکل “Error establishing a database connection” را در سایت وردپرس خود شناسایی و حل کنید.

اگر با وجود امتحان کردن این راه‌حل‌ها همچنان با مشکل مواجه هستید، بهتر است با تیم پشتیبانی ارائه‌دهنده هاست خود تماس بگیرید. آن‌ها به ابزارهای تشخیصی سمت سرور دسترسی دارند و اغلب می‌توانند علت دقیق مشکل را شناسایی کنند.

سوالات متداول: رفع مشکل error establishing a database connection

۱. دلیل اصلی خطای Error establishing a database connection چیست؟

این خطا به این معنی است که وب‌سایت شما نمی‌تواند با پایگاه داده (database) خود ارتباط برقرار کند. این اتفاق اغلب به دلیل اطلاعات نادرست ورود به پایگاه داده در فایل wp-config.php رخ می‌دهد. دلایل اصلی این مشکل عبارتند از:

• اطلاعات ورود نادرست: نام کاربری، رمز عبور، نام پایگاه داده یا هاست پایگاه داده (DB Host) اشتباه است.
• مشکل در سرور پایگاه داده: سرور پایگاه داده از کار افتاده، یا به دلیل ترافیک زیاد قادر به پاسخگویی نیست.
• فایل‌های اصلی وردپرس آسیب دیده: فایل‌های وردپرس، به خصوص فایل wp-config.php، دچار تغییر یا خرابی شده‌اند.

---

۲. چگونه اطلاعات پایگاه داده را بررسی و اصلاح کنم؟

برای رفع این مشکل، باید اطلاعات پایگاه داده را در فایل wp-config.php بررسی کنید.

• مرحله ۱: با استفاده از یک نرم‌افزار FTP (مثل FileZilla) یا از طریق مدیریت فایل (File Manager) در پنل هاست (مانند cPanel)، به ریشه سایت خود دسترسی پیدا کنید.
• مرحله ۲: فایل wp-config.php را پیدا کرده و آن را باز کنید.
• مرحله ۳: مطمئن شوید که اطلاعات زیر به درستی وارد شده‌اند:

  PHP

  define('DB_NAME', 'database_name_here');
  define('DB_USER', 'username_here');
  define('DB_PASSWORD', 'password_here');
  define('DB_HOST', 'localhost');
  

• توجه: مقدار DB_HOST اغلب localhost است، اما برخی هاست‌ها ممکن است از مقدار متفاوتی استفاده کنند. می‌توانید این اطلاعات صحیح را در پنل کاربری هاست خود، در بخش مدیریت پایگاه داده، پیدا کنید.

---

۳. اگر اطلاعات درست بود، مشکل از کجاست؟

اگر مطمئن هستید که اطلاعات wp-config.php صحیح است، ممکن است مشکل از سرور پایگاه داده باشد.

• بررسی سرور: از طریق پنل هاست خود (مانند cPanel)، به بخش phpMyAdmin بروید. اگر نتوانستید وارد شوید یا جداول پایگاه داده را ببینید، به احتمال زیاد سرور پایگاه داده مشکل دارد.
• تماس با پشتیبانی هاست: در این حالت، بهترین و سریع‌ترین راهکار این است که فوراً با تیم پشتیبانی شرکت هاستینگ خود تماس بگیرید. آن‌ها می‌توانند وضعیت سرور پایگاه داده را بررسی کرده و در صورت نیاز، آن را مجدداً راه‌اندازی کنند.

---

۴. آیا ممکن است باگ در فایل‌های اصلی وردپرس باعث این ارور شود؟

بله، در موارد نادر، فایل‌های هسته وردپرس ممکن است دچار مشکل شوند.

• راهکار: آخرین نسخه وردپرس را از وب‌سایت رسمی دانلود کنید. سپس از طریق FTP، فایل‌های wp-includes و wp-admin را آپلود کرده و جایگزین فایل‌های موجود کنید. این کار فایل‌های اصلی وردپرس را بازسازی می‌کند و اغلب مشکلاتی که به دلیل خرابی فایل‌ها ایجاد شده‌اند را حل می‌کند. توجه داشته باشید که این کار بر روی محتوای سایت شما تأثیری ندارد، اما همیشه توصیه می‌شود قبل از انجام هرگونه تغییر، از سایت خود بک‌آپ بگیرید.

اگر با توجه به توضیحاتی که بالا دادیم در رفع مشکل error establishing a database connection مشکل دارید با کارشناسان موج رادیکال تماس بگیرید که به شما کمک کنیم. ما خدمات پشتیبانی سایت ارائه می‌دهیم و می‌توانیم به شما کمک کنیم.