Коли ви працюєте з Apache в XAMPP, розуміння важливості віртуальних хостів (Virtual Hosts, V-Hosts) може значно спростити керування кількома проектами, особливо якщо вони не знаходяться в стандартному каталозі htdocs. Цей посібник допоможе вам налаштувати віртуальний хост для проекту WordPress, розташованого поза стандартною структурою папок XAMPP. Давайте розглянемо, як це зробити!
Навіщо використовувати віртуальні хости?
Уявіть таку ситуацію: ви клонували проект WordPress з Bitbucket на свою локальну машину. Замість того, щоб засмічувати стандартний каталог XAMPP (/var/lamps/htdocs), ви надаєте перевагу організовувати свої проекти в кастомній папці. Однак, щоб запустити проект з цього нового місця, потрібно внести кілька налаштувань.
Ось тут і починають працювати віртуальні хости Apache.
Віртуальні хости дозволяють вам:
- Запускати проекти з кастомних директорій.
- Використовувати чисті, кастомні URL-адреси, наприклад myproject.local замість localhost/myproject.
- Зберігати порядок у вашій робочій області.
Покрокове налаштування
Крок 1: Знайдіть необхідні файли
Залежно від вашої операційної системи, конфігураційні файли Apache знаходяться в різних місцях:
- Windows: в каталозі інсталяції XAMPP.
- Linux: зазвичай в /opt або /var.
- macOS: у папці Applications/XAMPP.
Оскільки я працюю в macOS, перейдіть до цієї папки за допомогою терміналу:
cd /Applications/XAMPP/etc
У цій директорії ви знайдете:
- httpd.conf — основний конфігураційний файл Apache.
- extra/httpd-vhosts.conf — файл конфігурації віртуальних хостів.
Крок 2: Оновіть файл hosts (у Windows він може відрізнятися)
Щоб прив'язати кастомну доменну назву до вашого локального проекту, відредагуйте файл hosts системи:
- Відкрийте термінал і введіть:
sudo nano /etc/hosts
2.
Альтернативно, використовуйте ваш улюблений редактор (наприклад, VSCode):
sudo code /etc/hosts
- Додайте новий рядок у такому форматі:
127.0.0.1 yourlocalproject.local
- Замініть yourlocalproject.local на бажану локальну доменну адресу.
- Уникайте використання поширених доменних розширень, таких як .com, щоб уникнути конфліктів.
Крок 3: Увімкніть віртуальні хости в Apache
- Відкрийте httpd.conf:
sudo nano /Applications/XAMPP/etc/httpd.conf
- Знайдіть наступний рядок:
#Include etc/extra/httpd-vhosts.conf
- Зніміть коментар, видаливши #:
Include etc/extra/httpd-vhosts.conf
Цей крок гарантує, що Apache включить файл конфігурації віртуальних хостів під час запуску.
Крок 4: Налаштуйте віртуальні хости
1.
Відкрийте файл конфігурації віртуальних хостів:
sudo nano /Applications/XAMPP/etc/extra/httpd-vhosts.conf
2.
Додайте свою власну конфігурацію віртуального хосту:
ServerName yourlocalproject.local
DocumentRoot "/path/to/your/project"
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
- Замініть /path/to/your/project на фактичний шлях до вашої папки з проєктом.
- У моєму випадку це /Users/Me/Documents/WP, тому я змінюю це на:
ServerAdmin yourlocalproject.local
DocumentRoot "/Users/Me/Documents/WP"
ServerName yourlocalproject.local
Options Indexes FollowSymLinks Includes ExecCGI
AllowOverride All
Require all granted
ErrorLog "logs/yourlocalproject-error_log"
CustomLog "logs/yourlocalproject-access_log" common
- Переконайтеся, що шлях доступний для Apache.
З якоїсь причини в моєму випадку ця зміна не спрацювала, і мені довелося додати цей код перед вищенаведеним:
ServerAdmin webmaster@localhost
DocumentRoot "/Applications/XAMPP/xamppfiles/htdocs"
ServerName localhost
Options Indexes FollowSymLinks Includes ExecCGI
AllowOverride All
Require all granted
ErrorLog "logs/localhost-error_log"
CustomLog "logs/localhost-access_log" common
Збережіть файл і вийдіть.
Крок 5: Перезапуск Apache
Нарешті, перезапустіть Apache, щоб застосувати зміни:
sudo /Applications/XAMPP/xamppfiles/bin/apachectl restart
Тестування вашої конфігурації
1.
Відкрийте ваш браузер і перейдіть за адресою http://yourlocalproject.local.
2. Якщо все налаштовано правильно, ваш проєкт повинен завантажитися, як очікується.
Поради з усунення проблем
- Проблеми з правами доступу: Переконайтеся, що папка проєкту має правильні права доступу для Apache.
- Синтаксичні помилки: Подвійно перевірте всі конфігураційні файли на наявність помилок або синтаксичних помилок.
- Apache не перезапускається: Перегляньте журнали помилок Apache, щоб визначити проблему.
Використовуючи віртуальні хости Apache, ви можете оптимізувати свій робочий процес, зберігати порядок у проєктах і створити чистіше, більш професійне локальне середовище. Успіхів у програмуванні!
Перекладено з: Simplifying Apache Virtual Hosts in XAMPP: A Beginner’s Guide