Download the PHP package twilightgluck/debug without Composer
On this page you can find all versions of the php package twilightgluck/debug. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download twilightgluck/debug
More information about twilightgluck/debug
Files in twilightgluck/debug
Package debug
Short Description Lightweight Yii2 debugging helper with buffered dumps, call tracing, timers, counters, memory usage, and global shortcut functions.
License MIT
Informations about the package debug
TwilightGluck Debug
Инструмент для быстрой отладки Yii2-приложений во время разработки.
Короткие глобальные функции позволяют вывести значение прямо в месте выполнения кода — без use, длинных вызовов и отдельной настройки. Одна–три буквы, две скобки — и значение сразу попадает в отладочный буфер, даже посередине генерации страницы.
Пакет также поддерживает накопление нескольких значений, вывод стека вызовов, измерение времени и памяти, именованные счётчики и завершение выполнения после вывода отладочных данных.
Требования
- PHP 8.1 или выше;
- Yii 2;
- расширение PHP
mbstring.
Установка
Глобальные функции подключаются автоматически через autoload.files.
Использование класса
Глобальные функции
Рекомендуется использовать их для обращения к Debug, чтобы получить максимум удобства.
l()
Добавляет значение в отладочный буфер и возвращает его:
r()
Возвращает накопленный буфер строкой:
s()
Выводит накопленный буфер:
c()
Очищает отладочный буфер:
h()
Завершает выполнение:
t()
Выводит место вызова и завершает выполнение:
Для вывода полного стека:
sh()
Выводит накопленный буфер и завершает выполнение:
ls()
Добавляет значение, выводит буфер и возвращает значение:
lsh()
Добавляет значение, выводит буфер и завершает выполнение:
Измерение времени
Время от одной общей точки:
Оба вызова показывают время, прошедшее с момента $start.
Последовательные интервалы:
Метод возвращает момент текущего измерения. Если сохранить его в $time, следующий вызов покажет время, прошедшее после предыдущего измерения.
Счётчики
Первый вызов увеличивает счётчик на 1. Второй увеличивает тот же счётчик ещё на 4.
Значение $increment может быть отрицательным.
Если счётчик отсутствует, он автоматически создаётся. Если метка уже занята значением другого типа, метод
сохраняет сообщение об этом в отладочном буфере, не изменяет исходное значение и возвращает null.
Использование памяти
Метод добавляет в отладочный буфер текущее количество используемой памяти.
Форматирование вывода
По умолчанию пакет использует системный var_dump():
Для использования yii\helpers\VarDumper:
Конфликты глобальных функций
Перед объявлением шорткатов пакет проверяет весь набор глобальных функций:
Если хотя бы одно из этих имён уже занято, пакет не объявляет функции и сообщает о конфликте. Это предотвращает одновременное использование функций из разных реализаций.