Урок 2. Установка MODx Revolution

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

Существует 3 способа установки MODX Revolution – базовая, продвинутая и установка из Git. В этом уроке мы рассмотрим базовую установку на локальном хостинге, что есть более чем достаточно. Я буду устанавливать сайт на локальный хостинг и буду использовать в качестве сервера - openserver.

Для виртуального хостинга рекомендую использовать Хостинг Hostia.ru

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

1. Загрузка MODX и размещение его на сервере (локальном или удаленном)

Мы начнем с загрузки архива установки MODX, который можно найти и скачать по ссылке http://modx.com/download/.

Ко времени написания этого урока текущей версией являлась MODX Revolution 2.2.5-pl. Вы можете загрузить нормальный или продвинутый пакет для установки. Я буду работать с нормальным пакетом.

Продвинутый пакет может понадобиться, например, если у вас используется ISP manager и поэтому site.com/manager/ уже зарезервирован, то вам нужно будет прописать менеджер MODX в другой адрес...

Мы загрузим эти файлы в нашу рабочую среду. Есть два способа сделать это:

  • Распаковать файлы и залить их, используя FTP
  • Залить zip файл архива и разархивировать прямо на сервере

Я предпочитаю второй способ, так как он действует намного быстрее.

После проверки загруженных файлов структура ваших директорий должна выглядить приблизительно так:

Установка MODX. Структура файлов перед установкой

Вы можете почитать больше про структуру директорий в официальной документации (см. ссылки в конце записи).

2. Создание базы и пользователя базы

Мы залили наши файлы и готовы к продолжению. Следующий шаг — создание базы и пользователя базы. Как вы это сделаете — зависит от вашего хостинга и панели управления, а также инструментов, которые есть у вас в наличии. Если вы не уверены в том как это сделать, то свяжитесь с техпомощью вашего хостера либо поищите данную инфо в интернете.

Я перейду в инструмент моего openserver'а - PhpMyAdmin

PhpMyAdmin openserver

и создам базу данных modxws:

Создание БД в Phpmyadmin

сообщение об успехе создания базы:

БД успешно создана

Убедитесь в том, что права пользователя созданной вами базы имеет все привилегии доступа к базе данных. В openserver можно использовать запись root или создать своего пользователя, назначить ему пароль и ввести данные при установке. Давайте создадим своего пользователя myuser и назначим ему пароль:

Создание пользователя БД

Запишите имя базы данных и пользователя, а также его пароль — всё это понадобится на следующем этапе.

Некоторые хостеры добавляют префиксы для имен баз данных и/или пользователей, поэтому не ошибитесь в написании имени пользователя и базы данных.

При создании базы ее кодировку и сопоставление необходимо установить utf8 и utf_general_ci соответственно. Это можно сделать с помощью phpmyadmin либо тем инструментом, который предлагает вам ваш хостер:

Сравнение БД utf8_general_ci

3. Установка MODX Revolution

После загрузки файлов и создания базы и пользователя, перейдем к установке. В адресной строке браузера наберитеhttp://your_site_url/setup, где your_site_url – адрес вашего сайта и вы увидите следующую картинку:

Сразу при установке MODX Revolution, может возникнуть ошибка FATAL ERROR: MODx Setup cannot continue. To use PHP 5.3.0+, you must set the date.timezone setting in your php.ini. Please do set it to a proper timezone before proceeding. A list can be found here.

Решение - поменять хостинг на другой, например Hostia.ru (испытанный мной самый удобный из 4-5 хостингов для MODX) или сделать изменения в своём setup/index.php файле - вставить строку сразу же после <?php:

@ini_set('date.timezone', 'Moscow/Europe');

3.1 Выбор языка

Выбор языка при установке MODX Revolution

Выберите ваш язык из выпадающего списка и продолжите установку:

Продолжение установки MODX Revolution

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

3.2 Выбор типа установки

Выбор типа установки

На этом этапе у нас есть возможность выбрать тип нужной нам установки. Так как мы делаем новый сайт, то мы выбираем вариант New Installation. Если мы обновляемся с предыдущей версии Revolution, то тогда мы бы использовали вариант Upgrade. Если вам нужно, то можете поменять права доступа к каталогам в разделе Advanced Options, но для большинства установок годится вариант по умолчанию.

3.3 Соединение с сервером баз данных и определение соответствий

На следующем этапе MODX нужно присоединить к созданной базе данных.

  • В первом поле Database host выставлено по умолчанию localhost и в большинстве случаев это поле не нужно менять, только если ваш хостер может потребовать иные настройки. В нашем случае нужно поменять это значение на openserver: openserver
  • В поле Database login введите имя пользователя баз данных, которого вы создали и не забудьте добавить префикс, если (как я уже упомянул выше) этот префикс добавил хостер.
  • Введите пароль пользователя баз данных в поле Database password.
  • Имя базы данных, которую вы создали записываем в поле Database name и не забываем про префикс, если таковой имеется.
  • Последнее поле Table prefix, который по умолчанию установлен в modx_. Вы можете поменять, если хотите на какой-либо другой, но обычно в этом нет необходимости.

После нажатия на “Test database server connection and view collations”, установщик MODX попробует соединится в вашей базой данных и определить соответствия базы. Если вы всё сделали правильно, то появится сообщение об успехе установки, которое показывает, что соединение с сервером баз данных было успешным и соответствия установлены.

Соединение с базой

Теперь установщику необходимо протестировать (либо создать) настройки базы. Вы заметили , что установщик также может создавать базу данных, но не все сервера позволят вам сделать это, поэтому я предпочитаю вначале создавать базу, а лишь потом в процесе установки присоединять ее. Если мы нажмем “Create or test selection of your database”  у нас появится сообщение об успехе, о том, что база найдена, теперь можем приступить к созданию администратора и продолжить установку.

3.4 Создание администратора

Создание администратора

3.5 Предустановочные тесты и установка

После того, как вы ввели информацию о пользователя и нажали Next начинается предустановочное тестирование. На этом этапе установщик MODX проверяет правильно ли настроен сервер для запуска Revolution. Если всё в порядке, вы увидите зеленые сообщеник ОК на каждой странице. Если возникнут какие-либо проблемы, они будут показаны красным цветом и вам необходимо будет их решить перед продолжением работы.

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

Будем считать, что у нас всё прошло гладко и нажимаем дальше кнопку Install

Установка должна пройти успешно и мы получим сообщение о том, что ядро установлено. Вы можете просмотреть лог установки либо сообщения о проблемах нажав на ссылки Toggle success message или Toggle warnings.

Сообщения об удачной установке MODX Revolution

Далее нажимаем кнопку Next для завершения установки.

3.6 Завершение установки.

Установка MODX Revolution прошла успешно

Финальным этапом установки является напоминание нам о том, что необходимо удалить папку установки Setup. Рекомендуется это сделать из соображений безопасности, так как любой пользователь может снова запустить установку вашего сата. Поэтому ставим галочку в чек-боксе и установщик сам удалит эту папку.

Удаление папки setup

После установки галочки жмем Login и подлежащие уничтожению файлы удаляются и перед вами появится логин-окно вашего сайта.

Вход в админку MODX Revolution

Поздравляю! Установка прошла успешно. Теперь вы можете зайти в панель управление вашим сайтом, которую далее я буду называть просто менеджер. При этом необходимо ввести имя администратора и пароль, которые вы создали на этапе 3.4. Админка открывается окном приветствия и показывает некоторую полезную информацию. Перед собой вы увидите админку, часть которой показана на этой картинке:

back-end MODX Revolution

Если вы перейдете на страницу вашего вебсайта, то сейчас вы увидите только пустую страницу и если вы посмотрите код страницы, то не увидите там почти ничего.

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

Заметка для пользователей MODX Evolution

Если вы переходите с Evolution, вы заметите пару вещей:

  1. Нет варианта при установке — установить простой сайт. В то же время это можно сделать из репозитория управления пакетами – Package management
  2. Нет шаблона по умолчанию
  3. Нет никаких сниппетов, чанков, модулей, плагинов по умолчанию.

Все это мы будем брать через Управление пакетами – Package Management и будем добавлять по необходимости.

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

Установка и обновление из Командной строки

MODX Revolution можно установить из командной строки, если на вашем хостинге установлен curl или есть возможность его установить и использовать. Команда для установки curl:

sudo apt-get install curl libcurl3 libcurl3-dev php5-curl php5-mcrypt

Предварительно назначьте права для installmodx.php - chmod 0777

Источники: