• Support Throwables directly in PsySH commands and output (for legacy reasons we were wrapping Errors in Exceptions, but we don't need to do this anymore!)
• Fix deprecation notices for future Symfony releases (Thanks @Nek-!)

PsySH v0.11.9 includes a lighter, more refined visual style thanks to @nunomaduro and Laravel Tinker! It also introduces a --compact command-line flag, and support for output themes. Check out the wiki for more information.

And if you're ever nostalgic for the old style, add 'theme' => 'classic' to your PsySH config 🙂

PsySH release builds also now feature a self-updater, thanks to @gefd! For future releases, you can run psysh --self-update and it'll pull down the latest build and update in place.

New:

• Clean up console output and styling (Thanks @nunomaduro!)
• Add a flag for --compact output.
• Add support for output themes.
• Add a --self-update option to release builds (Thanks @gefd!)
• Introduce PHPStan for static analysis (Thanks @Wirone!)
• Bypass private constructors with sudo.

Improved:

• Configure system less pager without spawning a shell (Thanks @wdoekes!)
• Add the psysh.org/psysh download URL to the "new version available" message (Thanks @gefd!)
• Fix a few bugs in the userland readline implementation (Thanks @Wirone!)
• Make manual lookups less likely to fail with database errors.
• Disable process forking by default while xdebug is debugging.
• Misc code cleanup.

• Fix error starting PsySH on systems with no Readline (Thanks @daniser!)

• Fix return type warning on tab completion (Thanks @zonuexe!)
• Fix warning output formatting.

New:

• Allow disabling paging entirely by setting 'pager' => false via PsySH config.

Improved:

• Disable paging when TERM=dumb (Thanks @zonuexe!)
• Handle pager failure more gracefully (Thanks @zonuexe!)
• Better handling for systems without terminfo, or with incomplete terminfo capabilities.
• Improve support for union return types.

• Fix PHP 8.2 deprecated string interpolation syntax (Thanks @Ayesh!)
• Fix PHP 8.1 deprecation warnings in Hoa readline code
• Ensure that pre-built phars exclude dependencies with known vulnerabilities
• Set the update checker timeout to 1 second

• Fix missing import in userland readline implementation (Thanks @zonuexe!)

• Enable output paging for stdout and return value dumping.
• Prevent wrapping with the default less paging options. If you want the old style back, add 'pager' => 'less -R -S -F -X' to your PsySH config! (Thanks @ooglek!)
• Fix grapheme polyfill issue when using pre-built phars.
• Remove deprecated hoa/console support.
• Include a userland readline implementation (based on the old hoa/console!).
• Deprecate "compat" builds. Everyone on supported versions of PHP should be able to use the default phar build now!

👆👆 Note that if you've previously used a "compat" build, you don't need to anymore!

• Fix tab completion when input starts with whitespace (Thanks @orange-alien!)
• Fix deprecation notice when running psy\info() in PHP 8.x (Thanks @virtual-designer!)
• Fix type error at exit when using enums in PHP 8.1.
• Stop logging warnings when @ error suppression operator is present.
• Update to latest box and php-scoper versions.
• Disable Box parallel processing in CI.
• Fresh pre-built Phar builds that actually work 😳

• Fix nullable types in the history command (Thanks @tgooren!)
• Add allow-plugins configuration for Composer 2.2 (Thanks @villfa!)
• Improve PHPUnit assertions (Thanks @peter279k!)
• Support variadic placeholder params in PHP 8.1.

Kinda big:

• Drop support for PHP 5.x and HHVM.
• Add support for Symfony 6.
• Bump minimum versions of Symfony and PHP-Parser to merely "ancient" and not "prehistoric".

All the small things:

• Drop function call and constant fetch input validation (PHP can now recover from these at runtime, so we'll just handle the error!)
• Fix bracketed paste support dectection issue for some readline implementations (MinGWEditLine?).
• Add supportsBracketedPaste to the Readline interface.
• All the param types and return types.
• Add @dev and lowest-version dependency testing to CI.

In case you missed it above, PsySH v0.11.0 drops support for PHP 5.x and HHVM.

Please. It's almost 2022. If you're not using PHP 8 already, make that your New Year's resolution.

• Improve compatibility with upcoming Composer 2.2 release.

This release is largely to fix broken pre-built Phars. PsySH v0.11.x will remove support for PHP 5.x and HHVM, but I didn't want to leave y'all with broken binaries on the last version supporting PHP 5.x :)

• Fix pre-built Phars in older versions of PHP.
• Improve doc command output with inherited docs.

Note: Skipping PsySH v0.10.10 due to release script issues.

• Various code style fixes (Thanks @GrahamCampbell!)
• Fix checking pass-by-reference with array fetch.
• Distinctly style integer and float number types (Thanks @1ma!)
• Test against PHP 8.1, minor fixes so tests pass.
• Update HHVM CI environment, which unfortunately required us to drop testing for all but one HHVM version.

Note that PsySH v0.11.x will remove support for PHP 5.x and HHVM. That means this is quite likely the last release for either of those.

• Add support for accessing private properties and consts from parent classes via sudo.
• Make psy\info() more resilient when extending Psy\Shell rather than using it directly.
• Set $__file and $__dir magic variables after calling show $path.
• Clean up path configuration, make it testable.
• Add more smoketests to the phar build.

Note that v0.10.8 officially removes support for PHP 5.5 in the pre-built phars. They've been broken in PHP 5.5 since v0.10.0 a year ago, due to an incompatibility in the library we use to isolate code, so this is mostly about messaging that incompatibility.

Users who need to use PsySH under PHP 5.5 can continue to install via Composer, or download pre-built phars from v0.9.x.

New:

• Add a --yolo mode for running PsySH without input validation. Most of the time you don't want this, but now it's there as an escape hatch.

Improved:

• Extend runkit reloading support to runkit7 (limited to versions below 4.0.0a1, unfortunately) (Thanks @maxime-aknin!)
• Fix non-nullable internal function deprecation notice in PHP 8.1 (Thanks @Ayesh!)
• Fix namespace alias resolution in reflecting commands. Class aliases used to work, but aliasing a namespace and referencing a class inside that namespace would fail.
• Support aliases in reflecting commands when a namespace is set. Previously, commands like list would support either class name aliases or setting a current namespace, but not both. why_not_both.gif
• Fix eval(psy\sh()) calls from non-class contexts in PHP >8.0.
• Updated StyleCI config (Thanks @GrahamCampbell!)

• Suppress exit message in non-interactive mode.
• Exclude BreakException from user exception treatment.
• Don't enforce uniqueness for anonymous class names (since they're all null).
• Add smoketests to the phar build.
• Bring back CI tests for HHVM (Thanks @GrahamCampbell!)

