NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1593 most downloaded on Packagist
Async, event-driven console input & output (STDIN, STDOUT) for truly interactive CLI applications, built on top of ReactPHP
Latest stable
v2.7.0
Last release 5 months ago
14 Jun 2026
Ships unpredictably
gaps range from 2 weeks to 4.2 years
Nearly every release is documented
notes for 17 of 17 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
17 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Feature: Improve PHP 8.5+, PHP 8.4+, PHP 8.3+ and PHP 8.2+ support and update test environment. (#112, #109 and #103 by @clue, #107 by @SimonFrings an
Feature: Improve PHP 8.5+, PHP 8.4+, PHP 8.3+ and PHP 8.2+ support and update test environment. (#112, #109 and #103 by @clue, #107 by @SimonFrings and #106 by @yadaiio)
Minor documentation improvements. (#105 by @yadaiio)
Improve test suite to ensure 100% code coverage, skip flaky tests and fix legacy tests. (#108, #113 and #111 by @clue and #102 by @SimonFrings)
Feature: Full support for PHP 8.1 release. (#101 by @cdosoftei)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Feature: Simplify usage by supporting new default loop. (#99 by @clue)
Feature: Simplify usage by supporting new default loop. (#99 by @clue)
// old (still supported)
$stdio = new Clue\React\Stdio\Stdio($loop);
// new (using default loop)
$stdio = new Clue\React\Stdio\Stdio();
Improve code examples and documentation. (#100 by @clue and #98 by @PaulRotmann)
Use GitHub actions for continuous integration (CI). (#97 by @SimonFrings)
Fix: Refactor executing functional tests without ext-readline. (#95 by @clue)
Fix: Refactor executing functional tests without ext-readline. (#95 by @clue)
Improve test suite and add .gitattributes to exclude dev files from export.
Prepare PHP 8 support, update to PHPUnit 9 and simplify test matrix.
(#93 and #94 by @SimonFrings)
Deprecated: Deprecate Readline class and move all methods to Stdio. (#84 by @clue)
Feature: Emit audible/visible BELL signal when using a disabled function. (#86 and #87 by @clue)
By default, this project will emit an audible/visible BELL signal when the user tries to execute an otherwise disabled function, such as using the <kbd>left</kbd> or <kbd>backspace</kbd> keys when already at the beginning of the line.
Deprecated: Deprecate Readline class and move all methods to Stdio.
(#84 by @clue)
// deprecated:
$stdio->getReadline()->setPrompt('> ');
// recommended alternative:
$stdio->setPrompt('> ');
Fix: Fix closing to emit final close event and clean up all listeners.
(#88 by @clue)
Improve test suite to test against legacy PHP 5.3 through PHP 7.3 and support PHPUnit 7. (#85 by @clue)
Feature / Fix: Accept CR as an alias for LF to support more platforms. (#79 by @clue)
Feature / Fix: Accept CR as an alias for LF to support more platforms. (#79 by @clue)
The <kbd>enter</kbd> key will usually end the line with a \n (LF)
character on most Unix platforms. Common terminals also accept the
<kbd>^M</kbd> (CR) key in place of the <kbd>^J</kbd> (LF) key.
By now allowing CR as an alias for LF in this library, we can significantly
improve compatibility with this common usage pattern and improve platform
support. In particular, some platforms use different TTY settings (icrnl,
igncr and family) and depending on these settings emit different EOL
characters. This fixes issues where <kbd>enter</kbd> was not properly
detected when using ext-readline on Mac OS X, Android and others.
Fix: Fix and simplify restoring TTY mode when ext-readline is not in use.
(#74 and #78 by @clue)
Update project homepage, minor code style improvements and sort dependencies. (#72 and #81 by @clue and #75 by @localheinz)
Feature: Add support for binding custom functions to any key code. (#70 by @clue)
Feature: Add support for binding custom functions to any key code. (#70 by @clue)
$readline->on('?', function () use ($stdio) {
$stdio->write('Do you need help?');
});
Feature: Add addInput() helper method.
(#69 by @clue)
$readline->addInput('hello');
$readline->addInput(' world');
BC break: Remove all deprecated APIs (individual Stdin, Stdout, line etc.) (#64 and #68 by @clue)
A major compatibility release to update this package to support all latest ReactPHP components!
This update involves a minor BC break due to dropped support for legacy versions. We've tried hard to avoid BC breaks where possible and minimize impact otherwise. We expect that most consumers of this package will actually not be affected by any BC breaks, see below for more details.
BC break: Remove all deprecated APIs (individual Stdin, Stdout, line etc.)
(#64 and #68 by @clue)
All of this affects only what is considered "advanced usage". If you're affected by this BC break, then it's recommended to first update to the intermediary v1.2.0 release, which provides alternatives to all deprecated APIs and then update to this version without causing a BC break.
Feature / BC break: Consistently emit incoming "data" event with trailing newline unless stream ends without trailing newline (such as when piping). (#65 by @clue)
Feature: Forward compatibility with upcoming Stream v1.0 and EventLoop v1.0
and avoid blocking when STDOUT buffer is full.
(#68 by @clue)
Deprecated: Deprecate input helpers and output helpers and recommend using Stdio as a normal DuplexStreamInterface instead. (#59 and #62 by @clue)
Feature: Optionally use ext-readline to enable raw input mode if available.
This extension is entirely optional, but it is more efficient and reliable
than spawning the external stty command.
(#63 by @clue)
Feature: Consistently return boolean success from write() and
avoid sending unneeded control codes between writes
(#60 by @clue)
Deprecated: Deprecate input helpers and output helpers and
recommend using Stdio as a normal DuplexStreamInterface instead.
(#59 and #62 by @clue)
// deprecated
$stdio->on('line', function ($line) use ($stdio) {
$stdio->writeln("input: $line");
});
// recommended alternative
$stdio->on('data', function ($line) use ($stdio) {
$stdio->write("input: $line");
});
Improve test suite by adding forward compatibility with PHPUnit 6 (#61 by @carusogabriel)
Feature: Explicitly end stream on CTRL+D and emit final data on EOF without EOL. (#56 by @clue)
Feature: Explicitly end stream on CTRL+D and emit final data on EOF without EOL. (#56 by @clue)
Feature: Support running on non-TTY and closing STDIN and STDOUT streams. (#57 by @clue)
Feature / Fix: Restore blocking mode before closing and restore TTY mode on unclean shutdown. (#58 by @clue)
Improve documentation to detail why async console I/O is not supported on Microsoft Windows. (#54 by @clue)
Improve test suite by adding PHPUnit to require-dev, fix HHVM build for now again and ignore future HHVM build errors and lock Travis distro so future defaults will not break the build. (#46, #48 and #52 by @clue)
First stable release, now following SemVer.
Contains no other changes, so it's actually fully compatible with the v0.5.0 release.
Feature: Add history support. (#40 by @clue)
Buffer, ProgressBar and Spinner (mostly dead code)
(#39, #43 by @clue)Feature / BC break: The Stdio is now a well-behaving duplex stream (#35 by @clue)
Stdio is now a well-behaving duplex stream
(#35 by @clue)Readline is now a well-behaving readable stream
(#32 by @clue)Readline::getPrompt() helper
(#33 by @clue)Fix: Support calling Readline::setInput() during line event
Readline::setInput() during line event
(#28)$stdio->on('line', function ($line) use ($stdio) {
$stdio->getReadline()->setInput($line . '!');
});
Feature: Support multi-byte UTF-8 characters and account for cell width
Feature: Support echo replacements (asterisk for password prompts)
$stdio->getReadline()->setEcho('*');
$stdio->getReadline()->setInput('hello');
$stdio->getReadline()->getCursorPosition();
$stdio->getReadline()->setPrompt('Password: ')->setEcho('*')->setInput('secret');
Feature: Support echo replacements (asterisk for password prompts). (#11)
$stdio->getReadline()->setEcho('*');
Feature: Add accessors for text input buffer and current cursor position. (#8 and #9)
$stdio->getReadline()->setInput('hello');
$stdio->getReadline()->getCursorPosition();
Feature: All setters now return self to allow easy method chaining. (#7)
$stdio->getReadline()->setPrompt('Password: ')->setEcho('*')->setInput('secret');
Feature: Only redraw() readline when necessary. (#10 and #14)
* First tagged release.
One column per quarter.