答案是可以在 Composer 脚本中使用 Ray 进行调试。通过手动引导 Laravel 或引入 spatie/ray 独立包，可在 CLI 环境中实现变量可视化、环境判断与结构化输出，提升脚本调试效率。
在开发 Laravel 应用时，调试是不可或缺的一环。Spatie 的 laravel-ray 是一个功能强大且直观的调试工具，它能将变量、日志、数据库查询等信息实时推送到 Ray 桌面应用中，帮助开发者快速定位问题。虽然 Ray 主要用于 Laravel 请求生命周期内的调试，但你也可以将其集成到 Composer 脚本中，在命令行任务执行期间进行调试。
为什么要在 Composer 脚本中使用 Ray？
Composer 脚本常用于执行自动化任务，如数据迁移、代码生成、环境检查或自定义构建流程。这些脚本运行在 PHP CLI 环境中，不经过 Laravel 框架的完整启动流程，因此默认无法直接使用 ray() 函数。
但通过手动引导 Laravel 并加载 Spatie/laravel-ray，你可以突破这一限制，实现对 Composer 脚本的可视化调试。
确保已安装 laravel-ray
注意：Ray 是一个付费工具，但提供试用期。你需要先安装并配置好才能使用。在项目中安装 laravel-ray：
composer require --dev spatie/laravel-ray
安装后，Laravel 会自动注册服务提供者（在开发环境中）。如果你关闭了自动发现，需手动添加：
'providers' => [
Spatie\Ray\RayServiceProvider::class,
]
创建可调试的 Composer 脚本
假设你想在 Composer 的 post-install-cmd 或自定义脚本中使用 Ray 调试。首先创建一个脚本类：
namespace YourApp\Composer;
use Illuminate\Support\Facades\App;
use Composer\Script\Event;
class ScriptHandler
{
public static function postInstall(Event $event)
{
// 手动启动 Laravel 引擎
require_once __DIR__.'/../../bootstrap/app.php';
$app = App::getFacadeApplication();
$app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
// 现在可以安全使用 ray()
ray('Composer post-install script is running');
ray($_SERVER)->label('Server vars');
// 添加你的调试逻辑
if (env('APP_ENV') === 'local') {
ray('Running in local environment')->green();
}
}
}
在 composer.json 中注册脚本
编辑 composer.json 文件，添加自定义脚本：
"scripts": {
"post-install-cmd": [
"YourApp\\Composer\\ScriptHandler::postInstall"
],
"debug-script": "YourApp\\Composer\\ScriptHandler::postInstall"
}
现在你可以通过以下命令触发调试：
composer run debug-script
或者执行 composer install 触发 post-install 钩子。
关键注意事项与技巧
-
仅在开发环境启用：避免在生产环境中调用
ray()，可在脚本中判断环境。 - 性能影响：Ray 会发送 TCP 请求到本地 Ray 应用，默认端口 23517。确保 Ray 桌面程序正在运行，否则可能引起超时。
- CLI 调试可视化：相比 var_dump 和 echo，Ray 提供结构化输出、颜色标记、定时追踪和屏幕分组，更适合复杂脚本分析。
-
处理非 Laravel 项目脚本：如果项目不是 Laravel，可使用
spatie/ray包（独立版本）：composer require --dev spatie/ray
然后在脚本中初始化：
use Spatie\Ray\Ray; require_once 'vendor/autoload.php'; (new Ray())->initialize()->send('Hello from Composer!');
总结
通过手动引导 Laravel 或直接使用 spatie/ray 包，你可以轻松在 Composer 脚本中集成 Ray 调试。这种方式特别适用于复杂的部署前检查、自定义构建流程或需要深入分析 CLI 执行状态的场景。合理使用，能显著提升脚本开发效率。
基本上就这些。调试不一定要靠 var_dump，用对工具，事半功倍。
