Debugging with Ray

Ray (opens new window) is a Desktop PHP debugging tool that makes it easy to debug your PHP application.

# Installation

Ray is PHP framework agnostic, however there is a helpful plugin (opens new window) to make configuring Craft and Ray super easy!

Install the plugin using the nitro composer command:

nitro composer require spatie/craft-ray

If you only want to use Ray in development, run nitro composer require spatie/craft-ray --dev

# Configuring

In the control panel, visit SettingsPlugins, choose Ray and switch on the Enable setting.

Enter the following:

Host: host.docker.internal
Remote Path: /app
Local Path: /path/to/your/local/project

Ray Plugin Settings

# Usage

You can use Ray directly in your Twig templates or Plugin. To use Ray in Twig, open your template of choice and enter the following:

{{ ray("Hello Ray!") }}

For a full site of available methods in Twig, visit the Ray documentation for Craft CMS (opens new window).

The Ray desktop app will now have a new debug event!

Ray App

To use Ray for plugin or module development, enter the following in your plugin:


namespace modules;

use Craft;

class Module extends \yii\base\Module
    public function init()
        Craft::setAlias('@modules', __DIR__);

        if (Craft::$app->getRequest()->getIsConsoleRequest()) {
            $this->controllerNamespace = 'modules\\console\\controllers';
        } else {
            $this->controllerNamespace = 'modules\\controllers';

        ray('Hello Ray!');



        // Custom initialization code goes here...

For a complete list of available methods, see the Yii2 documentation (opens new window) for more detailed usage examples.