用途:Ray 是 Spatie 面向开发者的桌面调试应用。Ray Skill 描述如何直接向 Ray 的本地服务器发送 HTTP 请求来推送数据,这也是 ray() PHP 函数底层所做的事。适用于用户要求“send to Ray”“show in Ray”“debug in Ray”“log to Ray”“display in Ray”,或需要可视化数据、调试输出、展示图表时。
连接:默认 Host 为 localhost(环境变量 RAY_HOST),Port 为 23517(RAY_PORT),URL 为 http://localhost:23517/。请求方法为 POST,Content-Type 为 application/json,User-Agent 为 Ray 1.0。
请求结构:顶层包含 uuid(Ray 实例唯一标识,复用同一 UUID 可更新已有条目)、payloads(payload 对象数组)、meta(可选元数据,如 ray_package_version、project_name、php_version)。每个 payload 含 type、content 和 origin(file、line_number、hostname)。
主要 payload 类型:log(values 数组,发送值)、custom(content、label,HTML 或文本)、table(values、label,表格展示)、color(设置条目颜色,可选 green、orange、red、purple、blue、gray)、screen_color(设置屏幕背景色)、label(添加标签)、size(sm 或 lg)、notify(桌面通知)、new_screen(新建屏幕)、measure(性能计时,含 name、is_new_timer 及计时字段)。无内容类型包括 separator、clear_all、hide、remove、confetti、show_app、hide_app。
组合用法:一次请求可发送多个 payload,用同一 uuid 让 color、label、size 等修饰符作用于同一条 log 条目。
可用性检查:发送前可 GET http://localhost:23517/_availability_check,Ray 可用时返回 HTTP 404(端点不存在但服务器在运行)。
限制:资料未提供安装方式、收费、价格、平台支持范围及具体使用步骤,这些内容暂未提供。