New:

• PsySH + PHP 8.0 == <3
  • Better function signature rendering in PHP 8.0.
  • Support rendering union types in PHP 8.0.
  • Add return types to function signatures when available.
  • Fix tab completion for namespaced classes in PHP 8.0.
  • Get all tests passing in PHP 8.0!
• All-new CI setup, improved testing:
  • Move testing and releases from Travis to GitHub Actions (Thanks for all the help on this, @GrahamCampbell!)
  • Update a ton of tests to work on the latest PHPUnit.
  • Test PHP 8.0 on CI.
  • Drop CI tests for HHVM. It doesn't play nice with Composer 2 :-/

Improved:

• Improve pre-built phar version strings (to make reporting bugs easier!)
• Fix unintentional slash normalization when printing exception messages
• Fix instanceof check in PHP 7.3+
• Make error messages for read-only temp dirs more clear (Thanks @shapito27)
• Fix error when HOMEDRIVE is undefined on Windows (Thanks @emargareten!)
• Fix class existence validation in the unexecuted half of ternaries.
• Use catchable errors for new, class constant fetch, and static calls with non-existant classes in PHP 7+, rather than preventing them entirely.
• Write code executed to stderr when running with --debug verbosity.
• Better bracketed paste support detection.
• Prevent fatal errors on isset() calls.
• Load user-defined includes using include_once. Prevents issues when multiple interactive sessions happen in the same request (Thanks @Aryess!)
• Use a less-strict shell history signature check. Fixes issues with some Libedit-based readline libraries.
• Fix requiring local files when running from a pre-built phar.
• Code style updates (Thanks @GrahamCampbell!)
• Even more code style updates!

