Skip to content

Add Streamforge proxy integration for high-performance uploads#8

Merged
signalforger merged 1 commit into
mainfrom
feature/detect-streamforge
Jan 14, 2026
Merged

Add Streamforge proxy integration for high-performance uploads#8
signalforger merged 1 commit into
mainfrom
feature/detect-streamforge

Conversation

@signalforger
Copy link
Copy Markdown
Contributor

When Streamforge FastCGI proxy is deployed between nginx and php-fpm, it handles file uploads by writing them to disk before PHP starts, freeing PHP workers from I/O wait during slow uploads.

Integration features:

  • Automatic detection via HTTP_X_STREAMFORGE and HTTP_X_UPLOAD_FILE_COUNT
  • Transparent UploadedFile creation from streamforge metadata headers
  • Request::isStreamforgeEnabled() static method for userland detection
  • RSHUTDOWN cleanup of unmoved temp files to prevent disk leaks
  • Zero changes required to existing application code

Protocol: Streamforge sends HTTP_X_UPLOAD_N_* headers with file metadata (NAME, FILENAME, PATH, SIZE, TYPE) instead of populating $_FILES.

Adds comprehensive README section documenting the integration.

When Streamforge FastCGI proxy is deployed between nginx and php-fpm,
it handles file uploads by writing them to disk before PHP starts,
freeing PHP workers from I/O wait during slow uploads.

Integration features:
- Automatic detection via HTTP_X_STREAMFORGE and HTTP_X_UPLOAD_FILE_COUNT
- Transparent UploadedFile creation from streamforge metadata headers
- Request::isStreamforgeEnabled() static method for userland detection
- RSHUTDOWN cleanup of unmoved temp files to prevent disk leaks
- Zero changes required to existing application code

Protocol: Streamforge sends HTTP_X_UPLOAD_N_* headers with file metadata
(NAME, FILENAME, PATH, SIZE, TYPE) instead of populating $_FILES.

Adds comprehensive README section documenting the integration.
@signalforger signalforger requested a review from yordadev January 14, 2026 12:58
@signalforger signalforger force-pushed the feature/detect-streamforge branch from 0b92d0f to 9a7c599 Compare January 14, 2026 12:58
@signalforger signalforger merged commit 13f027e into main Jan 14, 2026
4 checks passed
@sean-clarity
Copy link
Copy Markdown

🚀 🚀

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.

2 participants