All Versions
33
Latest Version
Avg Release Cycle
141 days
Latest Release
22 days ago

Changelog History
Page 1

  • v0.12.23 Changes

    May 23, 2026

    πŸ› Bug fixes

    • πŸ›  Fix interactive readline bracket matching inside interpolated strings. Fixes #930
    • πŸ‘» Avoid infinite recursion in ShellOutput write tracking (e.g. print_r on an Exception with zend.exception_ignore_args = Off). Fixes #934
    • Include --warm-autoload in project trust restrictions
    • Exclude Symfony Console DI components from the autoload warmer (they're an optional dependency and blow up when not installed)

    Under the hood

    • Tighter callable types throughout
    • βž• Added MediaWiki downstream smoke tests, updated to 8.3
    • πŸ›  Fixed Drush downstream tests

  • v0.12.22 Changes

    March 22, 2026

    βš™ Runtime config and clipboard support

    ⚑️ PsySH has a new config command for inspecting and updating runtime-configurable settings during the current session. You can tweak things like pager, theme, verbosity, useSuggestions, useSyntaxHighlighting, clipboardCommand, and semicolonsSuppressReturn without restarting the shell. Fixes #361

    There’s also a new copy command for copying the last result ($_) or any expression to your clipboard. Works with system clipboard commands, or via OSC 52 for SSH and remote terminals.

    πŸ”§ Configure with clipboardCommand or useOsc52Clipboard in your config.

    Semicolon-based return suppression

    πŸ‘ Optionally suppress return values by ending a statement with ;, similar to MATLAB/Octave behavior. Supports a 'double' mode requiring ;; for suppression (if requireSemicolons is also enabled, both true and 'double' require ;;).

    'semicolonsSuppressReturn'=> true,'semicolonsSuppressReturn'=>'double',// Always require ;; to suppress

    πŸ‘» Output and exception display improvements

    Strings are now valid PHP!

    • πŸ›  PsySH now preserves backslashes and other characters it previously mangled in a few cases. Fixes #351, #568
    • πŸš€ Multiline strings are rendered using heredoc-style output rather than triple-quoted strings """. The old format is available via useDeprecatedMultilineStrings until the next major release.

    πŸ›  Providing an exceptionDetails callback via config renders additional context about exceptions (e.g. validation errors) alongside the error message. Fixes #648

    A few other improvements:

    • More consistent compact (and non-compact) output spacing.
    • πŸ“± Responsive help layout adapts to terminal width.

    πŸ‘ Better completion for everyone

    πŸ‘ Legacy readline now shares PsySH’s newer completion engine, which brings much better parity between ext-readline/libedit and experimental interactive readline. Command argument completion, better multiline buffering, and a handful of command-dispatch edge cases now work much more consistently outside experimental readline too.

    Commands can now define their own argument completions via CommandArgumentCompletionAware.

    πŸ’… Interactive readline polish

    πŸ†• New in the experimental interactive readline:

    • Live syntax highlighting β€” code is highlighted as you type. Can be disabled via useSyntaxHighlighting if you don't like colors, I guess.
    • πŸ’… Allman-style indenting β€” opening brackets on a new line get proper indentation.
    • πŸ‘Œ Improved auto-dedent β€” closing brackets automatically reduce indentation.

    psy\info() and --info also report more detail about readline and autocomplete state.

    βš™ Run psysh with --experimental-readline and try it out. It's getting kind of awesome!

    Compatibility note

    Bare config and copy at the prompt now resolve to PsySH commands before PHP function calls. Prefix ambiguous input with ; to force PHP execution.

    πŸ› Bug fixes

    • πŸ‘‰ Use aliases are now tracked by import type (class vs function vs constant), fixing resolution bugs with use function and use const statements.
    • πŸ›  Fix pager pipe warnings when user quits pager early
    • πŸ›  Fix eval error messages incorrectly suppressing PsySH file paths
    • πŸ‘Œ Improve terminal width check on oldest supported Symfony versions
    • πŸ›  Fix a code cleaner bug with throw new Exception in PHP 7.4

    πŸ‘Œ Improvements

    • βž• Added --pager / --no-pager CLI options
    • Richer psy\info() / --info output with interactive completion
    • βž• Added hermetic test bootstrap, PTY smoketests, and additional downstream/composer-repl coverage
    • Ctrl-C now interrupts the edit command instead of waiting for the editor to close

  • v0.12.21 Changes

    March 06, 2026

    βž• Added an experimental interactive readline: a from-scratch pure-PHP readline replacement built specifically for PsySH. Instead of delegating to ext-readline or ext-libedit, this gives PsySH full control over input, editing, completion, and rendering.

    This is opt-in and experimental. Default behavior is completely unchanged. Enable it in your config or from the command line:

    'useExperimentalReadline'=> true,

psysh --experimental-readline

    πŸ‘€ See the interactive readline wiki page for more!

    Completions that actually understand your code

    The new completion engine is syntax-aware, type-aware, and runtime-value-aware. It parses your input, resolves types from live objects in scope, and completes based on what your code actually is, not just string matching on symbol names.

    πŸ‘€ Type $user-> and see that object's actual methods and properties. Chain through $repo->find(1)-> and get completions for the return type. Fuzzy matching means asum finds array_sum and stl finds strtolower. Completions show in a navigable multi-column menu.

    Multi-line editing

    Press Enter on an incomplete statement and the input continues on the next line with proper indentation. Closing brackets auto-dedent. Shift+Enter always inserts a newline. No more fighting the shell to write a multi-line closure.

    History

    • Reverse history search (Ctrl+R) with an overlay showing match highlighting, smart-case filtering, deduplication, and keyboard navigation.
    • Filtered history navigation: type part of a previous command, then press Up/Down to cycle through matching history entries.

    And more

    • πŸ’… Fish-style inline autosuggestions from your history. This one's still a bit rough; enable it separately with 'useSuggestions' => true.
    • Bracket and quote auto-pairing with smart backspace.
    • Bracketed paste mode: pastes multi-line code verbatim without executing line-by-line.
    • No ext-readline or ext-libedit required. Works with any terminal.
    • Ctrl+L to clear the screen.

    This addresses a bunch of long-standing issues: #234, #254, #309, #346, #506, #561, #668, #732, #769, #869.

    0️⃣ We'd love your feedback! Give it a try, and let us know what works and what doesn't. The goal is to make this the default. Help us get it there. πŸ§ͺ

  • v0.12.20 Changes

    February 11, 2026

    πŸ›  Project trust edge case fixes

    πŸ›  Fixed several edge cases with the Restricted Mode introduced in v0.12.19 where non-interactive contexts (piped input, execute() calls, Composer proxy scripts) could incorrectly trigger trust prompts or restrict trusted functionality.

    πŸ›  Fixes #913

    πŸ‘ Commands work better outside the shell

    Decoupled commands from ShellOutput via a new ShellOutputAdapter, so commands degrade gracefully when used in non-interactive contexts rather than failing on missing shell features.

    πŸ‘Œ Improvements

    • βž• Added downstream compatibility tests for local and CI workflows
    • 🚚 Moved internal helper scripts from bin/ to scripts/

  • v0.12.19 Changes

    January 30, 2026

    πŸ”’ ⚠️ Security fix

    πŸ›  Fixed a CWD configuration poisoning vulnerability (CVE-2026-25129) where a malicious .psysh.php file in an attacker-writable directory could execute arbitrary code when a victim runs PsySH from that directory. This affects all versions prior to v0.12.19 and v0.11.23, including downstream consumers like Laravel Tinker, when invoked from an attacker-writable CWD.

    πŸ›  Fixed in v0.12.19 and v0.11.23. Upgrade ASAP.

    Restricted Mode

    PsySH now requires explicit trust before loading project-local config (.psysh.php), local PsySH binaries, or Composer autoloads from untrusted projects. Trust decisions are persisted per-project in trusted_projects.json.

    πŸ”§ Configure with trustProject:

    'trustProject'=>'prompt',// default β€” ask interactively'trustProject'=>'always',// trust all projects'trustProject'=>'never',// always run restricted

    Or use --trust-project / --no-trust-project CLI flags, or the PSYSH_TRUST_PROJECT env var.

    ⚠ Non-interactive sessions automatically skip untrusted features with a warning.

    πŸ‘ Magic method and property support πŸͺ„

    Tab completion, ls, doc, and show commands now recognize @method and @property docblock tags. Magic members display in magenta so you can tell them apart from real methods and properties.

    Inheritance works as expected β€” magic members from parent classes, interfaces, and traits are included, with child declarations taking precedence.

    πŸ“œ Also fixes parsing of generic types (e.g., array<int, string>) in docblock tags, which previously broke on whitespace inside angle brackets.

    πŸ‘€ See #905

    πŸ‘Œ Improvements

    • πŸš€ Excluded a few unnecessary files and folders from release source zips (Thanks @reedy!)
    • πŸ›  Fixed --cwd to actually change the working directory. Previously it only affected discovery for autoload/config, so relative paths and other directory-dependent behavior didn’t work as expected inside the shell.
    • πŸ“œ Significantly improved memory usage with older php-parser versions (pre-v4.18.0)

  • v0.12.18 Changes

    December 17, 2025
    • πŸ›  Fix exit() not working when uopz extension is loaded
    • Don't reopen pager if user closes it early
    • βͺ Ensure stty state is restored before exiting PsySH (fixes an issue where Ctrl-C might be incorrectly handled after exiting)

  • v0.12.17 Changes

    December 15, 2025

    Hot code reloading!!?!?1?

    Install the uopz extension (5.0+) and PsySH will automatically reload modified files during your session. Edit code, switch back to PsySH, and your changes are liveβ€”no restart needed!

    What gets reloaded

    • Method bodies (including private/protected)
    • Function implementations (and new functions!)
    • Class and global constants

    What can't be reloaded

    • πŸ†• New class methods
    • Class properties, inheritance, or interfaces
    • Method signatures

    0️⃣ PsySH skips "risky" reloads by default (conditional definitions, static variables). Use the new yolo command to bypass safety checks:

    >>> my_helper()
Warning: Skipped conditional: if (...) { function my_helper() ... }

>>> yolo !!
=> "result"

    πŸ“š See the documentation for more details.

    πŸ› Bug fixes

    • πŸ›  Fix "array offset on null" warning on Ctrl-C β€” plays nicer with Laravel + PHP 8.5
    • 🐎 Work around O(nΒ²) performance in Symfony OutputFormatter

  • v0.12.16 Changes

    December 07, 2025

    πŸš€ A quick release adding support for Symfony Console v7.4+ and v8.x.

  • v0.12.15 Changes

    November 28, 2025

    βͺ Abbreviated output reverted

    βͺ The abbreviated return value output introduced in v0.12.13 has been reverted. This feature attempted to show shorter output for statements that looked like they were trying to take an action (like assignments and method calls with side effects) while preserving full output for inspection-like statements. Unfortunately, this version of the feature just ... wasn't it.

    πŸ‘ Thanks to everyone who provided feedback. If you've got thoughts on approaches that could make this better, please share them in #512!

    ⚑️ In-shell manual updates

    ⚑️ You can now update the PHP manual directly from inside the shell! Run doc --update-manual to fetch the latest manual version.

    More robust manual handling

    • ⚠ Log a warning (and continue) when trying to read from an invalid manual file
    • πŸ‘‰ Show invalid manual info in --info and \Psy\info()
    • ⚑️ Prompt to clean up invalid manual files when running --update-manual
    • ⚑️ Prompt to upgrade to v3 manual (preserving language selection!) when running --update-manual with an existing sqlite manual
    • ⚑️ Preserve legacy manuals when updating to v3, supporting systems with multiple PsySH versions installed

    πŸ› Bug fixes

    • πŸ›  Fix namespace and use statement edge cases where aliases weren't properly tracked across REPL inputs
    • πŸ›  Fix history command filtering and --head/--tail interaction to apply filters first
    • πŸ›  Fix E_STRICT warning in PHP 8.4
    • πŸ›  Fix ParseCommand parsing (you had one job ΰ² _ΰ² )

    Other improvements

    • βž• Add a hint about doc foo when help foo doesn't match a known command
    • πŸ—„ Don't call deprecated curl_close() on PHP >= 8.0.0 (thanks @mpesari!)
    • πŸ”’ Lock phar build dependencies for reproducible builds
    • πŸ‘Œ Improve PHP 8.5 support
    • πŸ‘Œ Improve test coverage

  • v0.12.14 Changes

    October 27, 2025

    🌲 Logging support

    🌲 Log user input, command invocations, and executed code to a PSR-3 logger or callback.

    // Simple callback$config->setLogging(function($kind,$data) {file\_put\_contents('/tmp/psysh.log',"[$kind] $data\n",FILE\_APPEND);
});// PSR-3 logger with granular control$config->setLogging(['logger'=>$psrLogger,'level'=> ['input'=>'info','command'=>false,// disable'execute'=>'debug',
    ],
]);

    πŸ›  This has been one of our longest-requested features (πŸ™ˆ) and it fixes #821, #651, and #565.

    πŸ“š Huge documentation improvements!

    πŸš€ This release adds a new PHP-based manual data format (v3), replacing the previously used sqlite db. The new format:

    • πŸ‘ Allows runtime formatting (especially wrapping) rather than pre-rendering at build time.
    • βž• Adds OSC 8 links to php.net!
    • Is smaller, faster, and more flexible than the sqlite format.
    • πŸ‘ ... and no longer requires sqlite support to use!

    ⚑️ The phar builds now bundle the PHP manual, so these changes work out of the box. There are also automatic update notifications, an an --update-manual command to keep docs current.

    ⚑️ If you've already got a manual file installed, remove it then run psysh --update-manual (or psysh --update-manual=LANG) after upgrading!

    πŸ›  Fixes #595 and #406.

    Other improvements

    • Prettier formatting for --help output
    • πŸ–¨ Standardized user-facing path pretty printing