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

گاهی هم همه‌چیز تا چند دقیقه قبل درست کار می‌کند، اما بعد از یک تغییر در تنظیمات، نصب یک نرم‌افزار جدید یا اجرای هم‌زمان چند سرویس، دیگر خبری از localhost نیست! در این مقاله از وبلاگ پارس هاست سراغ علت‌های رایج باز نشدن لوکال هاست می‌رویم و راهکارهای رفع آن‌ها را بررسی می‌کنیم. همچنین مشکلاتی مثل ارور لوکال هاست بعد از تغییرات، باز نشدن لوکال هاست در WAMP، ارور ۴۰۴ در لوکال هاست، کار نکردن XAMPP (زمپ) و مشکل ورود به وردپرس روی هاست محلی را بررسی خواهیم کرد.

لوکال هاست چیست و چرا به آن نیاز داریم؟

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

نرم‌افزارهایی مثل WAMP، XAMPP و MAMP ابزارهای رایج برای راه‌اندازی این محیط هستند. این بسته‌ها سرویس‌های موردنیاز برای اجرای پروژه‌های وب، مثل Apache، PHP و MySQL را در اختیار شما می‌گذارند.

 مثال:

• کدهای HTML، CSS و JavaScript را مرورگر مستقیما اجرا می‌کند.
• PHP برای اجرا به محیط سمت سرور نیاز دارد.
• وردپرس هم به PHP، وب‌سرور و پایگاه داده MySQL یا MariaDB نیاز دارد.

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

مشکلات و راه‌حل‌ها در یک نگاه

اگر نصب WAMP یا XAMPP را کامل انجام داده‌اید اما هنوز localhost باز نمی‌شود، سراغ این مراحل بروید. بهتر است آن‌ها را به‌ترتیب بررسی کنید؛ این کار خیلی سریع‌تر از تغییر تصادفی تنظیمات مختلف نتیجه می‌دهد.

۱. بررسی کنید وب‌سرور اجرا می‌شود یا نه؟

اول از همه وضعیت Apache را بررسی کنید. در WAMP، رنگ آیکون برنامه سرنخ خوبی به شما می‌دهد:

• سبز: سرویس‌های موردنیاز به‌درستی اجرا می‌شوند.
• نارنجی: یکی از سرویس‌ها مشکل دارد یا کامل اجرا نمی‌شود.
• قرمز: سرویس‌های اصلی اجرا نیستند.

در XAMPP هم وارد کنترل پنل شوید و وضعیت Apache و MySQL را ببینید. اگر مقابل آپاچی عبارت Running را نمی‌بینید، وب‌سرور هنوز اجرا نشده است. روی Start کلیک کنید. اگر آپاچی بدون مشکل اجرا شد، دوباره آدرس زیر را در مرورگر باز کنید: http://localhost اگر آپاچی استارت نمی‌شود، چند بار پشت‌سرهم روی Start کلیک نکنید. اول لاگ خطا را آپاچی کنید. معمولا همانجا سرنخ اصلی مشکل را پیدا می‌کنید.

در نرم افزار xampp مسیر رایج لاگ آپاچی این است: xampp/apache/logs/error.log در WAMP هم محل لاگ با توجه به نسخه و ساختار نصب فرق می‌کند، اما معمولا فایل error.log را داخل پوشه آپاچی پیدا می‌کنید.

۲. تداخل پورت ۸۰ با برنامه‌های دیگر

یکی از رایج‌ترین علت‌های اجرا نشدن Apache، اشغال بودن پورت ۸۰ است. آپاچی به‌صورت پیش‌فرض برای درخواست‌های HTTP از پورت ۸۰ استفاده می‌کند. اگر سرویس دیگری همین پورت را در اختیار داشته باشد، Apache نمی‌تواند روی آن گوش دهد. برخی برنامه‌ها و سرویس‌هایی که ممکن است باعث این تداخل شوند عبارت‌اند از:

• IIS
• World Wide Web Publishing Service
• بعضی نسخه‌های قدیمی Skype
• سایر وب‌سرورهای نصب‌شده روی ویندوز

برای پیدا کردن برنامه‌ای که پورت ۸۰ را در اختیار گرفته، Command Prompt را با دسترسی Administrator باز کنید و این دستور را اجرا کنید :netstat -ano | findstr :80 در خروجی، عددی که در ستون آخر می‌بینید PID پردازه است. سپس می‌توانید آن PID را در Task Manager پیدا کنید و ببینید کدام برنامه پورت را در اختیار دارد.

راه اول: سرویس تداخل‌دهنده را متوقف کنید اگر مثلا World Wide Web Publishing Service پورت ۸۰ را اشغال کرده است، وارد services.msc شوید و سرویس را پیدا کنید. سپس این مراحل را دنبال کنید:

1. روی سرویس کلیک راست کنید.
2. گزینه Stop را بزنید.
3. در صورت نیاز، نوع Startup را روی Manual قرار دهید.
4. Apache را دوباره اجرا کنید.

