Среды разработки

Если вы пишете исправления или функции для ядра MODX Revolution, работайте в локальном клоне своего форка. Если собираете Extras на обычной установке сайта, смотрите Настройка среды разработки.

Нужен рабочий локальный веб-сервер. Эта страница не описывает MAMP, XAMPP, Docker или нативный стек. Сверьтесь с требованиями к серверу для целевой ветки (для 3.x — PHP 8.1+ и Composer).

Многие держат отдельные клоны для активных веток (например 3.x и старая maintenance-линия), чтобы не пересобирать окружение при смене задачи.

Шаг 1: подготовьте форк¶

Нажмите Fork в официальном репозитории и создайте форк в своём аккаунте GitHub, если его ещё нет.

Коммиты идут в ваш форк. В официальный репозиторий вы отправляете pull request.

Шаг 2: установите MODX из форка¶

Следуйте установке из git. Клонируйте URL вашего форка (не modxcms/revolution как origin), запустите Composer, соберите core-пакет и пройдите Setup.

Шаг 3: добавьте remote upstream¶

Чтобы подтягивать коммиты из официального репозитория:

git remote add upstream https://github.com/modxcms/revolution.git

Дальше git fetch upstream и обновляйте ветку через merge или rebase, как принято в вашем процессе.

Шаг 4: настройте MODX под работу с ядром¶

1. Отключите cache_lexicon_topics, чтобы правки лексикона были видны сразу.
2. Задайте уникальный session_name, если на одном хосте несколько локальных установок MODX.
3. После правок PHP ядра или лексикона очищайте core/cache/ (или «Управление → Очистить кэш») перед повторной проверкой.

Прочие инструменты¶

Многие разработчики MODX используют PhpStorm как IDE. GitHub CLI удобен, если вы часто открываете pull request.

Сборка assets и тесты — в разделе инструменты.