Установка с Git
Последнее обновление Mar 12th, 2021 | История страницы | Улучшить эту страницу | Сообщить о проблеме
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$287 per month—let's make that $500!
Learn moreУстановка MODX из git - отличный способ получить самую последнюю версию, а также она необходима, если вы планируете внести свой вклад в разработку MODX. Это требует на несколько шагов больше, чем при стандартной установке.
Процесс установки¶
Вам необходимо:
- получить файлы с GitHub
- установить зависимости composer
- собрать ядро
- запустить стандартную настройку
Каждый шаг подробно описывается ниже.
Получите файлы с GitHub¶
Склонируйте репозиторий Revolution на GitHub, используя следующий синтаксис:
Обратите внимание, что он предварительно выбирает ветку 3.x и устанавливается в каталог www, вы можете настроить его в соответствии с желаемой настройкой.
Или, если вы хотите внести свой вклад: сделайте форк modxcms/revolution в свою учетную запись GitHub, клонируйте этот репозиторий как "origin" и добавьте modxcms/revolution репозиторий как удаленный под названием "upstream":
Вы можете переключиться на другую ветку, используя git checkout <name-of-branch> или git checkout -b 3.x upstream/3.x
Установите зависимости с помощью Composer¶
MODX использует Composer для управления внутренними зависимостями, необходимыми для запуска 3.x.
Если в вашей системе еще не установлен Composer см. Инструкции по установке здесь. В приведенной ниже команде предполагается, что вы установили Composer глобально, например, запустив mv composer.phar /usr/local/bin/composer после инструкций по установке, указанных выше.
Запустите composer install в корне директории www.
Время от времени может потребоваться запускать composer update, чтобы быть в курсе последних обновлений.
Запускаем сборку¶
После того, как зависимости установлены, перейдите в папку _build и скопируйте туда файлы конфигурации.
Как правило, никаких изменений в эти файлы не требуется, но при необходимости вы можете изменить параметры подключения к базе данных.
Затем запустите php transport.core.php в папке _build:
Вы также можете запустить это из корня проекта как php _build/transport.core.php, если вы ранее создали файлы конфигурации.
Запустить установку¶
Теперь вы готовы выполнить стандартную настройку через браузер, например: http://localhost/setup/.
Убедитесь, что вы отметили оба параметра: «Основной пакет распакован вручную» и «Файлы уже на месте» при установке из Git. Обычно они предварительно выбираются за вас.
Продолжайте настройку, и все готово!
Обновление локального репозитория Git после фиксации¶
Выполните следующее, чтобы обновить локальный репозиторий git после коммитов.
Если вы клонировали прямо из modxcms/revolution, используйте origin:
Вы можете заменить 3.x любой другой веткой.
Может потребоваться запустить этап сборки и настройка после загрузки изменений.
Участие путем отправки Pull request¶
Если вы исправили ошибку или добавили улучшение, и вы работаете над форком репозитория Revolution, вы можете отправить запрос на перенос в MODX, который будет рассмотрен основными интеграторами.
См. Дополнительную информацию в разделе "Содействие".
Переключение веток¶
Если вы хотите переключиться на другую ветку (которую вы уже выполнили локально), просто введите эти команды:
Конечно, заменив 2.5.x фактическим именем ветки, на которую вы хотите переключиться. После того, как вы это сделаете, запустите сборку и снова запустите setup/, поскольку разные ветки могут иметь разные базы данных.
Обратное переключение не всегда рекомендуется, т.е. переключение с 2.x (последние функции в разработке для следующего второстепенного выпуска) на 2.5.x (последние исправления для следующего выпуска исправлений), поскольку изменения в базе данных не могут быть выполнены в обратном порядке. Хотя никаких серьезных проблем возникнуть не должно, будьте осторожны при этом или храните свою работу в отдельных базах данных для каждой ветви, над которой вы работаете.
Дополнительная информация¶
Альтернатива: использование create-project¶
Команда composer create-project будет клонировать, устанавливать зависимости и собирать ядро за один шаг.
Из родительского каталога, в который вы хотите установить MODX, выполните следующую команду, где your_directory - это каталог, в который вы хотите установить MODX. (Это также может быть . для установки в текущий пустой каталог.)
Если вы хотите указать git на свой форк, чтобы внести свой вклад в MODX:
-
git remote add upstream https://github.com/modxcms/revolution.git -
git remote set-url origin {your github repo url} - Также вам могут понадобиться:
git remote set-url --push origin {your github repo url}
Теперь перейдите к стандартной настройке, например: http://localhost/setup/ настроить и установить MODX.
DYLD ошибка с MAMP в Mac OS X¶
Если вы используете MAMP в Mac OS X, у вас могут возникнуть проблемы (ошибки о том, что библиотеки DYLD не включены) при попытке запустить transport.core.php из терминала. Это связано с тем, что библиотеки MAMP PHP по умолчанию не находятся в пути динамического компоновщика.
Чтобы настроить путь библиотеки динамического компоновщика для включения библиотек MAMP PHP, выполните следующую команду через терминал:
Затем вы можете выполнить transport.core.php, используя абсолютный путь к исполняемому файлу MAMP PHP:
Убедитесь, что php находится в вашем PATH¶
Если у вас возникли проблемы с запуском шагов composer или сборки, проверьте, есть ли PHP в вашем PATH, выполнив следующие действия:
Если у вас не получается что-то подобное, спросите кого-нибудь или Google, как это установить.
В некоторых локальных средах разработки (например, MAMP, XAMMP) вы также можете проверить, какую версию PHP вы используете.
Если это не возвращает ожидаемый путь, отредактируйте $PATH в вашем ~/.bash_profile или ~/.zshrc.
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$287 per month—let's make that $500!
Learn more