# PHP-консоль

← [К управлению системой](README.md)

PHP-консоль выполняет административный диагностический фрагмент в контексте
AVE.cms. Это не механизм фоновых заданий, миграций или публичной бизнес-логики.

## Допустимые задачи

- проверить значение настройки или работу хелпера;
- выполнить безопасный read-only запрос;
- исследовать структуру данных во время разработки;
- сохранить часто используемый диагностический сниппет.

Для изменения схемы используйте миграцию модуля, для массового изменения
документов — специализированную операцию с предварительным просмотром, для
постоянной логики — service/hook.

## Безопасность

Выполнение требует отдельного права и может требовать повторного подтверждения
паролем. Код запускается на сервере с правами web-процесса, поэтому способен
изменить БД и файлы.

Перед изменяющим сценарием:

1. сделайте backup;
2. ограничьте выборку и сначала выведите предполагаемые изменения;
3. используйте транзакцию, если операция её допускает;
4. не выводите секреты, токены и пароли;
5. после выполнения проверьте аудит и удалите опасный временный сниппет.

Production-сайт не должен зависеть от ручного запуска консоли или доступности
CLI. Все обязательные операции должны иметь штатный web/lifecycle-механизм.