Как установить Ray: пошаговая инструкция с примерами кода для отладки PHP

Ray — это мощное приложение для отладки от команды Spatie, которое позволяет визуализировать данные из вашего PHP-кода (а также JavaScript, Python и других языков) в отдельном десктопном приложении. Оно помогает избежать засорения логов и консоли, предоставляя удобный интерфейс для инспекции переменных, трассировки выполнения и замера производительности. В этой статье мы подробно разберем, как установить и начать использовать Ray с примерами кода.

Шаг 1: Установка десктопного приложения Ray. Прежде чем интегрировать Ray в ваш проект, необходимо установить само приложение. Перейдите на официальный сайт (https://myray.app) и скачайте версию для вашей операционной системы (macOS, Windows или Linux). Установка стандартна: скачайте установщик и следуйте инструкциям. После запуска приложение появится в системном трее. Оно будет ожидать данных от вашего кода.

Шаг 2: Установка PHP-пакета в ваш проект. Ray работает через пакет `spatie/ray`. Если вы используете Composer (а это стандарт для PHP), установка выполняется одной командой в терминале в корне вашего проекта.

```
composer require spatie/ray --dev
```

Флаг `--dev` указывает, что пакет нужен только для разработки и не должен быть в production-окружении. Это рекомендуемый подход. Пакет также требует PHP 7.4 или выше.

Шаг 3: Базовая настройка (опционально). Для большинства случаев дополнительная настройка не требуется. Ray автоматически обнаружит запущенное десктопное приложение. Однако вы можете создать конфигурационный файл, чтобы задать параметры, например, путь к приложению на нестандартных системах или включить отправку данных на удаленный сервер. Опубликуйте конфигурационный файл командой:

```
php artisan ray:publish-config
```

Эта команда доступна, если вы используете Laravel. Для других фреймворков или чистого PHP вы можете создать файл `ray.php` вручную, основываясь на документации.

Шаг 4: Использование в коде. Теперь можно отправлять данные в приложение Ray. Простейший пример — отправить строку. Убедитесь, что десктопное приложение Ray запущено.

```