Changelog

3.0.1 — 2026-09-26

readAvailable() no longer raises a PHP notice ("Device not configured") on every call once the device is gone. Under an event loop that was many thousand notices a second. The contract is unchanged: an empty string, and feof($port->stream()) tells you the port is gone.

Rewritten from scratch under the MIT License. No code from 2.x remains.

SerialPort opens and configures the device in the constructor: baud, data bits, parity, stop bits, flow control.
read, readUntil, readLine with a timeout; readAvailable never waits; stream() for event loops.
SerialPortLocator::candidates() lists serial devices on Linux, macOS and Windows.
Linux and macOS through stty (device opened first, configured second). Windows through mode, not yet verified on hardware.
Tests on real pseudo-terminals via socat; loopback run on a Raspberry Pi in docs/verified-on.md.