Skip to content

@bobthecow bobthecow released this May 3, 2020


  • 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.


  • 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.
Assets 6

@bobthecow bobthecow released this Apr 7, 2020

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


  • 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 :)


  • 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.
Assets 6

@bobthecow bobthecow released this Mar 21, 2020 · 84 commits to master since this release

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

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

Assets 6

@bobthecow bobthecow released this Mar 15, 2020 · 90 commits to master since this release

This might just be our... BIGGEST. RELEASE. EVER.

Note that PsySH v0.10.0 drops support for PHP < 5.5, and non-LTS HHVM.



  • 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).


  • 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!)


  • 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.
Assets 6

@bobthecow bobthecow released this Dec 6, 2019 · 227 commits to master since this release

  • Update XdgBaseDir dependency to v0.1.*
Assets 6

@bobthecow bobthecow released this Nov 27, 2019 · 230 commits to master since this release

  • Add support for Symfony 5.0 (Thanks @Taluu!)

(Skipping v0.9.10 because I tagged a broken commit 😬)

Assets 6

@bobthecow bobthecow released this Oct 13, 2018 · 238 commits to master since this release

  • 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.
Assets 6

@bobthecow bobthecow released this Sep 5, 2018 · 249 commits to master since this release

  • 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]!
Assets 6

@bobthecow bobthecow released this Aug 11, 2018 · 256 commits to master since this release

  • 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.
Assets 6

@bobthecow bobthecow released this Jun 10, 2018 · 264 commits to master since this release


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


  • 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.
Assets 6
You can’t perform that action at this time.