Path
projects / org / se7enxweb / psyshbundle
Search!
Find the Exponential Software extensions you want
PsyshBundle
| UNIX name | Owner | Status |
|---|---|---|
| PsyshBundle | 7x | stable |
| Version | Compatible with |
|---|---|
| N/A | N/A |
PsyshBundle
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.
Documentation
Install
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;
}
Usage
# Symfony > 4.0
bin/console psysh
or
use function psysh
class X
{
function foo()
{
psysh(get_defined_vars(), $this); // Debug with the current context
}
}
Customize PsySH
Adding a custom command
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\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
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)
Credits
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