Создание установочного XML-файла

Последнее обновление Dec 7th, 2019 | История страницы | Улучшить эту страницу | Сообщить о проблеме

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

$213 per month—let's make that $500!

Learn more

XML-файл конфигурации¶

CLI-установка читает XML-файл (обычно setup/config.xml). Скопируйте setup/config.dist.new.xml из пакета MODX 3.x, переименуйте в config.xml и подставьте значения своего сервера. Файл можно держать вне web root и указать через --config=/path/to/config.xml.

Пример ниже совпадает с setup/config.dist.new.xml в ветке 3.x. Перед установкой замените доступ к БД, учётку администратора, хост и пути на диске.

Минимальный пример новой установки¶

<modx>
    <database_type>mysql</database_type>
    <database_server>localhost</database_server>
    <database>modx_modx</database>
    <database_user>db_username</database_user>
    <database_password>db_password</database_password>
    <database_connection_charset>utf8</database_connection_charset>
    <database_charset>utf8</database_charset>
    <database_collation>utf8_general_ci</database_collation>
    <table_prefix>modx_</table_prefix>
    <https_port>443</https_port>
    <http_host>localhost</http_host>

    <!-- 1 = файлы уже на месте (Git или полная распаковка до setup) -->
    <inplace>0</inplace>

    <!-- 1 = core.transport.zip уже распакован в core/packages/ -->
    <unpacked>0</unpacked>

    <!-- Код языка IANA для языка менеджера по умолчанию -->
    <language>ru</language>

    <cmsadmin>username</cmsadmin>
    <cmspassword>password</cmspassword>
    <cmsadminemail>[email protected]</cmsadminemail>

    <core_path>/www/modx/core/</core_path>

    <context_mgr_path>/www/modx/manager/</context_mgr_path>
    <context_mgr_url>/modx/manager/</context_mgr_url>
    <context_connectors_path>/www/modx/connectors/</context_connectors_path>
    <context_connectors_url>/modx/connectors/</context_connectors_url>
    <context_web_path>/www/modx/</context_web_path>
    <context_web_url>/modx/</context_web_url>

    <remove_setup_directory>1</remove_setup_directory>
</modx>

Затем из каталога setup/:

php ./index.php --installmode=new

См. установку из командной строки про --config, апгрейд и upgrade-advanced.

Минимальный пример апгрейда¶

Для --installmode=upgrade в setup/config.dist.upgrade.xml достаточно ключей ниже (и любых других значений, которые хотите изменить):

<modx>
    <inplace>0</inplace>
    <unpacked>0</unpacked>
    <language>ru</language>
    <core_path>/www/modx/core/</core_path>
    <remove_setup_directory>1</remove_setup_directory>
</modx>

Параметры базы данных¶

Ключ	Описание	По умолчанию
database_type	Драйвер базы данных.	mysql
database_server	Хост сервера БД. Порт укажите через двоеточие: `хост:порт`.	localhost
database	Имя базы данных.	modx_modx
database_user	Пользователь БД.	db_username
database_password	Пароль пользователя БД.	db_password
database_connection_charset	Кодировка соединения с БД.	utf8
database_charset	Кодировка базы данных.	utf8
database_collation	Collation базы данных.	utf8_general_ci
table_prefix	Префикс таблиц MODX.	modx_

Параметры установки¶

Ключ	Описание	По умолчанию
inplace	`1`, если вы ставите из Git или уже распаковали полный пакет на сервер до запуска setup.
unpacked	`1`, если уже распаковали `core/packages/core.transport.zip`. Ускоряет установку, когда нельзя поднять PHP `time_limit`.
language	Язык менеджера по умолчанию. Коды IANA.
cmsadmin	Логин нового администратора (новая установка).	username
cmspassword	Пароль нового администратора (новая установка).	password
cmsadminemail	Email нового администратора (новая установка).	[email protected]
remove_setup_directory	Удалять ли каталог `setup/` после установки.	1

Параметры путей¶

Ключ	Описание	По умолчанию
core_path	Абсолютный путь к каталогу `core/`.
context_mgr_path	Абсолютный путь к менеджеру.
context_mgr_url	URL-путь к менеджеру (например `/modx/manager/`).
context_connectors_path	Абсолютный путь к connectors.
context_connectors_url	URL-путь к connectors.
context_web_path	Абсолютный путь к корню контекста `web`.
context_web_url	URL-путь к корню сайта (например `/modx/`).
assets_path	Абсолютный путь к `assets/` (опционально, по умолчанию под web path).
assets_url	URL-путь к `assets/` (опционально).
processors_path	Абсолютный путь к процессорам (опционально, MODX задаёт значение по умолчанию).

Другие параметры¶

Ключ	Описание	По умолчанию
https_port	Порт HTTPS на сервере.	443
http_host	HTTP-хост сервера (имя хоста, например `mysite.com`).	localhost
cache_disabled	Отключать ли кэш MODX.	0

См. также¶