Виртуальные хосты 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.

Иконка пользователя в серых тонах

Настройка Windows

Доступ к скрытым параметрам конфигурации, отключение телеметрии, работа с диспетчером задач и тонкая настройка меню «Пуск» в стиле Windows XP для Windows 7.

Иконка браузера в серо-синих тонах

Веб-браузеры

Скрытые страницы конфигурации в Firefox, Chrome и Opera, быстрый текстовый редактор прямо в браузере, эффект Lightbox JS для изображений и настройка внешнего вида Firefox.

Иконка папки в нейтральных серых тонах

WordPress и блоги

Выполнение PHP-кода в текстовых виджетах, диагностика времени загрузки разделов страницы, правильная очистка блога и условная загрузка виджетов социальных сетей.

Изометрический 3D-рендер: светлый веб-сайт с серо-голубым заголовком, парящий над чистой белой поверхностью Изометрический 3D-рендер: тёмно-серая иконка социального букмаркинга на светлом фоне

Обратная связь

Есть вопрос или предложение по темам блога? Напишите — автор на связи.