New:

• Print exception traces when running --verbose or higher.
• Add an --all option to the doc command for showing inherited docs.
• Include class signatures when using doc on class methods or properties.
• Add graceful handling for invalid return types.
• Add a notice when globally-installed PsySH defers to a local dependency.

Improved:

• Fix doc rendering when docblock description is missing (Thanks @GrahamCampbell!)
• More clear error messages when config files are invalid.
• Fix STDIN input detection when running the cli-server SAPI.
• Remove unhelpful deprecation warning in throw-up command.
• Remove getenv and putenv calls in favor of direct $_SERVER superglobal access.

This one's almost too big for a point release!

New:

• New command line options:
  • --interactive and --no-interactive, to explicitly enable or disable interactive mode.
  • --verbose, --quiet and -v/-vv/-vvv for output verbosity. This one kind of worked before, but only sometimes, and only kind of :)
  • ... and a bunch of aliases, for those familiar with Symfony, Composer and other tools.
• New and improved command line option handling, making it easier for libraries that wrap PsySH to support the same options as psysh does!
• New configuration options:
  • verbosity, equivalent to the -v, -vv, -vvv and --silent command line options.
  • interactiveMode, equivalent to --interactive and --no-interactive command line options.
  • formatterStyles, for overriding command line colors.
• Default to non-interactive mode when input is coming from a pipe.
• Cleaner output when using --raw-output, or STDOUT is redirected.
• Exceptions and errors are now written to STDERR not STDOUT, which makes it easier to split them off from desired output.
• Brand new shiny code formatter. It's more consistent between different commands, the colors match class and method signatures in ls and elsewhere, the line numbers are the same style and colors as in history, etc.
• Tab completion for interfaces, as well as classes (Thanks @GrahamCampbell!)
• The ls command can now list namespaces! This means, for example, that ls --classes Psy will return all known classes inside the Psy namespace. This works for constants, functions, interfaces and traits as well.
• The show command now shows files! Try show __DIR__ . '/vendor/autoload.php'. This is super handy when combined with the $__file magic variable set by ls and doc :)

Improved:

• Support redisplay in HOA/Console readline (Thanks @zonuexe!)
• The show command now includes doc comments for classes, interfaces, traits, functions and methods.
• The whereami command now has a --file option for showing the entire file.
• Set the PsySH process title without the proctitle extension.
• Fix an issue with pre-packaged phar releases which added a couple of unnecessary functions to the global namespace.
• Fix a bug parsing single-line docblocks for the doc command.
• Fix a small bug parsing code in sudo, parse and throwup commands.
• A bunch of housekeepking and general cleanup (Thanks @GrahamCampbell!)
• Modernize some code.

• Work around bug with code isolation in pre-packaged phars.

