v2.1.0 — AWS API alignment, Docker dev env, contributor PRs

[maxbanton]

v2.1.0 maintenance release. No breaking changes.

• Per-event size limit 256 KB → 1 MB ([BUG] Log Event Too Large #101)
• Drop sequence token tracking (AWS deprecated server-side)
• Drop 5 RPS self-throttle (Question about the fix v1.1.4 Throttling Exeption: Rate exceeded #111, [FEATURE] Update to match changes in Cloudwatch #114)
• Public flush() + override reset() for long-lived workers ([BUG] Logs are not sent in Laravel queues #95)
• README: IAM Task Role section for ECS/EC2 ([FEATURE] - Update docs to demo how to leverage IAM Task Roles for ECS #103)
• Docker dev env + CI matrix on PHP 8.2–8.5

Closes #95, #101, #103, #111, #114. Adopts #102, #115.

[Copilot]

Pull request overview

Maintenance release to align the CloudWatch handler with post-2022 AWS CloudWatch Logs API behavior (sequence token deprecation, init flow changes, larger event splitting), while adding a Docker-based dev/CI environment and updating docs/changelog accordingly.

Changes:

• Update CloudWatch handler: remove sequence token + self-throttle, raise event chunk limit, switch init to idempotent create* with ResourceAlreadyExistsException handling, and add flush()/reset() flushing.
• Rewrite unit tests to match the new initialization flow and new flush/reset behavior.
• Add Docker/Compose/Makefile-based dev+CI setup and update documentation/changelog to reflect the release.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
src/Handler/CloudWatch.php	AWS API alignment (no sequence token, no self-throttle), idempotent init, new flush() + reset() behavior.
tests/Handler/CloudWatchTest.php	Updates tests to cover new init strategy and flush/reset behavior.
README.md	Adds IAM Task Role guidance and updates IAM permissions section to remove reliance on Describe*.
CHANGELOG.md	Introduces changelog entries for v2.1.0 release contents.
docker/Dockerfile	Adds a PHP CLI image for containerized dev/CI (Composer + pcov).
compose.yaml	Defines PHP version matrix services for local/dev CI parity.
Makefile	Adds standardized Docker-driven commands for build/lint/test/matrix/coverage.
.github/workflows/php.yml	Replaces setup-php based CI with container-based CI driven by make.
.gitattributes	Excludes dev/CI files from Composer dist exports.
.dockerignore	Shrinks Docker build context.
.gitignore	Ignores generated build/ artifacts.
composer.json	Reformats JSON and updates package metadata.

Comments suppressed due to low confidence (2)

Makefile:35

• The analyse target calls vendor/bin/phpstan, but composer.json doesn’t currently require phpstan in require-dev. Either add the dependency (e.g., phpstan/phpstan) or adjust/remove this target so make analyse works after make install.

analyse:
	$(DC) vendor/bin/phpstan analyse --level=8 src/

Makefile:26

• test-coverage writes to build/logs/clover.xml, but the Makefile never creates build/logs. On a clean checkout this typically causes PHPUnit to fail to open the file and the workflow’s upload step will error. Add a step to create the directory before running PHPUnit (or write to an existing path).

test-coverage:
	$(DC) vendor/bin/phpunit --coverage-text --coverage-clover build/logs/clover.xml

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.