راه دوم: پورت آپاچی را تغییر دهید اگر نمی‌خواهید سرویس دیگر را متوقف کنید، پورت Apache را تغییر دهید. برای مثال، می‌توانید پورت ۸۰ را به ۸۰۸۰ تغییر دهید. بعد از تغییر تنظیمات و ری‌استارت کردن Apache، آدرس سایت دیگر فقط localhost نیست و باید از آدرس زیر استفاده کنید:

http://localhost:8080 اگر پورت را روی ۸۸۸۸ تنظیم کنید، آدرس هم به این شکل خواهد بود :http://localhost:8888 پس اگر آپاچی روی پورت دیگری اجرا می‌شود و شما فقط localhost را وارد می‌کنید، ممکن است دنبال مشکل در جای اشتباهی بگردید.

۳. فایروال یا آنتی‌ویروس

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

۴. فایل‌ها را در پوشه اشتباه گذاشته‌اید

گاهی خود لوکال هاست کاملا سالم است، آپاچی هم بدون مشکل اجرا می‌شود، اما پروژه شما نمایش داده نمی‌شود. اینجا باید مسیر فایل‌ها را بررسی کنید. مسیر پیش‌فرض پروژه‌ها در این نرم‌افزارها معمولا به این شکل است:

• در WAMP: فایل‌ها باید داخل پوشه www باشند.
• در XAMPP: فایل‌ها باید داخل پوشه htdocs باشند.

مثال: اگر در XAMPP پوشه پروژه‌ای با نام shop داخل htdocs قرار دارد، آدرس پروژه معمولا این است: http://localhost/shop

در WAMP هم اگر پروژه داخل www قرار داشته باشد، ساختار آدرس مشابه است: http://localhost/shop اگر به‌جای صفحه سایت با خطای ۴۰۴ روبه‌رو می‌شوید، این موارد را بررسی کنید:

• نام پوشه پروژه را درست وارد کرده‌اید؟
• پروژه واقعا داخل www یا htdocs قرار دارد؟
• فایل index.php یا index.html داخل پوشه اصلی وجود دارد؟
• پوشه پروژه را یک لایه داخل‌تر از مسیر اصلی قرار نداده‌اید؟
• آدرس واردشده در مرورگر با نام واقعی پوشه یکسان است؟

مثلا ممکن است فایل پروژه به این شکل قرار گرفته باشد: htdocs/shop/shop/index.php اما شما این آدرس را باز کنید: http://localhost/shop در این حالت آپاچی دنبال فایل‌ها در پوشه htdocs/shop می‌گردد، درحالی‌که فایل اصلی یک پوشه پایین‌تر قرار دارد. مسیر درست در چنین ساختاری می‌شود: http://localhost/shop/shop البته بهتر است ساختار پوشه‌ها را از ابتدا مرتب نگه دارید تا بعدا درگیر چنین خطاهایی نشوید.

ارور ۴۰۴ در لوکال هاست، دلیلش چیست؟

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

• آدرسی که در مرورگر وارد می‌کنید با نام پوشه پروژه مطابقت ندارد. مثلا پروژه داخل www/mysite قرار دارد، اما فقط localhost را باز می‌کنید.
  فایل index.php یا index.html در مسیر موردنظر وجود ندارد.
  پروژه داخل پوشه اشتباهی قرار دارد یا Document Root به مسیر دیگری اشاره می‌کند.
  در وردپرس، ساختار Permalink بعد از انتقال سایت با محیط لوکال هماهنگ نیست.
  ماژول mod_rewrite در آپاچی فعال نیست و وردپرس نمی‌تواند بعضی از URLها را درست پردازش کند.
  فایل .htaccess وجود ندارد یا تنظیمات آن مشکل دارد.

این خطا با خطاهای دسترسی مثل خطای ۴۰۳ فرق دارد. خطای ۴۰۴ معمولا یعنی منبع موردنظر پیدا نمی‌شود، اما ۴۰۳ بیشتر به محدودیت دسترسی مربوط است.

چرا برنامه زمپ (XAMPP) کار نمیکنه؟

وقتی می‌گوییم «XAMPP کار نمی‌کنه»، اول باید مشخص کنیم مشکل دقیقا کجاست. آیا خود برنامه باز نمی‌شود؟ آیا Apache اجرا نمی‌شود؟ یا MySQL استارت نمی‌شود؟ هرکدام علت متفاوتی دارند.

