Базовая установка
Инструкция по базовой установке MODx Revolution.

Оглавление
Начальная настройка
После того как вы скачали установочный пакет MODx Revolution обычной (Traditional) версии, загрузите .zip архив на свой сервер. Далее необходимо распаковать архив с файлами на вашем сервере. Скопируйте или переместите все файлы в новом извлеченном каталоге версии MODx в каталог, в который вы хотите установить MODx. Вы можете удалить извлеченную папку и ее содержимое, а также ZIP-файл MODx после завершения установки.
Вы можете установить MODx в любой каталог по вашему желанию, хотя установка в корневой каталог обычно предпочтительнее для большинства рабочих сайтов.
Использование FTP для копирования распакованных файлов на сервер может привести к повреждению или неполной передаче, что скорее всего повлечет за собой ошибки во время установки системы и невозможность работать с ней в дальнейшем.
Помимо прочего, копирование файлов через FTP крайне долгий процесс. Лучше всего заливать файлы на сервер в ZIP-архиве, и распаковывать их уже непосредственно на сервере, с помощью утилит хостинг-провайдера.
Установка MODx в корневой каталог на чистом сайте
Является наиболее предпочтительным вариантов установки MODx. Однако в случае если ваш сайт только разрабатывается, необходимо заранее закрыть его от индексации и скрыть от прямого доступа "лишних глаз". Данный вариант лучше всего использовать, если ваш сайт уже готов к продакшену.
Установка MODx на поддомен
Наряду с предыдущим вариантом, так же является предпочтительным. Идеально подходит для разработки сайтов. Например, разместив сайт на поддомене dev
, можно вести разработку основного сайта именно на нем, не затрагивая при этом работу основного сайта. После завершения разработки, на поддомене dev.
можно прописать редирект в файле .htaccess
. Это нужно на тот случай, если пользователь вдруг попадет на поддомен dev
.
Пример редиректа:
# Редирект с поддомена, без явного указания имени поддомена
RewriteCond %{HTTP_HOST} ^(.+).example.com$
RewriteRule (.*) http://example.com/$1 [L,R=301,QSA]
# Редирект с поддомена, с явным указанием имени поддомена
RewriteCond %{HTTP_HOST} ^dev.example.com$ [NC]
RewriteRule (.*) http://example.com/$1 [L,R=301,QSA]
Установка MODx в подкаталог
Разработка сайтов часто начинается в подкаталоге, а затем по завершению, сайт перемещается в корневой каталог. Метод подкаталога полезен, если у вас есть существующий сайт, который должен оставаться доступным для пользователей во время разработки. Также можно оставить MODX в подкаталоге и использовать .htaccess
редиректы, чтобы переписать ваши URL-адреса в корень.
Установка MODx рядом с существующим статическим HTML-сайтом
Если ваш существующий рабочий сайт является статическим html с index.html
или подобной стартовой страницей в корне, вы можете установить MODx в корневую папку рядом со статическим сайтом на время разработки. Когда вы будете готовы начать работу с MODx, переименуйте или переместите ваши статические HTML-файлы, и MODx начнет работать вместо вашего старого html сайта.
Не включайте Friendly URL при использовании этого метода до тех пор, пока ваши HTML-файлы не будут перемещены или переименованы. Ну и обязательно сделайте резервную копию существующего сайта перед установкой MODx Revolution или внесением каких-либо изменений в текущую файловую структуру.
Установка MODx рядом с существующим динамическим сайтом под управлением любой CMS
Не устанавливайте MODx Revolution в каталог, в котором работает другой динамический сайт (под управлением CMS), пока этот сайт не будет удален. Используйте, например, метод подкаталога для разработки MODx в этом случае.
Наиболее безопасными, удобными и практичными способами установки MODx Revolution являются:
Установка MODx Revolution
Переходим к процессу установки. В веб-браузере обращаемся к имени вашего сайта и запускаем скрипт установки, дописав /setup
.
Пример:
http://example.com/setup/
Перед запуском установки убедитесь, что ваши каталоги core/cache/ и core/config/ доступны для записи в PHP.
После этого, вам будет представлен экран с некоторыми опциями установки:
Выбор языка Backend админ-панели MODx.
Теперь необходимо выбрать вариант установки и задать права каталогам и файлам.
- Новая установка - если вы устанавливаете новый сайт, необходимо выбрать данный пункт.
- Обновление существующей установки - если вы повредили файлы системы и вам нужно обновить сайт до новой версии, используйте данный пункт.
- Расширенное обновление - детальное описание можете увидеть на скриншоте. Это необходимо в крайне редких случаях.
Продолжаем настройку на этой же странице. Теперь нам необходимо задать права для новых каталогов и файлах. Можете оставить по умолчанию. Так же рекомендую снять галочку с пункта "Отправлять заголовок X-Powered-By". Это необходимо для дополнительной безопасности вашего сайта.
Когда закончите настройки - нажимаем кнопку «Далее».
Параметры базы данных
Теперь вам необходимо ввести параметры соединения с вашей базой данных.
Вам необходимо создать новую базу данных и пользователя до этого шага. Убедитесь, что пользователь вашей базы данных связан с новой базой данных, и ему предоставлено разрешение на все привилегии для этой базы данных.
- Сервер базы данных - Укажите имя хоста, которое является URL-адресом, по которому находится ваша база данных. Для большинства пользователей это будет «localhost».
- Имя пользователя базы данных - Ваше имя пользователя может также иметь префикс с тем же именем каталога, что и имя владельца сайта. Если это так, то укажите префикс вашего имени пользователя. Например - siteOwner_databaseUserName.
- Пароль пользователя базы данных - Укажите пароль пользователя базы данных.
- Имя базы данных - Введите имя пользователя вашей базы данных. На большинстве хостах вашему имени пользователя базы данных предшествует имя каталога владельца сайта, например siteOwner_modxDatabase. В этом случае необходимо ввести полное имя базы данных.
- Префикс таблиц - Вы можете указать другой префикс таблиц базы данных. MODx создаст таблицы с этим префикс-значением. Это полезно, если вы хотите сделать несколько установок MODx в одной базе данных. Кроме того, это увеличивает безопасность вашего сайта.
По завершении установок параметров, нажмите ссылку «Проверить соединение с сервером базы данных и отобразить список доступных сопоставлений.». Если у вас есть какие-либо ошибки, они будут показаны ниже. Если у вас есть ошибки, проверьте правильность имени пользователя и пароля вашей базы данных. Кроме того, если у вашего пользователя может не быть доступа к созданию базы данных.
Заметки по работе с MySQL
Если вы используете свой сервер MySQL с отключенной сетью, вы можете указать имя сокета следующим образом: unix_socket=MySQL.
Заметки по работе с Microsoft SQL Server
Поддержка Microsoft SQL Server была представлена в MODX Revolution 2.1
В зависимости от конфигурации вашего SQL сервера, вы можете указать свой хост по-разному.
- Named pipe: (local)/SQLEXPRESS
- Tcp/ip: 127.0.0.1,2301 (IP, port)
Когда закончите настройки - нажимаем кнопку «Далее».
Кодировки и сопоставления
Появляется другая форма для настройки кодировки и сопоставления вашей базы данных:
Большинство пользователей могут оставить эти значения такими, какие они есть. Однако, если вам нужно изменить их, убедитесь, что сопоставление соответствует кодировке.
Нажимайте «Попытка создания или выборки из базы данных». Если все прошло удачно, для вас должна отобразиться следующая часть установки MODx.
Заметки по работе с Microsoft SQL Server
MODX был протестирован только с набором символов SQL Server Latin1.
Создание пользователя-администратора
Эта форма имеет несколько полей для настройки администратора вашего сайта. Данный пользователь будет иметь все возможные права (sudo). Укажите данные пользователя, которые вы хотите использовать для главного администратора вашего сайта.
MODx рекомендует не использовать значения «admin» в причинам безопасности. Создавайте надежные данные пользователя.
Конфигурации некоторых хост-серверов не позволяют MODx отправлять электронные письма, если электронная почта в системной настройке MODx с ключом emailsender (значение устанавливается автоматически, при вводе email в данных администратора, в предыдущем пункте данной документации) недопустима для текущего домена сайта.
Если MODx не отправляет электронные письма с регистрацией или формой, проверьте отправителя электронной почты и установите для него действительный адрес электронной почты для текущего домена сайта.
Нажмите «Далее», когда закончите ввод данных.
Проверка перед установкой
Далее MODx сообщит вам, если какие-либо ошибки произошли во время установки, и предложит вам попытаться переустановить систему. Если напротив всех пунктов зеленое значение, значит все прошло хорошо.
Когда установка будет успешной, нажмите «Далее», чтобы продолжить установку. Далее вам будет представлен последний шаг.
Успешная установка
Теперь можете просмотреть отчет об установке MODx.
MODx рекомендует обязательно удалить каталог /setup/
после успешной установки, чтобы защитить ваш сайт от всех злоумышленников. Вы можете сделать это, выделив чекбокс под кнопкой Войти.
ВНИМАНИЕ: установочный пакет представляет из себя очень мощный контроль над вашим сервером. НЕ оставляйте его на хостинге после завершения установки MODx. Лучшим решением будет - его удаление.
Когда все будет готово, нажмите «Войти», чтобы увидеть форму входа в интерфейса админ-панели.
На этом установка базовой версии MODx завершена!
Время запросов: 1,9203 s
Количество запросов: 24
Источник: cache