A port of the PHP REPL PsySH for Symfony.

Fund package maintenance!

Installs: 706 739

Dependents: 9

Suggesters: 0

Security: 0

Stars: 150

Watchers: 5

Forks: 23

Open Issues: 6


4.4.0 2021-02-02 12:16 UTC


Package version Build Status Scrutinizer Code Quality License

A bundle to use the php REPL PsySH with Symfony. Learn more at and check out the Interactive Debugging in PHP talk from OSCON on Presentate.

What does it do exactly?

  • Loads PsySH with the application dependencies
  • Gives access to the following variables:
Variable Description
$container Instance of Symfony ServiceContainer
$kernel Instance of Symfony Kernel
$parameters Instance of Symfony parameters

Aside from that it's the plain old PsySH! You can also customize it to add your own variables.


  1. Install
  2. Usage
    1. PsySH as a debugger
    2. Reflect like a boss
    3. PsySH for breakpoints
  3. Customize PsySH
  4. Credits


You can use Composer to install the bundle to your project:

composer require --dev theofidry/psysh-bundle

Then, enable the bundle by updating your app/AppKernel.php file to enable the bundle:
(not needed on symfony 5, bundle is automaticaly registred in config/bundles.php)

// app/AppKernel.php

public function registerBundles()

    if (in_array($this->getEnvironment(), ['dev', 'test'])) {
        $bundles[] = new Fidry\PsyshBundle\PsyshBundle();

    return $bundles;


# Symfony > 4.0
bin/console psysh


use function psysh

class X
    function foo()
        psysh(get_defined_vars(), $this);   // Debug with the current context

PsySH Shell

Go further.

Customize PsySH

Adding a custom command

Adding a custom command for PsySH is as simple as defining a service with psysh.command tag!

        class: Acme\Shell\MyCommand
            - { name: psysh.command }

Or even simpler if you use Symfony 3.3+:

        autonfigure: true
        autowire: true
        public: false

    Acme\Shell\MyCommand: ~

PsyshBundle provides autoconfiguration for custom Psysh command services, as long as they inherit from Psy\Command\ReflectingCommand or Psy\Command\Command.

Adding custom variables

It is possible to add custom variables to the shell via configuration. Variables can be of any type, container parameters references (e.g. %kernel.debug) or even services (prefixed with @, e.g. "@my_service").

# app/config/config_dev.yml

        foo: bar
        router: "@router"
        some: [thing, else]
        debug: "%kernel.debug%"

Now if you run php app/console psysh and then ls, you will see the variables $foo, $router, $some and $debug, in addition to already defined variables:

>>> ls
Variables: $foo, $router, $some, $debug...

Default variables are:

  • $container (the service container)
  • $kernel
  • $parameters (all container parameters)
  • $self (the PsySH shell itself)


This bundle is developed by Théo FIDRY. This project has been made possible thanks to: