NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #94 most downloaded on Packagist
An interactive shell for modern PHP.
Latest stable
v0.12.24
Last release 4 months ago
29 Jun 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
126 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Fix Symfony 4.1 table deprecation notices.
This might just be our... BIGGEST. RELEASE. EVER.
Note that PsySH v0.10.0 drops support for PHP < 5.5, and non-LTS HHVM.
Uppppppggggggrraaaaddddeeeee.
New:
.inputrc and .editrc (Thanks @tgr!)-q, -v and -n (Thanks @aksonnic!)--raw-output (-r) for printing var_export-style return values with non-interactive input.--raw-output and --no-interactionls, doc, etc).Improved:
instanceof checks, catching more fatal errors before they fatal (Thanks @baukevdw!)$array[] expressions outside of the left-hand side of an assignment.goto with an invalid label (Thanks @zonuexe!)ls command with constants:
category=internal and category=user equivalent to --user and --internalcategory option case-insensitivemkdir fails while setting up PsySH (Thanks @GrahamCampbell!)--help option more lenient.Removed:
ls command list alias. Now that PsySH supports arbitrary expressions as arguments for ls, having a list alias is sometimes ambiguous, for example when using the list keyword with a space before its parenthesis.--version short flag has changed to -V, as -v is now used for verbosity (matching Symfony Console defaults).InterfaceEnumerator and TraitEnumerator (which have been unused for several releases).Your coding agent can read these notes before it upgrades. Set up the MCP server →
Update XdgBaseDir dependency to v0.1.*
Add support for Symfony 5.0 (Thanks @Taluu!)
(Skipping v0.9.10 because I tagged a broken commit 😬)
Improve list assignment support (again)… now you can have function calls and really deep nested array and property access, if that's a thing you're in
Add support for static calls on traits (Thanks @zonuexe!)
[$a[0], $a[1]] = [1, 2]!Fix regression updating execution scope with variables declared by commands.
Throw strings via throw-up command (e.g. throw-up "Wheee!")
New:
throw-up command (e.g. throw-up "Wheee!")Improved:
timeit command. It used to count the time to parse input and serialize return values. Now it doesn't.throw-up from working with some code input.list() from working at all.Add documentation support for built-in and magic constants! You'll need to update your manual DB to get the latest hotness :)
New:
Improved:
Add support for a bound class when starting PsySH from inside a static class context.
New:
self and static in commands like ls, show and doc.doc, ls and show commands (Thanks @lvht!)list and [] (Thanks @zonuexe!)Improved:
abstract public trait X, but we'll just call them trait X.doc command with language constructs.Fix a regression for use statements without aliases.
use statements without aliases.sudo.Fix a scope variable regression introduced in v0.9.0.
Restore support for Symfony Console v2.3.
Restore support for Symfony Console v2.3.
Remove support for really really old (and deprecated) history file paths.
This is an enormous release.
Note that PsySH v0.9.0 drops support for PHP < 5.4. Upgrade already. PHP 7.x is soooo much better.
New:
timeit command, for quick-and-dirty code profiling! (Thanks @markcial!)use and namespace statements during Psy\debug sessions.Improved:
list, dump, doc and show the result of arbitrary code input.throw-up, rather than just an existing variable.throw-up at runtime rather than parse time… which means you can conditionally throw-up! See b39dd56 for an example.sudo.sudo code play better with history.$__namespace magic variable with show --ex.$_ magic variable with the output of the parse command.namespace statements with PHP Parser >= v3.1.2.\Error across the board.Psy\info output.Removed:
tabCompletion and tabCompletionMatchers config options — use useTabCompletion and matchers, respectively.Fix a closure binding issue on PHP 5.3.
Fix a closure binding issue on PHP 5.3.
Build stable version using PHP 7.0.
Build stable version using PHP 7.0.
A small release, mostly to pick up support for Symfony 4.
A small release, mostly to pick up support for Symfony 4.
Fix (even more) runtime directory issues.
Catch fatal error calling unset on a return value.
Three quick fixes:
unset on a return value.edit command.--user and --internal when listing constants, classes, interfaces and traits.Temporarily disable edit command to work around an issue for Windows users.
Temporarily disable edit command to work around an issue for Windows users.
Add file and line number to whereami output.
New:
whereami output.edit command for editing (and executing) input in an external editor (Thanks @krageon!)>>> (Thanks @dennisdegreef!)forceArrayIndexes config to always show array indexes, even for numeric arrays (Thanks @dennisdegreef!)Improved:
php -a error formatting.__construct or __wake in tab completion (Thanks @jens1o!)Update the PHP manual download URL (Thanks @timacdonald!)
Catch fatal error with yield outside a function context (Thanks @zonuexe!)
New:
yield outside a function context (Thanks @zonuexe!)$__out magic variable which stores stdout from the last code executed.Improved:
ls like a human, rather than a robot.Use getcwd instead of $PWD env var because Windows.
getcwd instead of $PWD env var because Windows.whereami regression from v0.8.7.Fix require regression from 0.8.7
require regression from 0.8.7Handle missing files in require more gracefully (Thanks @Markcial!)
require more gracefully (Thanks @Markcial!)Psy\Shell::debug() to Psy\debug() to match Psy\sh() and Psy\info().array_multisort pass-by-reference validation.Add show --ex for showing context for the last exception.
New:
show --ex for showing context for the last exception.Improved:
hist call in the history results.Fix namespace handling regression caused by 49c936e4c4b9965e43f42479b044dd0829cdbc56.
break and continue outside of loop contexts.wtf trace UX.eval() lines in traces.Add code argument support to commands. Use this for great justice.
New:
sudo command. Check it out. I promise you won't be disappointed.Improved:
=> null for code with no return value. Because it was a lie.--grep, --insensitive and --invert filter options to trace and wtf? commands.wtf? output.ls ClassName.Seriously. Check out sudo.
Add a --no-inherit option to the list command, for excluding inherited class methods, properties and constants.
--no-inherit option to the list command, for excluding inherited class methods, properties and constants.Psy\info() more robust.Psy\info() a bit prettier.Add a startupMessage config option (Thanks @gitetsu!)
New:
startupMessage config option (Thanks @gitetsu!)dump, ls, show, doc) now add magic variables so you can do fun things with them: $__class, $__file, $__method, etc.Improved:
\Errors thrown while serializing the shell return value (Thanks @damiankloip!)$this (like if you started your shell session from inside a class method) without exploding in PHP 7.1+.Psy\info().Psy\info() from doing anything at all in the last release :-(dump is the only one that actually does anything useful with a superglobal, but now the others have reasonable output.static instead of self to make extension easier (Thanks @castarco!)<) while dumping values.Add support for use statement groups.
use statement groups.parse command for older PHP Parser versions.bin/package, to hopefully make our automatic releases go a bit smoother.Add a Hoa\Console-based pure PHP readline fallback, for PHP installs compiled without readline or libedit (Thanks @zonuexe)
Our biggest release notes yet!
New:
updateCheck frequency configuration. It defaults to weekly, but you can set it to always, daily, weekly, monthly or never.isset, unset, empty, etc) in the doc command.psysh-compat as well as psysh phar. The second phar contains polyfills for intl and readline. It's quite a bit bigger, but also quite a bit more useful for PHP installs without all the bells and whistles.Improved:
detect_unicode=Off if compiled under PHP 5.3, because PHP 5.3.And a couple of things I'm prolly more excited about than you:
Fix class not found exception when defining a class which refers to itself.
declare(strict_types=1).A few tweaks to play nicer with HHVM.
self::, parent:: and static:: calls.echo '0' output.More correct "return value" for things like use statements.
exit; act like the exit command (Thanks @damiankloip!)argv in $_SERVER.colorMode configuration and --color or --no-color flags (Thanks @toddmazierski!)useUnicode config option. Set this to false to avoid non-ascii characters in PsySH output, for example if you're on Windows and don't want to fight with code page configuration.Fix Windows config directory logic bug (Thanks @mix5003!)
Change a bunch of old deprecation warnings to exceptions.
errorLoggingLevel and warnOnMultipleConfigs configuration options.class magic constants (Thanks @lvht!)Fix recursion in ValidFunctionNamePass.
Or, as I like to call it, v0.5.0 Done Right™
Or, as I like to call it, v0.5.0 Done Right™
All the goodness from v0.5.0…
New:
dump and return values (Thanks @nicolas-grekas!)\Psy\info() function for help filing and debugging issues.Improved:
Foo::class constants.trace output.Plus one less badness from v0.5.0…
Support PHP 7 (Thanks @GrahamCampbell, etc!)
New:
dump and return values (Thanks @nicolas-grekas!)\Psy\info() function for help filing and debugging issues.Improved:
Foo::class constants.trace output.Fix use statement CodeCleaner pass for PHP Parser 1.2 (Thanks @GrahamCampbell!)
use statement CodeCleaner pass for PHP Parser 1.2 (Thanks @GrahamCampbell!)dump command presenter invocation (Thanks @nicolas-grekas!)Fix a regression when calling dynamic static functions on classes which implement __callStatic.
Fix a regression when calling dynamic static functions on classes which implement __callStatic.
Code style fixes (Thanks @GrahamCampbell and @Markcial!)
eval(\Psy\sh()) outside a class contextA couple PHP 5.3 regression fixes.
Deprecate a bunch of older config options with helpful messages for updating them.
throw-up command for throwing errors out of the current PsySH debug session.ext-pdo-sqlite extension to Composer suggestions, so that fewer people are supprised when they try to use docs.C:\Users\<user>\AppData\Roaming\PsySH.open_basedir (Thanks @dequis!)Fix issue unbinding loop closure (Thanks @jeremeamia!)
Prevent fatal errors when referencing undefined class constants.
\Psy\sh function (Thanks @pitekantrop!)whereami and wtf backtraces.Fix a couple of issues with the whereami command (Thanks @hason and @blainesch!)
whereami command (Thanks @hason and @blainesch!)$bind parameter to Shell::debug() to make bound objects easier to use in the shell.$this binding to the shortcut debug invocation.Suppress deprecation notice for Symfony Console TableHelper
branch-aliaswhereami command to prevent weird encoding issuesshow command, now matches whereami. And looks better :)Same as v0.3.1, but with one less stupid.
Suppress deprecation notice for Symfony Console TableHelper
branch-aliaswhereami command to prevent weird encoding issuesshow command, now matches whereami. And looks better :)Clean up ErrorException messages (Thanks @matthieuprat!)
Lots of things:
unserialize() warnings when the shell returns.empty() "parse errors" in PHP < 5.5.<ArrayObject> ref when presenting ArrayObjects.addPresenters() method to PresenterManager..0)whereami command to show where you are in a file (Thanks @blainesch!)eval(\Psy\sh()) (Thanks @blainesch!)Thanks again for your contributions, @matthieuprat, @GrahamCampbell and @blainesch.
Switch to stable php-parser and xdg-base-dir releases now that they're out.
Composer install will now suggest readline, posix and pcntl.
$PSYSH_CONFIG environment variable.dump -a).Thanks to @staabm, @pilif, @max-voloshin and @lolautruche for their contributions!
Skip binding execution loop on HHVM (so you can run PsySH on HHVM)
Fix return value printing when using namespaces.
Fix CalledClassPass bug when calling expressions.
Fix CalledClassPass bug when calling expressions.
Fix an issue when input is exactly "0".
Fix an issue when input is exactly "0".
Allow overriding PsySH configuration file. e.g. psysh -c /path/to/some/psyshrc.php
psysh -c /path/to/some/psyshrc.phpNothing published for this version
Fix defaultIncludes configuration (thanks @rstruber!)
One column per quarter.