Локальная разработка WordPress: wp-env и безопасный старт проекта

Для работы с AI-агентом не давайте ему экспериментировать на опубликованном WordPress-сайте. Начните с локальной копии проекта: отдельные исходники темы или плагина, тестовая база и понятный способ запустить WordPress заново. Один из официально поддерживаемых вариантов — wp-env.

1. Выберите подходящую среду

Если вы не разработчик, можно начать с WordPress Studio, Local или другой знакомой локальной сборки. Для воспроизводимого окружения с тестами удобен @wordpress/env. Он использует Docker; потребуются Docker и Node.js. Для обычной настройки сайта через админку Docker необязателен.

2. Подготовьте репозиторий

Храните собственный плагин или тему отдельной папкой. Не добавляйте в Git секреты, wp-config.php, экспорт реальной базы или пользовательские загрузки. Если уже есть архитектура продукта, согласуйте её с текущей структурой файлов.

Для плагина в корне проекта достаточно конфигурации:

{
  "$schema": "https://schemas.wp.org/trunk/wp-env.json",
  "plugins": ["."]
}

Этот вариант подходит папке готового WordPress-плагина. Для темы используйте документированное поле themes; не копируйте настройки плагина вслепую.

3. Запустите WordPress локально

npm install --global @wordpress/env
wp-env start

Команды требуют заранее установленного и запущенного Docker. По умолчанию wp-env поднимает локальный адрес http://localhost:8888; порт можно изменить, если он занят. Фактический URL смотрите в выводе команды. Стартовая установка создаётся для разработки, а не для публичного доступа.

4. Добавьте проверочные данные

Создайте тестового редактора, пару записей и типовую ошибку ввода. Не переносите персональные данные клиентов. Проверьте нужные версии PHP и WordPress в настройках среды; зафиксируйте их в документации проекта.

Перед разработкой попробуйте остановить и запустить среду повторно, убедитесь, что исходники доступны, а сайт открывается. Если Docker не стартует, сначала исправьте окружение — AI-агент не должен маскировать инфраструктурные проблемы изменением PHP-файлов.

5. Дайте агенту границы

Опишите, где находится код, какие файлы можно менять, где тесты, какие команды разрешены и что нельзя выполнять автоматически (удалять данные, обновлять production, читать реальные секреты). Примерные правила можно оформить в AGENTS.md; если уже есть такой файл, обновите его под фактический проект.

Результат для маршрута MVP

## 10-ENVIRONMENT
- Репозиторий/папка проекта:
- Тема или плагин:
- Версии WordPress/PHP/Node:
- Команда запуска:
- Локальный адрес:
- Как создать тестовые данные:
- Какие секреты исключены из репозитория:
- Команда/процедура остановки:
- Что проверено вручную:

Критерий готовности

Человек, получивший репозиторий и документ, может поднять локальный WordPress, не имея доступов к production. Следующим шагом настройте Git-процесс разработки.

Источник: https://developer.wordpress.org/block-editor/getting-started/devenv/get-started-with-wp-env/

Материал был полезен?

Помогите нам сделать материалы точнее и понятнее.