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

🛠️ نحوه بررسی و حل مشکلات مربوط به پایگاه داده در لاراول

1. ⚙️ بررسی فایل .env

مطمئن شوید تنظیمات اتصال به پایگاه داده در فایل .env صحیح هستند:

env
CopyEdit
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_db_name
DB_USERNAME=your_username
DB_PASSWORD=your_password

🔸 خطاهای رایج:

• اشتباه بودن نام دیتابیس یا رمز عبور

• باز نبودن پورت دیتابیس (مخصوصاً در سرور)

2. ✅ تست اتصال با دستور Artisan

برای تست اتصال پایگاه داده از دستورات زیر استفاده کن:

bash
CopyEdit
php artisan migrate

اگر خطایی رخ داد، متن خطا دقیقاً مشخص می‌کند مشکل از کجاست (مثلاً auth failed یا database not found).

3. 🔍 بررسی ارورها در Log

فایل لاگ را چک کن:

pgsql
CopyEdit
storage/logs/laravel.log

این فایل حاوی جزئیات دقیق خطاهای ارتباط با دیتابیس است، مثل:

pgsql
CopyEdit
SQLSTATE[HY000] [1045] Access denied for user 'user'@'localhost'

4. 📌 بررسی پیکربندی در config/database.php

گاهی ممکنه فایل .env درست باشه، اما config/database.php مقدار متفاوتی را بارگذاری کنه. برای تست:

php
CopyEdit
dd(config('database.connections.mysql'));

این دستور را موقتاً در یک روت تستی قرار بده تا ببینی چه اطلاعاتی لود می‌شن.

5. 🐞 فعال‌سازی Debug برای خطاهای SQL

در فایل .env مقدار زیر را تنظیم کن:

env
CopyEdit
APP_DEBUG=true

این کمک می‌کنه که در صورت خطا، پیام‌های واضح‌تری نمایش داده بشن.

6. 📄 فعال‌سازی Query Log (لاگ کوئری‌ها)

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

php
CopyEdit
DB::enableQueryLog();
// ... اجرای کوئری‌ها
dd(DB::getQueryLog());

7. 🔄 اجرای مجدد Migrations یا Refresh

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

bash
CopyEdit
php artisan migrate:refresh

یا فقط یک جدول خاص رو مجدداً بساز:

bash
CopyEdit
php artisan migrate:refresh --path=/database/migrations/2024_01_01_create_users_table.php

8. 🧱 چک کردن سطح دسترسی کاربران دیتابیس

از طریق MySQL یا PostgreSQL بررسی کن که کاربر دیتابیس واقعاً اجازه اتصال و اجرای کوئری داره:

sql
CopyEdit
GRANT ALL PRIVILEGES ON your_db_name.* TO 'your_username'@'localhost';
FLUSH PRIVILEGES;

9. 🖥️ تست دستی با ابزارهایی مثل DBeaver یا phpMyAdmin

گاهی اوقات اتصال با Laravel قطع شده اما با ابزارهای مدیریت پایگاه داده، خطا سریع‌تر پیدا می‌شه.

10. 🧪 استفاده از try-catch برای بررسی خطا

برای بررسی خطاهای خاص هنگام اجرای کوئری:

php
CopyEdit
try {
    $users = DB::table('users')->get();
} catch (\Exception $e) {
    dd($e->getMessage());
}

🧠 جمع‌بندی

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