A bundle to use the php REPL PsySH with Symfony. Learn more at psysh.org 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.
You can use Composer to install the bundle to your project:
composer require --dev theofidry/psysh-bundleThen, 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)
<?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 psyshor
use function psysh
class X
{
function foo()
{
psysh(get_defined_vars(), $this); // Debug with the current context
}
}
Adding a custom command for PsySH is as simple as defining a service with psysh.command tag!
services:
my_psysh_command:
class: Acme\Shell\MyCommand
tags:
- { name: psysh.command }Or even simpler if you use Symfony 3.3+:
services:
_defaults:
autoconfigure: true
autowire: true
public: false
Acme\Shell\MyCommand: ~PsyshBundle provides autoconfiguration for custom Psysh command services, as long as they inherit from
Psy\Command\ReflectingCommandorPsy\Command\Command.
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
psysh:
variables:
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:
- Justin Hileman: author of PsySH and all the contributors of the PsySH project
- Adrian Palmer: gave the lead for porting PsySH on Symfony
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent