Сайт на modx с нуля: Создание сайта на MODX Revolution: Каким проектам подходит

Для тех, кому нужна краткая информация:

1. Установите MODX на новый сервер.
2. Скопировать все файлы. Исключите папки: коннекторы, менеджер и ядро. Включите вложенные папки core/components и core/packages. Исключить файлы: index.php и config.core.php.
3. Экспорт полной БД и вставка в новую установку.

Теперь давайте углубимся в «почему» и «как».

Требования

Как минимум, вам потребуются следующие 3 вещи для перемещения сайта MODX:

1.

У вас должна быть либо возможность экспортировать всю базу данных MODX, либо ранее экспортированная БД файл (при условии, что он соответствует данным, которые вы хотите перенести).

Экспорт должен включать операторы «удаления таблицы», а также структуру и данные каждой таблицы MODX, за возможным исключением таблицы modx_session. Во многих случаях вам не нужно/не хочется перемещать эту таблицу. Если он есть в вашем импорте — не волнуйтесь. Миграция по-прежнему должна работать нормально, за исключением того, что у пользователей могут быть устаревшие или недействительные сеансы на перенесенном сайте, и в этом случае вам следует сбросить сеансы после завершения миграции.

2. Файлы

Вам нужен доступ для извлечения файлов сайта на текущем сервере. Предпочтительно, чтобы у вас были права на архивирование (например, zip или tar) этих файлов, что избавит вас от всевозможных головных болей во время перемещения, но если нет, то доступ по (S)FTP минимально допустим.

Представьте, каково было бы перевезти свой дом, но без ящиков. Относительное удобство ящиков в данном случае примерно такое же, как у файловых архивов, в перемещении сайта.

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

3. Новая установка MODX

Вам необходимо установить MODX на целевом сервере той же версии, что и та, с которой вы перемещаетесь. Например, попытка перенести сайт 2.2.16 на сайт 2.4.0 может вызвать проблемы.

«Почему я не могу просто переместить все основные файлы MODX вместе с файлами, специфичными для сайта, со старого сервера на новый?» ~ Что все, вероятно, думают

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

Эта штука «Переносимость данных» — рекомендации по передовой практике разработки MODX

По сути, все сводится к тому, что при создании сайта MODX вы никогда не должны модифицировать ядро ​​— это известно как «взлом ядра». . МОДКС очень гибкая и спроектирована с возможностью расширения, так что вы можете построить что угодно , не прибегая к основным хакам.

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

Итак, идея такова: переместите данные и оставьте программное обеспечение MODX в покое. Продолжая аналогию, перевезти содержимое вашего дома в новый дом проще, чем перевезти сам дом.

The Four Folders

MODX устанавливается со следующими папками:

1. core/
2. активы/
3. менеджер/
4. разъемы/

Примечание: имена и расположение этих папок можно изменить, но всегда будет 4 папки, выполняющие эти функции, за исключением редкого случая, когда папка `manager/` в целях безопасности развернута в отдельной среде.

Если ваш сайт MODX соответствует соглашению, то все ресурсы вашего сайта, такие как CSS, JS и изображения, будут находиться в папке assets/, поэтому, естественно, вы захотите перенести эту папку.

Если у вас есть активы, изображения или что-то еще в других местах, например изображения / или шаблон /, вы также можете переместить их. Вывод здесь заключается в том, что вам не нужно перемещать любые из 4 других папок, установленных вместе с MODX, со следующими исключениями:

1. ядро/компоненты/
2. ядро/упаковки/

Это подпапки внутри папки core/. Вы не хотите всю папку core/ , только эти две подпапки в ней. Эти 2 подпапки содержат логику для ваших установленных дополнений — дополнительных компонентов, которые расширяют функциональность основного программного обеспечения MODX.

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

Два файла

Нередко корень документа сайта MODX заполняется специфическими для сайта файлами по мере того, как пользователи загружают изображения и тому подобное. Хотя вопреки передовой практике, это распространенная проблема.

Это не критическая проблема — просто перенесите все файлы в корень веб-сайта, кроме:

1. config.core.php
2. index.php

Это основные файлы, которые, если они будут перезаписаны в вашей новой «целевой» установке, почти наверняка вызовут проблемы, особенно первый.

Также следите за файлами конфигурации сервера, такими как .htaccess . Они могут нормально мигрировать, но в зависимости от ситуации они также могут вызывать проблемы. Настройка сервера выходит за рамки этой статьи.

