3. Описание MCP-сервера › 3.3 Движок › PHP-файлы › engine_php_add

Создаёт PHP-файл: модуль в units/ или корневой скрипт.

Право

«Прямой доступ → Разработка → Изменение данных» (AGENT_ENGINE_DEV_WRITE).

Параметры

Параметр	Тип	Что это
`path`	строка	`units/<имя>.php` — модуль; любой другой путь — корневой скрипт рядом с `index.php`

Что создаётся

Модуль — файл units/<имя>.php, манифест units/<имя>.json и в каждой группе шаблонов папка модуля templates/<группа>/units/<имя>/ с файлом main.htm. Библиотеке — второе слово имени inc или include или имя без подчёркивания — папки в группах шаблонов не создаются.
Корневой скрипт — один файл.

Папку в группе шаблонов, оставшуюся от удалённого модуля с тем же именем, создание стирает молча. Имя, которое уже жило в магазине, стоит сверить с engine_map_tree.

Файл создаётся пустым: тело и манифест записывает engine_php_save.

Ответ

{"path": "./../units/zz_demo.php", "module": true,
 "folders": ["./../templates/default/units/zz_demo"]}

Поле	Что это
`path`	путь созданного файла
`module`	создан модуль (`true`) или корневой скрипт (`false`)
`folders`	папки модуля в группах шаблонов, появившиеся вместе с ним; пусто у библиотеки и корневого скрипта

Отказы

Ответ	Когда
`A module path ends with .php: …`	путь в `units/` без `.php`
`units/ keeps a flat list of modules: units/<name>.php`	путь с подпапкой внутри `units/`
`That is the templates tree - engine_html_, engine_static_ and engine_image_* speak there.`	путь в `templates/`
`Unit already exists: <имя>`	модуль или библиотека с таким именем уже есть
`File already exists: <путь>`	корневой скрипт с таким путём уже есть
`path is required…`	не указан `path`

Общие отказы — «Ответы и отказы».