Installing Ray for Laravel
Laravel is the most popular PHP framework, known for its elegant syntax and powerful features. Use Ray to help you debug when you're developing a Laravel application or package.
Install in a single project
composer require spatie/laravel-ray
This installs Ray as a project dependency, meaning it will also be installed in your production environment. Your application won't break if you forget to remove a ray call. The package doesn't send data when the environment isn't set to dev.
If you prefer, install it as a dev dependency by adding --dev to the composer command. Note that with a dev dependency, any ray calls left in your code will cause errors in production, so you'll need to remove them before deploying. We have some options for detecting Ray calls in your app.
composer require spatie/laravel-ray --dev
Global installation
To make ray(), dump() and dd() available in any PHP file on your system, you can install the global Ray package. See the global installation instructions for setup details.
Publishing the config file
Optionally, publish the config file to your project root.
php artisan ray:publish-config
Add the --docker or --homestead option to set up a base configuration for those environments.
php artisan ray:publish-config --docker
php artisan ray:publish-config --homestead
Using Ray in an Orchestra test suite
To use Laravel-specific functionality in an Orchestra-powered test suite, register Ray's service provider in your base test case.
protected function getPackageProviders($app)
{
return [\
\Spatie\LaravelRay\RayServiceProvider::class,\
];
}
What's next?
Now that Ray is installed in your Laravel project, explore what else it can do!
Debug without breaking your flow
Ray keeps all your debug output neatly organized in a dedicated desktop app.
Download Ray
Licenses are valid for 1 year and managed through Spatie. Licenses purchased before Ray 3 remain valid. VAT is calculated at checkout.
Thanks for trying out Ray!
macOS
Windows
Linux
By downloading Ray, you agree to our terms of use.
The free trial lets you send up to 20 messages per session.