symfony/polyfill-io-poll

Symfony polyfill for the Io\Poll API

Maintainers

Package info

github.com/symfony/polyfill-io-poll

Homepage

pkg:composer/symfony/polyfill-io-poll

Transparency log

Fund package maintenance!

fabpot

nicolas-grekas

symfony.com/sponsor

Tidelift

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Security

Advisories: 0

Aikido package health analysis

v1.41.0 2026-07-02 13:42 UTC

Requires

  • php: >=8.1

MIT 958ecd830a393d3f21b8677d81402da098c7e5c4

iopollcompatibilityportablepolyfillshim

Published on Packagist.org on 2026-07-28 08:42 UTC

This package is auto-updated.

Last update: 2026-08-07 13:11:34 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.

Context::wait() takes its timeout as a Time\Duration. That class is not required to call wait() without a timeout; install symfony/polyfill-time to build one on PHP < 8.6.

More information can be found in the main Polyfill README.

License

This library is released under the MIT license.