Установка MODX локально (на компьютер)
В данном руководстве разберем как установить MODX 3 локально (на компьютер) под управлением различных операционных систем: Windows, Linux, macOS при помощи XAMMP.
Что такое XAMPP?
XAMPP - одна из популярнейших сред для PHP разработки. Это кроссплатформенный дистрибутив, которорый помогает быстро превратить ваш ПК в локальный web-сервер.
XAMPP полностью бесплатный, имеет открытый исходный кодом и простой в установке дистрибутив Apache, содержащий в себе MariaDB, PHP и Perl.
Пошаговая установка MODX 3 на XAMPP
1. Скачиваем и устанавливаем Xammp
Актуальную версию установщика XAMPP можно скачать с официального сайта Apache Friends.
Скачиваете версию под свою операционную систему (Windows, Linux или OS X). После заррузки, запускаетете установочный файл и следуете шагам установщика.
Процесс установки описывать не будем, так как он идентичен установке других программ в вашей операционной системе. По факту вам только нужно нажимать по кнопке "Next".
Примечание 1. На шаге выбора компонентов можно оставить только MySQL и PhpMyAdmin - этого будет достаточно для установки MODX 3.
Примечание 2: Если ваша операционная система Windows 7 и выше, то во время установки скорее всего будут вылетать различные окна от Контроля учетных записей и Защитника Windows - вам нужно все разрешать.
Сопуствующие материалы по установке XAMPP (если что то пошло не так):
- Подробный процесс установки XAMPP на Windows и решение всевозможных проблем (ru).
- Официальные ответы на часто задаваемые вопросы по XAMMP (en) для: Linux, Windows, OS X.
2. Проверяем работоспособность сервера
Для установки MODX на XAMPP необходимо запустить два модуля:
- Apache.
- MySQL.
Сделать это можно из панели управления (Control Panel), нажав на кнопку «Start»:
Если все хорошо, то данные модуля позеленеют:
Теперь можно протестировать работу локального сервера, перейдя в браузере по адресу: http://localhost/
. Должна открыться вот такая страница.
Теперь можно установить на сервер CMS MODX.
3. Создаем локальный домен и заливаем на него MODX
Перейдите в папку установки сервера (обычно это C:\xampp), можно нажать в Control Panel по кнопке "Explorer" и вы туда попадете.
Найдите там в папку htdocs и перейдите в нее. В нутри htdocs, создайте локальный домен (получается обычную папку) с именем например modx3.local.
Теперь в только что созданную директорию (локальный домен), необходимо загрузить файлы MODX. Для этого перейдите на страницу загрузки MODX и скачайте "Пакет расширенной установки (Advanced)", в отличии от "традиционного пакета", данный пакет имеет меньший вес и пару дополнительных шагов, при помощи которых можно повысить безопасность MODX.
Распакуйте архив, увидите 2 папки Core и Setup, скопируйте (или вырежете /переместите) их в папку modx3.local, в конечном итоге должно получиться следующее.
Распаковать архив обычно можно встроенными функциями, либо при помощи программы- архиватора, один из лучших бесплатных кроссплатформенных архиваторов 7-zip (есть версии для Windows, Linux или MAC OS).
4. Создаем Базу данных и пользователя.
Для того чтобы создать базу данных и пользователя к ней в Панеле управления сервера, напротив пункта MySQL щелкните по кнопке Admin
В браузере откроется страница PhpMyAdmin (находится по адресу http://localhost/phpmyadmin/). В верхнем меню перейдите во вкладку "Учетные записи пользователей". На открывшейся странице щелкните на "Добавить учетную запись пользователя".
На открывшейся странице, заполняем:
- Имя пользователя: любое, например: modx3local.
- Имя хоста: выбирайте локальный, должно подставится значение: localhost.
- Пароль: любой, но желательно посложнее, лучше всего воспользоваться генератором паролей.
Обязательно запишите логин и пароль.
Далее в разделе "База данных для учетных записей пользователей", ставим галки на против пунктов: "Создать базу данных с таким же именем и предоставить на неё все привилегии." и "Предоставить все привилегии на то, что подпадает под шаблон (имя пользователя\_%)."
И в разделе "Глобальные привилегии" жмем чекбокс на против пункта "Отметить все"
И в самом низу жмем по кнопке "Вперед", после чего phpMyAdmin создаст БД, пользователя и назначит пользователя администартором этой базы.
5. Устанавливаем MODX
Запускаем установщик модекса, для этого нужно перейти по адресу http://localhost/modx3.local/setup/
Примечание: хотите избавиться от localhost/ в адресе (как у меня на скрине ниже), необходимо настроить виртуальный хост (домен).
Если все хорошо, то сразу откроется установщик MODX, с выбором языка. В моем случае появились ошибки - Установка MODX не может быть продолжена:
Не хватает 2х php расширений: gd и zip, как их включить читаем здесь: XAMPP. Как установить / включить GD и ZIP. После этого перезагружаем страницу, и видим установщик.
Выбираем нужный язык и жмем Далее.
В следующем окне: Ключ конфигурации сайта осталяем все как есть и жмем Далее.
Откроется страница с параметрами установки, выбираем новая установка.
А ниже в дополнительных параметрах убираем галку с пункта "Отправлять заголовок X-Powered-By" и жмем далее
На следующем шаге указываем сведения о подключении к базе данных:
- Тип базы данных: mysql
- Сервер базы данных: localhost
- Имя базы данных: modx3local
- Имя пользователя базы данных: modx3local
- Пароль пользователя базы данных: пароль который указали (или сгенерили) при создании пользователя.
- Префикс таблиц: рекомендую заменить стандартный префикс modx_, на что то более сложное, например: yfMSG_.
И жмем тест.
Если все прошло успешно, выбираем кодировку подключения: utf8mb4 и сопоставление: utf8mb4_0900_ai_ci и жмем Тест.
После этого заполняем данные администратора по умолчанию:
- Электронная почта администратора: любая, но желательно рабочая (поможет восстановить пароль от админки, если вы его забудите).
- Логин администратора: любой, единственное не рекомендую и спользовать стандартное типа admin.
- Пароль администратора: любой, но желательно посложнее, рекомендую воспользоваться онлайн генератором паролей.
- Подтвердите пароль: еще раз вводите туда пароль. Не забудьте его записать (это пароль для входа в админку).
- Жмем далее.
На следующей странице: Установка контекста, оставляем все как есть и жмем Далее.
После чего вы должны увидеть Отчёт об установке, что все предустановочные тесты прошли успешно.
Если все ок, Жмем далее и видим отчет об установке ядра.
Все, ок, жмем далее. После чего увидите страницу: Благодарим вас за установку MODX Revolution.
Жмем по кнопке Войти и попадаем на страницу входа в административную панель.
Все MODX успешно установлен, чтобы попасть в админку вводите Имя пользователя, пароль и жмете по кнопке Войти.