Ray

Что такое Ray?

Ray — специализированное настольное приложение для организации и просмотра отладочного вывода вне среды выполнения вашего приложения. Оно позволяет отправлять значения (строки, массивы, объекты и многое другое) с помощью единой синтаксиса ray(...), а затем просматривать, фильтровать и повторно открывать результаты в Ray.

Его основная цель — сохранять отладочный вывод читаемым и структурированным, минимизируя необходимость засорять приложение дополнительным кодом логирования. Ray также поддерживает удалённую отладку по SSH и включает инструменты для паузы и замера выполнения в контексте PHP/Laravel.

Ключевые возможности

• Организованный рабочий стол для отладочного вывода: Хранит вывод в отдельном приложении, чтобы вы могли просматривать результаты без зависимости от консолей браузера.
• Форматированный рендеринг для множества типов данных: Отправляйте строки, массивы, объекты и таблицы — они отображаются аккуратно для просмотра.
• Фильтрация, метки и поиск по сообщениям: Фильтруйте по типу, источнику или пользовательским меткам, используйте поиск для нахождения предыдущего вывода.
• Управление архивом и очисткой: Очищайте экран и архивируйте сообщения для последующего использования при сравнении выводов или расследовании трудно воспроизводимых проблем.
• Удалённая отладка по SSH: Подключайтесь к серверам по SSH, чтобы транслировать отладочный вывод из удалённого кода в Ray.
• Переход в IDE: Переходите из дампа вывода обратно к соответствующему месту в редакторе (с поддержкой множества IDE, как указано на сайте).
• Синтаксис отладки для разных языков/фреймворков: На сайте описан единый подход в стиле dump для разных языков и фреймворков.
• Инструменты выполнения в Ray 3.0 для PHP/Laravel: Включают паузу и замер выполнения для остановки кода PHP/Laravel и измерения времени между вызовами.
• Автоматический приём вывода среды выполнения (Ray 3.0): На сайте упоминается автоматический приём вывода (например, запросов, заданий, исключений) без явных вызовов в коде.
• Расширяемость и настройка: Меняйте темы, расширяйте Ray макросами, создавайте собственный клиент для отправки данных из неподдерживаемых языков/фреймворков.
• Возможности ИИ (Ray 3.0): Взаимодействуйте с выводом ИИ прямо в Ray, включая HTML-компоненты/прототипы от ИИ и структурированные объяснения диаграмм Mermaid и ERD через встроенный просмотрщик.
• Сервер MCP для ИИ-агентов: На сайте указано, что сервер MCP позволяет ИИ-агентам получать доступ к окнам/инструментам для чтения, генерации и вывода контента.

Как использовать Ray

1. Скачайте Ray и приобретите лицензию при необходимости (на сайте указана цена $49 USD и 1-летние лицензии через Spatie).
2. Отправляйте отладочный вывод в Ray с помощью синтаксиса ray(...) (примеры на сайте включают метки, таблицы, цвета и фильтрацию по атрибутам вызова).
3. Просматривайте и управляйте сообщениями в Ray: используйте поиск и фильтры для сужения результатов, архивируйте сообщения для последующего сравнения выводов.
4. (Опционально) Настройте удалённую отладку: подключитесь к серверу по SSH, чтобы Ray транслировал отладочный вывод из удалённого выполнения.
5. (Опционально) Используйте навигацию в IDE и инструменты выполнения: переходите к источнику из вывода Ray и применяйте инструменты паузы и замера для PHP/Laravel.

Сценарии использования

• Просмотр сложных значений без засорения приложения: Отправляйте строки, массивы, объекты и таблицы в Ray (с метками и форматированием), чтобы понимать состояние во время разработки без сырого вывода консоли.
• Отладка конкретных запросов или путей кода с фильтрами: Применяйте цвета/метки к вызовам ray(...), затем фильтруйте по типу/источнику/метке в Ray для выделения релевантных сообщений.
• Сравнение выводов по попыткам: Архивируйте сообщения до/после изменений кода, чтобы возвращаться к ранним выводам при устранении прерывистых проблем.
• Отладка удалённых серверов по SSH: Транслируйте отладочный вывод из кода на удалённых серверах в Ray, чтобы просматривать результаты без ручного копирования логов.
• Отладка производительности и потока в PHP/Laravel: Пауза выполнения и замер времени между вызовами, плюс автоматический приём определённого вывода среды (запросы, задания, исключения), как описано для Ray 3.0.
• Работа с диаграммами БД и объяснениями схем через ИИ: Используйте возможности Ray 3.0, чтобы ИИ объяснял схемы БД и просматривал структурированный вывод в формате Mermaid или ERD.

Часто задаваемые вопросы

• Ray подходит только для отладки в браузере?
  Нет. На сайте указано, что Ray — это специализированное настольное приложение, которое организует отладочный вывод вне среды выполнения вашего приложения.

• Какие форматы вывода поддерживает Ray?
  На сайте сказано, что Ray форматирует получаемый вывод (например, строки, массивы, объекты) и может отображать таблицы; также упоминается вывод запросов, писем, событий и стек-трейсов.

• Можно ли использовать Ray для отладки кода на удалённом сервере?
  Да. На сайте описано подключение по SSH и потоковая передача отладочного вывода в Ray.

• Заменяет ли Ray dd() или другие отладчики?
  На странице сказано, что Ray не заменяет dd или xdebug; это третий инструмент, заполняющий пробел между быстрым дампом и более структурированными рабочими процессами отладки.

• Что нового в Ray 3.0?
  На странице выделены пауза и измерение выполнения, взаимодействие с ИИ (включая HTML-компоненты и просмотрщики Mermaid/ERD), а также MCP-сервер для ИИ-агентов.

Альтернативы

• Логирование в браузере и вывод в консоль (например, console.log, инструменты разработчика браузера): Полезно для быстрых проверок, но результаты привязаны к среде браузера и не представлены в виде专用ной, searchable временной шкалы на рабочем столе.
• Хелперы «дампа» в фреймворке приложения (например, отладка в стиле dd()): Быстро и прямо, но обычно вывод остаётся внутри ответа приложения/браузера, а не в отдельном настольном приложении с фильтрацией/поиском и архивированием.
• Инструменты удалённого логирования/наблюдения: Альтернативы для сбора логов из удалённых сред, обычно ориентированные на агрегацию логов и мониторинг, а не на структурированный осмотр сообщений, описанный для Ray.
• Инструменты REPL/отладки на основе терминала: Могут инспектировать значения во время разработки, но могут не предоставлять такой же организованный интерфейс на рабочем столе, фильтрацию и переходы в IDE, как указано на сайте Ray.