Обзор

Давайте еще раз рассмотрим приведенные выше принципы:

1. Начните с новой «целевой» установки на целевом сервере, убедившись, что ее версия совпадает с существующей.
2. Переместить содержимое дома, а не сам дом. В MODX это означает все файлы, кроме основных папок, как описано выше, и двух основных файлов.
3. Экспорт базы данных MODX и импорт в базу данных «целевой» установки.

В подавляющем большинстве случаев это работает без проблем.

Метод , который вы используете для упаковки файлов, не имеет значения. Вы можете использовать git и добавить файлы и папки, упомянутые выше, в свой .gitignore .

В MODX Cloud есть функция «Снимок», которая переносит сайт MODX с одного виртуального сервера на другой, и это именно то, что делает технология упаковки. Снапшоты успешно использовались много тысяч раз.

Технология моментальных снимков также доступна через инструмент командной строки с открытым исходным кодом под названием Teleport. Вы можете использовать это на любом сервере, соответствующем минимальным требованиям Teleport.

Я лично переносил сайты MODX сотни раз, вручную выбирая файлы для упаковки, используя вышеуказанные принципы. Я редко сталкиваюсь с проблемами. Другие члены основной команды MODX делают то же самое.

Принципы работают независимо от метода. Тем не менее, есть крайние случаи, которые требуют устранения неполадок.

Устранение неполадок

Префикс базы данных

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

Вы делаете это, подключаясь к базе данных с помощью клиента, такого как phpMyAdmin или Sequel Pro. Если есть два набора таблиц MODX, каждый из которых использует свой префикс, вам необходимо настроить новую установку для использования префикса ваших импортированных таблиц.

Вы можете сделать это, отредактировав основной файл конфигурации MODX, который находится в подпапке вашей основной папки по адресу: core/config/config.inc.php .

Примечание: если «ключ конфигурации» был настроен во время установки, файл будет называться по-другому: core/config/{$config_key}. inc.php . Также возможно, что имя и расположение папки core/ могут быть изменены.

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

Пути

Если вы установили MODX с нуля на целевой сервер перед миграцией, у вас не должно возникнуть проблем с путями. В редких случаях Extra может иметь неверную конфигурацию пути. Если это дополнение включает критически важный плагин, ваш сайт может показаться неработоспособным.

Другим случаем может быть то, что сайт был обновлен с очень старой версии MODX, или, что еще хуже, все еще находится на очень старой версии (2.1.x или старше). В этих старых версиях в базе данных есть жестко закодированный путь.

В любом из этих случаев найдите в базе данных в таблице system_settings и таблице workspaces жестко запрограммированные пути и измените их для новой среды.

Если на вашем сайте все еще используется очень старая версия MODX, невозможно переоценить важность немедленного обновления для вас. По мере старения программного обеспечения — любого программного обеспечения, созданного любым поставщиком — оно становится уязвимым. Запуская старое программное обеспечение, вы отправляете открытое приглашение злоумышленникам.

Core Hacks

В редких случаях вы можете попытаться перенести сайт MODX, содержащий модификации файлов ядра.

Существует три типа этих сценариев:

1. Сайт использует пользовательскую тему менеджера. Это можно исправить путем переноса любых подпапок не по умолчанию в папках manager/templates/ и manager/controllers/.
2. Установленный Extra развертывает файлы в одной из основных папок, например внутри менеджер/ . Это можно относительно легко исправить, переустановив Extra с помощью установщика Extras внутри MODX Manager. Однако в этом случае сообщите автору дополнения о том, что его/ее развертывание влияет на переносимость данных, или сообщите нам, и мы постараемся связаться с ним.
3. Первоначальный разработчик не понимал архитектуру и расширяемость MODX, поэтому модифицировал некоторые файлы ядра, без необходимости нарушая переносимость данных, а также путь обновления. Исправление такого сайта выходит за рамки этой статьи, но если это ваш случай, команда MODX может помочь.

Подведение итогов

Принципы, описанные здесь, проверены и верны — проверены в бою и почти ежедневно используются основной командой MODX. Мы знаем, что это работает.

Тем не менее, редко существует только один «правильный» способ что-то делать. Если у вас есть какие-либо советы или рекомендации по переносу сайта MODX, поделитесь ими в комментариях.

Сообщество MODX

Загрузка