(Skipping v0.10.1, which was supposed to fix this but didn't)

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:

• Isolate code in bundled phar releases. This means if you download a pre-packaged PsySH binary, it can't collide with code you have installed locally in your project (Thanks @theofidry!)
• Allow conditional bindings in .inputrc and .editrc (Thanks @tgr!)
• Add support for verbosity and interactivity flags ... try -q, -v and -n (Thanks @aksonnic!)
• Several improvements for non-interactive UX:
  • Support executing stdin, make it play nice with the rest of non-interactive mode.
  • Add support for --raw-output (-r) for printing var_export-style return values with non-interactive input.
  • Suppress startup messages when running with --raw-output and --no-interaction
  • Only output bracketed paste control characters when interactive.
  • Stop paginating non-interactive and raw output.
• Add support for namespace and use declarations in reflecting commands (ls, doc, etc).

Improved:

• Better instanceof checks, catching more fatal errors before they fatal (Thanks @baukevdw!)
• Add a check for empty $array[] expressions outside of the left-hand side of an assignment.
• Add a check for goto with an invalid label (Thanks @zonuexe!)
• Support passing unpacked arrays by reference.
• Improve output of the ls command with constants:
  • Make category=internal and category=user equivalent to --user and --internal
  • Make category option case-insensitive
  • Fix "Interal Constants" typo that's been there basically forever
  • Add appropriate-case labels for constant categories (e.g. JSON instead of Json)
• Suppress inherited private methods when listing methods on a class.
• Prevent shadowing namespace names when they collide with other use statement prefixes.
• Fix function signature formatting for optional array params.
• Warn if libedit refuses to write history file. Because apparently it does that sometimes.
• Clearer error message when mkdir fails while setting up PsySH (Thanks @GrahamCampbell!)
• Test against PHP 7.3 and 7.4 on CI (Thanks @andreybolonin, @alexeyshockov, and @GrahamCampbell!)
• Add support for Symfony 5 (Thanks @Taluu!)
• Fix Symfony 4.1 table deprecation notices.
• Fix some PHP 7.4 deprecations in the PsySH codebase (Thanks @ejunker, @Salmatron)
• Fix some longstanding inconsistencies when running under HHVM.
• Make commands --help option more lenient.
• Use white text instead of black for error messages (Thanks @kristianklok!)
• Don't throw error exceptions for warnings or notices. Log them and continue, just like you'd expect.
• Clean up interactive vs non-interactive mode code.
• More robust detection for pcntl and posix extension support.
• Improve test coverage.
• Code cleanup (Thanks @GrahamCampbell, @carusogabriel and PHPStan!)
• Update docblock copyright years.
• Move PHPUnit and Box to composer bin dependencies.
• Exclude unnecessary files and folders from release archives (Thanks @ankurk91!)

Removed:

• Drop support for PHP 5.4 and non-LTS HHVM. All y'all should join us in the future!
• Remove the 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.
• The --version short flag has changed to -V, as -v is now used for verbosity (matching Symfony Console defaults).
• Remove deprecated InterfaceEnumerator and TraitEnumerator (which have been unused for several releases).
• Put HHVM on life support. Test against the LTS release of HHVM 3. Skip a bunch of known failing tests.

• 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 into.
• Fix a bug where context variables were overwritten if the last line resulted in an error.
• Remove 1024 character length limitation for input on systems without readline.
• Bump dependencies on php-console-highlighter and Box.

• Add support for static calls on traits (Thanks @zonuexe!)
• Improve test coverage (a bit)
• Improve list assignment support... do fancy things like [$a[0], $a[1]] = [1, 2]!

• Fix regression updating execution scope with variables declared by commands.
• Fix class constant reflection in PHP 7.2.
• Remove dependency on ctype extension.
• Declare explicit dependencies on json and tokenizer extensions.
• Use fully-qualified names for core function calls.
• Minor code cleanup.

New:

• Throw strings via throw-up command (e.g. throw-up "Wheee!")

Improved:

• More accurate timeit command. It used to count the time to parse input and serialize return values. Now it doesn't.
• Fix a bug preventing throw-up from working with some code input.
• Fix bug preventing omitted items in list() from working at all.
• A bunch more test coverage.

New:

• Add documentation support for built-in and magic constants! You'll need to update your manual DB to get the latest hotness :)

Improved:

• Make process forking more resilient to interrupted system calls.
• Use \ReflectionClassConstant in PHP >= 7.1.
• A bunch of automated build fixes (the last one … wasn't so automated).
• Add a bit more test coverage.

New:

• Add support for a bound class when starting PsySH from inside a static class context.
• Add support for self and static in commands like ls, show and doc.
• Add tab completion for doc, ls and show commands (Thanks @lvht!)
• Switch to Box for phar generation (Thanks @theofidry!)
• Add an iconv polyfill to the "compat" build dependencies.
• Add a code cleaner pass to detect issues with destructuring assignment via list and [] (Thanks @zonuexe!)
• Add a bunch of test coverage.

Improved:

• Fix a minor bug closing input buffer hitting enter twice after a line ending in a backslash.
• Fix false positives when matching command names, for example, if a line started with a command name in a quoted string.
• Fix tab completion for methods, properties and constants of namespaced classes.
• Stop executing commands inside strings that wrap onto multiple lines. I'm not sure whether this ever happened in real life, but it's kind of ridiculous and now it won't :P
• Fix a reference assignment regression from v0.9.x.
• Fix incorrect signature for traits in PHP 5.x. The reflection API says they're abstract public trait X, but we'll just call them trait X.
• Fix using doc command with language constructs.
• Fix the line number reported for some type errors.