Виртуальные хосты Apache для локальной WordPress
Локальная разработка WordPress удобнее, когда каждый проект открывается по собственному адресу и не зависит от прав доступа к общей папке. Apache позволяет реализовать это через виртуальные хосты: один веб-сервер принимает запросы на разные доменные имена и направляет их в назначенные каталоги. Например, вместо длинного пути localhost/wordpress можно использовать wp.test. Подробнее о Coolscan 4000 Vs 9000 Which One Is Better For 35mm Slides Only.
Настройка требует согласованной работы трёх компонентов: конфигурации Apache, локального разрешения имён и параметров WordPress. Если изменить только файл виртуального хоста, браузер может показывать чужой сайт, страницу по умолчанию или ошибку DNS. Проверять связку удобно поэтапно, начиная с обработки HTTP-запроса и заканчивая подключением к базе данных. Подробнее о Kak Zashchitit Domashnyuyu Set Ot Perekhvata Dannykh.
Для примеров используются домены .test, зарезервированные для тестовых сетей и не совпадающие с публичными интернет-сайтами. Такой подход одинаково работает в браузере, терминале и инструментах WordPress, хотя команды установки и перезапуска Apache различаются в Linux, macOS и Windows.
Как Apache различает локальные сайты
Apache сначала выбирает виртуальный хост по имени из заголовка Host, а затем передаёт запрос обработчику PHP. Каждый блок VirtualHost содержит имя сервера, корневой каталог DocumentRoot и правила доступа. Для локального WordPress важно, чтобы ServerName точно совпадал с адресом из браузера и с параметрами сайта.
Правило первого совпадения имеет практическое значение: неудачно расположенный блок с ServerName localhost или широким именем может перехватывать запросы. Конфигурацию каждого проекта стоит хранить отдельно, подключать осознанно и перезагружать сервер только после проверки синтаксиса. Это также упрощает перенос настроек между рабочими машинами.
Именованные виртуальные хосты сохраняют привычный URL без номера порта. Схема остаётся понятной при добавлении нового проекта и позволяет применять единый набор инструментов для отладки, резервного копирования и автоматизированных проверок.
Подготовка среды и локальный DNS
Сначала нужно убедиться, что Apache установлен и работает с подходящей версией PHP. На Debian и Ubuntu обычно применяются команды apache2ctl, a2enmod и a2ensite; в macOS Homebrew используется httpd, а в Windows — httpd.exe. Расположение конфигурации и названия модулей немного различаются, поэтому команды следует сверять с установленной версией сервера.
Состояние Apache и список виртуальных хостов можно проверить следующими командами:
apache2ctl -v
apache2ctl -S
apache2ctl -t
Команда apache2ctl -S показывает фактически загруженные блоки, а apache2ctl -t проверяет ошибки синтаксиса до перезапуска. Если сервер запущен как служба Windows, аналогичные действия выполняются через httpd.exe -t и перезапуск службы Apache.
Затем локальный DNS сопоставляет тестовые домены с адресом сервера. В файле hosts на Linux и macOS добавляются строки 127.0.0.1 wp.test и 127.0.0.1 www.wp.test. В Windows этот же файл находится по пути C:\Windows\System32\drivers\etc\hosts и требует запуска редактора с правами администратора. После сохранения проверьте разрешение имени командой getent hosts wp.test или аналогичным средством операционной системы.
Конфигурация виртуального хоста
Создайте отдельный файл конфигурации для проекта. На Debian и Ubuntu его помещают в каталог sites-available, а затем активируют командой sudo a2ensite wp.test.conf. В macOS и Windows конфигурацию обычно добавляют в httpd-vhosts.conf или в файл, подключённый директивой Include.
Пример блока для WordPress выглядит так:
<VirtualHost 127.0.0.1:80>
ServerName wp.test
ServerAlias www.wp.test
DocumentRoot "/var/www/wordpress"
DirectoryIndex index.php index.html
<Directory "/var/www/wordpress">
Options -Indexes +FollowSymLinks
AllowOverride All
Require local
</Directory>
ErrorLog "/var/log/apache2/wp.test-error.log"
CustomLog "/var/log/apache2/wp.test-access.log" combined
</VirtualHost>
Пути к документам и журналам нужно заменить фактическими. Директива Options -Indexes запрещает просмотр листинга каталога, а AllowOverride All позволяет WordPress использовать .htaccess для постоянных ссылок. Параметр Require local ограничивает доступ клиентами самого компьютера.
После проверки apache2ctl -t перезагрузите Apache. На Debian и Ubuntu это выполняется командой sudo systemctl reload apache2. Открытие http://wp.test должно показать либо установленный WordPress, либо стандартную страницу проверки, если файлы темы ещё не размещены.
Несколько WordPress-проектов
Каждому независимому сайту лучше назначать собственное имя, корневой каталог и базу данных. Для второй локальной копии добавьте в hosts строку 127.0.0.1 shop.test, затем создайте отдельный блок VirtualHost с ServerName shop.test и другим DocumentRoot. Шаблонные правила Apache не заменяют конкретные пути.
Поддомены удобны для связанных ресурсов, например client.test, api.test и admin.test. При этом запись *.test в hosts не заменяет отдельные строки, поскольку системный файл разрешает конкретные имена, а не любые их варианты.
При выборе между несколькими конфигурациями полезно сравнивать сценарии использования, а не только названия. Такой подход показан в материале [Coolscan 4000 и 9000]: одинаковые внешние признаки нередко сопровождаются различающимися возможностями. Для Apache это означает учитывать домен, корень сайта, базу данных и параметры PHP каждого проекта.
База данных и настройки WordPress
Каждому виртуальному хосту желательно выделять отдельную базу данных и пользователя с ограниченными правами. Не используйте для локальной копии учётную запись с правами администратора сервера. В wp-config.php должны соответствовать данным, созданным в MySQL или MariaDB:
define('DB_NAME', 'wordpress_wp');
define('DB_USER', 'wp_user');
define('DB_PASSWORD', 'надежный_пароль');
define('DB_HOST', '127.0.0.1');
define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATE', '');
После копирования файлов WordPress укажите постоянные адреса сайта. Через WP-CLI это можно сделать командами wp option update siteurl 'http://wp.test' --path=/var/www/wordpress и wp option update home 'http://wp.test' --path=/var/www/wordpress. Значения siteurl и home должны совпадать с ServerName, иначе WordPress начнёт перенаправлять на другой домен.
Для параметров подключения и секретных ключей удобно использовать WP-CLI. Команда wp config create формирует wp-config.php, а wp config shuffle-salts заменяет значения AUTH_KEY, SECURE_AUTH_KEY и остальных солей. У каждой копии желательно собственные ключи, пароль базы данных и резервная копия каталога uploads.
Проверка и устранение ошибок
Команда apache2ctl -S помогает увидеть, какой виртуальный хост назначен адресу и не перекрывается ли он другим блоком. HTTP-запрос можно отправить напрямую через curl -I -H 'Host: wp.test' http://127.0.0.1/. Такой тест отделяет проблему разрешения домена от ошибки маршрутизации внутри Apache.
Код ответа 404 часто указывает на неверный DocumentRoot или отсутствие файлов, 403 — на права доступа и Require local, а 500 — на ошибку PHP и запись в журнал Apache. Полезно проверить занятый порт командой ss -ltnp, состояние модулей и последние строки проектного журнала ошибок. Браузерные расширения, прокси и кеш также способны подменять ответ сервера.
Для диагностики WordPress временно включайте отладочный режим через константы WP_DEBUG, WP_DEBUG_LOG и WP_DEBUG_DISPLAY. Значение WP_DEBUG_DISPLAY лучше оставить выключенным, чтобы ошибки не показывались посетителям, а подробности записывались в wp-content/debug.log. Постоянные ссылки требуют загруженного модуля rewrite и работающего AllowOverride All.
Безопасность локальной среды
Привязка виртуального хоста к 127.0.0.1 и правило Require local не позволяют соседним устройствам подключаться к тестовому сайту через сетевой интерфейс. Если проект должен быть доступен коллегам или контейнерам, адрес прослушивания и правила доступа изменяются намеренно и ограничиваются конкретными подсетями. Широкие права и режим chmod 777 не нужны.
Каталог проекта должен принадлежать пользователю или специально созданной группе, а Apache — получать минимальные необходимые права. Защищайте wp-config.php, не публикуйте резервные копии рядом с сайтом и храните рабочие данные отдельно от production-копий. Регулярно обновляйте WordPress, PHP и Apache, поскольку локальный сервер тоже может использоваться старыми уязвимыми компонентами.
Дополнительные меры безопасности важны для всей домашней инфраструктуры. В материале [защита домашней сети] разобраны риски перехвата данных, сетевых атак и небезопасных соединений. Для локального WordPress можно использовать локальный сертификат, созданный через mkcert, чтобы включить HTTPS без отключения проверки сертификатов. Привязка портов к адресу 127.0.0.1 предотвращает случайную публикацию сервера в локальной сети.
Настройте первый виртуальный хост: добавьте домен в hosts, создайте отдельный файл Apache, проверьте синтаксис и перезагрузите сервер. Затем перенесите второй проект на отдельный домен, подключите собственную базу данных и убедитесь, что siteurl, home и ServerName совпадают.
Сохраните проверенную конфигурацию как основу для следующих установок, зафиксируйте команды активации и документируйте пути к журналам. После этого переходите к полноценной локальной разработке WordPress с понятными адресами, изолированными данными и предсказуемым поведением Apache.