Skip to content

Conversation

@dereuromark
Copy link
Owner

@dereuromark dereuromark commented Dec 19, 2025

Summary

Adds comprehensive documentation for displaying live queue job progress in the browser using Mercure and Server-Sent Events.

Contents

  • Overview: How real-time progress works with Mercure
  • Setup: Installing and configuring cakephp-mercure plugin
  • FrankenPHP Integration: Using built-in Mercure hub
  • Example Queue Task: Publishing progress updates via Mercure
  • Controller & Template: Complete working example with EventSource
  • Production Deployment: systemd and supervisor configurations
  • Scaling Workers: Horizontal scaling across servers
  • Testing: Mocking Mercure Publisher in tests

Why This Matters

Real-time progress is one of the most valuable use cases for background jobs - showing users live updates without polling or page refreshes. This documentation fills a gap by showing how to integrate the Queue plugin with modern real-time technologies.

Related

Documents how to display live queue job progress in the browser using:
- Mercure protocol with Server-Sent Events
- FrankenPHP with built-in Mercure hub
- Example queue task with progress publishing
- Controller and template examples
- Production deployment with systemd/supervisor
- Worker scaling configuration
@codecov-commenter
Copy link

codecov-commenter commented Dec 19, 2025

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.35%. Comparing base (ce69d1f) to head (4bd3f8b).
⚠️ Report is 2 commits behind head on master.
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@             Coverage Diff              @@
##             master     #451      +/-   ##
============================================
+ Coverage     72.96%   73.35%   +0.38%     
- Complexity      777      780       +3     
============================================
  Files            41       41              
  Lines          2700     2713      +13     
============================================
+ Hits           1970     1990      +20     
+ Misses          730      723       -7     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Documents the PID 1 issue when running queue workers in Docker containers
and provides solutions using stable hostnames and startup cleanup commands.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants