maxbanton/cwh

Added

• $createStream constructor argument (10th, default true). Set to false to skip DescribeLogStreams + CreateLogStream when the log stream is provisioned out of band (e.g. via Terraform). Lets users drop the matching IAM permissions.
• Full type coverage on the constructor and properties (constructor promotion, readonly for immutable state).
• phpstan (level 8) runs in CI alongside lint and tests.

Changed

• Coding standard upgraded from PSR-2 to PSR-12.
• PHPUnit upgraded to ^10.5 || ^11.0.

Removed

• Support for PHP 7.x and 8.0. Minimum PHP is now ^8.1.
• Support for Monolog 2. Minimum Monolog is now ^3.0.

Migration

• Replace any Monolog\Logger::DEBUG (or other level constant) usage with Monolog\Level::Debug. The $level constructor argument continues to accept int|string|Level so string values like 'debug' keep working.
• Symfony service definitions referencing !php/const Monolog\Logger::WARNING must change to !php/const Monolog\Level::Warning.
• Subclasses overriding protected function write(array $record): void must update the signature to protected function write(\Monolog\LogRecord $record): void and access fields via ->property instead of ['key'].
• The constructor parameter order, names, and defaults of the existing 9 arguments are unchanged. Existing Symfony positional arguments: lists and Laravel with/handler_with named-key configs continue to work after the platform upgrades above.

Added

• Public flush() method for long-lived workers (Laravel queues, Symfony messenger, PHP-FPM with persistent state). The handler's reset() is also overridden to flush, integrating with Symfony ResettableInterface and Laravel Octane's FlushMonologState. (#95, thanks @DrLuke for #102)
• README section documenting ECS / EC2 IAM Task Role credentials with CredentialProvider::memoize(). (#103)
• Docker-based local dev environment (make build, make test, make matrix) running against PHP 8.2 / 8.3 / 8.4 / 8.5.
• CI runs entirely in Docker containers; only actions/checkout and actions/upload-artifact (both official) are used.
• .gitattributes excludes dev files from the Composer dist tarball; composer require maxbanton/cwh now ships only LICENSE, README.md, composer.json, and src/Handler/CloudWatch.php (~57% smaller).

Changed

• EVENT_SIZE_LIMIT raised from 256 KB to 1 MB (1,048,550 bytes) to match the current AWS PutLogEvents quota. Messages between 256 KB and 1 MB are now shipped as a single CloudWatch event instead of split. (#101)

Removed

• RPS_LIMIT self-throttle (5 RPS). The library no longer sleeps to artificially cap PutLogEvents calls — the AWS quota is 5,000 TPS per account/region (1000× higher), and the AWS SDK's retry middleware handles real throttling automatically. (#111, #114)
• sequenceToken tracking. AWS deprecated this parameter in August 2023 — PutLogEvents ignores it server-side and never throws InvalidSequenceTokenException or DataAlreadyAcceptedException anymore. (thanks @a10waveracer for #115)
• The retry-on-CloudWatchLogsException loop in flushBuffer() (it existed solely to refresh the sequence token, which no longer matters).

Fixed

• checkThrottle() had a latent bug — $current->diff($savedTime)->s reads only the seconds component of a DateInterval, misbehaving across minute boundaries. Fixed by removing the method entirely (see "Removed" above).

Compatibility

• No breaking public API changes. Adds public flush() and overrides reset() to flush. Existing constructor and method signatures are unchanged; existing ^2.0 pins continue to work without modification.
• Minimum PHP / Monolog versions unchanged (^7.2 || ^8 / monolog/monolog: ^2.0). CI tests PHP 8.2 – 8.5; no code paths require newer PHP.