From Nova Wiki

Nova: NovaTelemetry

Класс NovaTelemetry предоставляет функционал для тестирования и отладки приложений Nova.

Свойства

• Config - массив параметров конфигурации телеметрии.
• Connection - идентификатор открытого соединения телеметрии (curl).
• TDecoders - массив объектов декодеров TCode.
• PageData - объект страницы PageData на которой запустился модуль телеметрии.

Методы

• Report($args) - выполняет вызов url телеметрии, передачу параметров $args, получение ответа, разбор и запуск на выполнение полученных команд.
• IO($args) - низкоуровневый обработчик. Выполняет вызов телеметрии, передачу параметров и возвращает неформатированную строку ответа.
• RunCode($code) - выполняет переданный в параметре $code код и возвращает полученное значение.

Команды:

• GET_INCLUDES - Возвращает список всех слотов, загруженных на странице: obj['includes']=array('PLACE'=>array('inc_id'=>$inc_id,'module'=>$module),...).
• GET_REQUEST_DATA - Возвращает список всех слотов, загруженных на странице. obj['_GET']=$_GET,obj['_POST']=$_POST,obj['_COOKIE']=$_COOKIE,obj['_FILES']=$_FILES, obj['_SERVER']=$_SERVER;
• INJECT_REQUEST_DATA - позволяет переопределить переменные данных выполняемого запроса значениями переданными в поле data: $_GET=$data['_GET'],$_POST=$data['_POST'],...
• INJECT_SESSION_DATA - позволяет переопределить данные сессии. !Сессия при этом не инициализируется и не прерывается. По завершении скрипта внесенные данные могут автоматически сохраниться и пререзапишут оригинал!.
• GET_INCLUDE - возвращает данные слота с именем, переданным в поле data['place'].
• GET_PAGE - возвращает метаданные страницы.
• WATCH_INCLUDE - включает трассировку вызовов слота с именем в поле data['place']. При каждом выполнении слота могут передаваться аргументы его вызова (если установлено поле data[args]), вывод (data[output]), результат выполнения (data[result]). Если слот не был определен на странице, но была попытка его вызвать, дополнительно будет возвращен признак no_include. Каждый запуск слота порождает отдельный вызов телеметрии.
• WATCH_SQL_QUERIES - включает трассировку SQL запросов. В поле data[pattern] нужно передать регулярное выражение, которому должны соответствовать строки запросов, что-бы попасть в отчет. Каждый удовлетворяющий правилу запрос порождает вызов телеметрии. Возможна настройка отправки вызова как до выполнения запроса (data[before]), так и после (data[after]).
• REGISTER_SHUTDOWN_FUNCTION - позволяет определить функцию, выполняемую в момент завершения сценария. Код функции передается в поле data.
• GET_MEMORY_USAGE - получить количество памяти, выделенной php в момент вызова (см. memory_get_usage). obj[memory]=memory_get_usage().
• GET_SQL_ERROR_INFO - получить информацию о последней ошибке SQL.
• GET_LOADED_EXTENSIONS - получить список загруженых расширений php. obj[extensions]=array(/*extensions list*/);
• GET_INCLUDED_FILES - получить список включенных файлов php. obj[included_files]=array(/*files list*/);
• GET_DEFINED_CONSTANTS - получить список определенных констант. obj[constants]=array(/*files list*/);
• INI_GET_ALL - вывести значения переменных конфигурации php (ini_get_all).
• PHPINFO - получить html код выполнения phpinfo(): obj[phpinfo]=/*html*/.
• OK - продолжить выполнение.
• EXIT - прервать выполнение.
• DIE - прервать выполнение и вывести сообщение из data. (die($data));
• DUMP_EVAL - выполнить код из data и отправить результат.'''Все команды EVAL выполняются в контексте метода NovaTelemetry::RunCode.
• RETURN_VALUE - передать управление вызвавшему коду и вернуть значение, переданное в data.
• RETURN_EVAL - выполнить php код в поле data и вернуть полученное значение вызвавшему коду.
• TDECODE - раскомментировать блоки кода отладки/тестирования. В поле data передается массив параметров декодирования. См. раздел TCODE далее.

TCODE

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

some code...
/*<!--{
echo "This is test var:".$test_var;
}-->*/
some code...
//<!--KEY{echo "This another debug block with KEY";}-->
some more code...
/*<!--KEY{
echo "This another debug block with KEY";
}KEY-->*/

Далеко не всегда нужно получать все отладочные сообщения, потому формат TCODE предусматривает возможность использования ключа - специальных меток, позволяющих декодеру отличать одни фрагменты TCODE от других. Т.о. если передать комманду {command:"TDECODE",data:{'':1}}или {command:"TDECODE"}, будет раскомментирован первый блок, а если передать {command:"TDECODE",data:{"KEY":1}} будут раскомментированы два блока ниже.
Также для каждого ключа можно указать список слотов и php файлов которые вы хотите обработать:

{command:"TDECODE",data:{"KEY":{"includes":[":SLOT1",":SLOT2"],"files":["file1.php","file2.php"]}}}

Декодер будет обработает включаемый php файл, если путь заканчивается подстрокой, равной одной из строк списка files.Например: Если files cодержит строку '/dir_include/file.php', то файл '/var/www/html/mysite/dir_include/file.php' будет обработан, а файлы '/var/www/html/mysite/dir_do_not_include/file.php' и '/var/www/html/mysite/file.php' - нет.
Обратите внимание: что-бы файл php был обработан, он должен включаться позже, чем была получена команда TDECODE.
TCODE может внедряться в код модулей, код eval_php.php, а также в настройки слотов.