symfony/polyfill-io-poll

Symfony polyfill for the Io\Poll API

1.x-dev 2026-07-02 13:42 UTC

Requires

• php: >=8.1

MIT

• Nicolas Grekas
• Symfony Community

• io
• poll
• compatibility
• portable
• polyfill
• shim

Published on Packagist.org on 2026-07-05 07:22 UTC

README

This component provides the Io\Poll API added to PHP 8.6 core, for PHP >= 8.1:

• Io\Poll\Context, Io\Poll\Watcher and StreamPollHandle
• Io\Poll\Backend and Io\Poll\Event enums
• Io\IoException and the Io\Poll\*Exception hierarchy

The polyfill is backed by stream_select(), so only the Poll backend is available and edge-triggering is not supported. Event detection follows the semantics of the native poll backend as closely as select() allows: Event::Error is only reported for connection resets, Event::ReadHangUp is never reported, and a TCP half-close reports Read|HangUp where native reports plain Read. The phpt tests of the native implementation, borrowed from php-src, run against the polyfill as part of the test suite.

More information can be found in the main Polyfill README.

License

This library is released under the MIT license.