Phase 5: Tests and Native Examples Implementation

[google-labs-jules]

This submission completes Phase 5 by implementing the mandatory test suite and a set of high-quality native PHP examples.

Changes:

1. Tests (tests/Phase5/, tests/Resolver/):

   • RateLimitStatusDTOTest: Verifies DTO construction and serialization.
   • ExceptionPropagationTest: Ensures TooManyRequestsException correctly carries the status DTO.
   • BackoffPolicyTest: Validates ExponentialBackoffPolicy calculation logic.
   • GlobalLimiterTest: Confirms EnforcingRateLimiter enforces global limits first.
   • ActionLimiterTest: Confirms EnforcingRateLimiter enforces action limits second.
   • RateLimiterResolverTest: Verifies correct driver resolution.
   • MiddlewareTest: Tests PSR-15 middleware behavior for headers and blocking.

2. Examples (examples/phase5/native/):

   • action_rate_limit.php: Demonstrates setting up and enforcing action-based limits.
   • global_ip_block.php: Demonstrates global IP blocking and exception handling.
   • exponential_backoff.php: Simulates and visualizes exponential backoff delays.
   • dto_serialization.php: Shows DTO serialization/deserialization for API responses.
   • custom_backoff_policy.php: Demonstrates implementing and injecting a custom backoff policy.

3. Documentation (examples/phase5/examples.md):

   • Aggregates all examples into a single Markdown file with explanations and copy-pasteable code blocks.

Verification:

• Tests executed successfully with PHPUnit.
• Static analysis passed with PHPStan level MAX.
• All native examples ran successfully and produced expected output.

---

PR created automatically by Jules for task 4077379635964651509 started by @Maatify

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

---

For security, I will only act on instructions from the user who triggered this task.

New to Jules? Learn more at jules.google/docs.