1. XAMPP را با دسترسی Administrator اجرا کنید: روی آیکون XAMPP کلیک راست کنید و گزینه Run as Administrator را بزنید. بعضی سرویس‌ها برای اجرا به دسترسی بیشتری نیاز دارند و نداشتن مجوز مناسب می‌تواند جلوی اجرای آن‌ها را بگیرد. اگر بعد از اجرای XAMPP با دسترسی Administrator، Apache و MySQL بدون خطا Start شدند، مشکل از سطح دسترسی بوده است.
2. نسخه XAMPP و وضعیت نصب را بررسی کنید: اگر مشکل بعد از تغییر نسخه ویندوز، جابه‌جایی فایل‌های XAMPP یا نصب مجدد برنامه شروع شده است، ممکن است نصب فعلی مشکل داشته باشد. قبل از نصب مجدد، اول لاگ‌ها را بررسی کنید. نصب دوباره همیشه اولین راه‌حل نیست و اگر مشکل از پورت یا تنظیمات باشد، بعد از نصب مجدد هم دوباره سراغ شما می‌آید! اگر نصب واقعا آسیب دیده یا فایل‌های موردنیاز ناقص هستند، نسخه سازگار و پایدار XAMPP را از منبع رسمی نصب کنید.
3. تداخل پورت را بررسی کنید: برنامه‌هایی مثل Skype، IIS یا حتی VMware می‌توانند پورت‌های مورد نیاز XAMPP را اشغال کنند (همان راه‌حل بخش پورت ۸۰ بالا را اجرا کنید).
4. بررسی لاگ خطا: مسیر xampp/apache/logs/error.log و xampp/mysql/data/*.err دقیقا می‌گویند سرویس به چه دلیلی بالا نمی‌آید؛ همیشه اول این فایل‌ها را چک کنید.

مشکل ورود به وردپرس در لوکال هاست

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

• خطای اتصال به پایگاه داده (Error establishing a database connection): معمولا یعنی نام دیتابیس، یوزرنیم یا پسورد داخل فایل wp-config.php با چیزی که در phpMyAdmin ساخته‌اید مطابقت ندارد. مقدار پیش‌فرض یوزرنیم در لوکال هاست معمولا root است و پسورد خالی.
• “یک خطای مهم در وردپرس رخ داده” بعد از وارد کردن اطلاعات دیتابیس: ابتدا یک‌به‌یک افزونه‌ها را غیرفعال کنید تا مشخص شود مشکل از کدام افزونه یا قالب است؛ اگر امکان ورود به پیشخوان ندارید، این کار را از طریق تغییر نام پوشه plugins در File Manager انجام دهید.
• خطای mysqli not found: این خطا معمولا به این معناست که اکستنشن mysqli در فایل php.ini غیرفعال یا کامنت شده. مسیر را باز کنید، خط extension=mysqli را پیدا کنید و مطمئن شوید ابتدای خط علامت ; ندارد؛ بعد سرویس Apache را ری‌استارت کنید.
• تغییر در php.ini باعث خرابی سایت شده: اگر بعد از اضافه یا حذف یک اکستنشن (مثلا برای فعال کردن imagick)، سایت خطا می‌دهد، بهتر است از نسخه پشتیبان php.ini (که معمولا با پسوند .bak یا در پوشه backup ذخیره می‌شود) استفاده کنید تا به حالت اول برگردد.

رفع ارور localhost؛ چک‌لیست سریع

اگر عجله دارید و می‌خواهید مرحله‌به‌مرحله پیش بروید، این چک‌لیست را به ترتیب انجام دهید:

1. Apache در WAMP یا XAMPP اجرا می‌شود؟
2. اگر Apache اجرا نمی‌شود، error.log چه خطایی نشان می‌دهد؟
3. پورت ۸۰ در اختیار برنامه دیگری نیست؟
4. پروژه داخل www یا htdocs قرار دارد؟
5. آدرس پروژه را همراه با نام پوشه درست وارد کرده‌اید؟
6. فایل index.php یا index.html در مسیر درست قرار دارد؟
7. اگر وردپرس دارید، MySQL یا MariaDB اجرا می‌شود؟
8. اطلاعات دیتابیس در wp-config.php درست است؟
9. اگر فقط صفحات داخلی وردپرس ۴۰۴ می‌دهند، Permalink و mod_rewrite را بررسی کرده‌اید؟
10. اگر بعد از تغییر PHP سایت خراب شد، آخرین تغییرات php.ini را بررسی کرده‌اید؟

در بیشتر موارد، با همین چند بررسی می‌توانید مسیر اصلی مشکل را پیدا کنید. اول خطا را شناسایی کنید، بعد سراغ تغییر تنظیمات بروید. این روش هم سریع‌تر است و هم جلوی به‌هم‌ریختن تنظیمات سالم سیستم را می‌گیرد.

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

سوالات متداول

۱. لوکال هاست چیست؟

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

۲. چرا لوکال هاست من باز می‌شود ولی سایت را پیدا نمی‌کند؟

معمولا یعنی فایل‌های پروژه در مسیر www/htdocs نیستند یا آدرس وارد‌شده در مرورگر با نام پوشه پروژه یکی نیست.

۳. بعد از تغییر php.ini چرا سایتم خراب شد؟

هر تغییر در php.ini (مثل اضافه کردن یک اکستنشن) باید با ری‌استارت کامل Apache همراه باشد؛ اگر باز هم خطا داد، به نسخه پشتیبان فایل برگردید و یک اکستنشن را در هر مرحله تست کنید، نه همه را با هم.