نصب phpMyAdmin فقط با استخراج یک فایل کامل نمی‌شود. این برنامه رابط وب مدیریت MySQL و MariaDB است و به وب‌سرور، PHP مناسب و سرور دیتابیس قابل‌دسترسی نیاز دارد. آموزش حاضر برای محیط محلی توسعه است؛ انتشار مدیریت دیتابیس روی اینترنت تنظیمات دسترسی و امنیت جداگانه می‌خواهد.
پیش‌نیازهای نصب phpMyAdmin
اگر محیط آمادهٔ توسعه از قبل phpMyAdmin دارد، ابتدا همان نصب را بررسی کنید تا نسخهٔ دوم و مسیر تکراری نسازید. برای نصب مستقل، نیازمندی‌های نسخهٔ انتخابی را با PHP و افزونه‌های فعال تطبیق دهید. حداقل نسخهٔ قابل‌اجرا الزاماً نسخهٔ دارای پشتیبانی امنیتی نیست؛ از محیط سازگار و پشتیبانی‌شده استفاده کنید.
وب‌سرور باید فایل PHP را اجرا کند و دیتابیس نیز جداگانه در حال اجرا باشد. راه‌اندازی Apache به‌تنهایی MySQL را نصب یا روشن نمی‌کند. نام حساب و رمز دیتابیس را آماده کنید؛ حساب ویندوز یا حساب مدیر وب‌سایت جای حساب دیتابیس را نمی‌گیرد.
دریافت و قرار دادن فایل‌ها
بستهٔ پایدار سازگار را از صفحهٔ رسمی دانلود phpMyAdmin دریافت و صحت بسته را با اطلاعات همان انتشار بررسی کنید. آرشیو را همراه زیرپوشه‌ها در پوشه‌ای مانند phpmyadmin زیر DocumentRoot واقعی محیط محلی استخراج کنید. مسیر نمونهٔ C:/Apache/htdocs برای همهٔ نصب‌ها وجود ندارد؛ تنظیم فعال وب‌سرور ملاک است.
اگر فایل index.php داخل دو پوشهٔ تو‌در‌تو قرار گرفته باشد، آدرس مرورگر هم باید با ساختار واقعی هماهنگ شود. نام پوشه را دقیق وارد کنید. فایل را با دوبارکلیک و نشانی file:// باز نکنید؛ درخواست باید از وب‌سرور محلی عبور کند.
تنظیم اولیه و ورود
برای تنظیم دستی، مطابق راهنمای نصب، از config.sample.inc.php نسخه‌ای به نام config.inc.php در ریشهٔ phpMyAdmin بسازید. احراز هویت cookie و میزبان درست دیتابیس را تنظیم کنید. برای blowfish_secret مقدار تصادفی اختصاصی مطابق دستور نسخهٔ نصب‌شده بسازید؛ نمونهٔ ثابت موجود در آموزش‌ها را به‌عنوان راز واقعی کپی نکنید.
ورود با رمز خالی را برای حل خطا فعال نکنید و رمز مدیر دیتابیس را برای ورود خودکار در فایل عمومی ننویسید. با حساب دارای مجوز لازم برای دیتابیس کاری وارد شوید. phpMyAdmin یک مرز مجوز مستقل از MySQL ایجاد نمی‌کند؛ دسترسی‌ها در خود دیتابیس نیز باید درست باشند.
بازکردن رابط محلی
اگر پوشه phpmyadmin در ریشهٔ سرویس محلی روی پورت معمول HTTP است، نمونهٔ نشانی چنین است:
http://localhost/phpmyadmin/این نشانی فقط برای محیط محلی است. اگر پورت وب‌سرور متفاوت است، آن را در URL وارد کنید. در Apache، به‌جای جایگزینی کورکورانهٔ index.html در کل تنظیمات، تنظیم DirectoryIndex را در محدودهٔ مناسب بررسی کنید؛ index.php باید قابل‌اجرا باشد و تنظیم سایت‌های دیگر حفظ شود.
رفع خطاهای رایج
- 404: مسیر پوشه و DocumentRoot یا Alias را بررسی کنید.
- نمایش یا دانلود کد PHP: اجرای PHP در وب‌سرور درست تنظیم نشده است؛ تا رفع مشکل رابط را در دسترس عمومی نگذارید.
- خطای افزونهٔ PHP: افزونهٔ لازم را در PHP مورد استفادهٔ وب‌سرور بررسی کنید، نه فقط PHP خط فرمان.
- خطای اتصال دیتابیس: میزبان، پورت، سرویس، حساب و رمز را تطبیق دهید.
پس از ورود، فقط یک دیتابیس آزمایشی را بررسی کنید. ابزار setup و فایل‌های موقت را مطابق مستند نسخه مدیریت کنید و برنامه را به‌روز نگه دارید. قابل‌بازشدن صفحه در localhost ثابت نمی‌کند سرویس از شبکه قابل‌دسترسی نیست؛ محدودهٔ گوش‌دادن و دسترسی وب‌سرور را هم متناسب با استفادهٔ محلی تنظیم کنید.
مطالعهٔ مرتبط
بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.
