Reflection API for Swoole web-server

3.1.0 2023-06-12 19:37 UTC

This package is auto-updated.

Last update: 2024-06-12 21:43:40 UTC


This library provides a Reflection API for classes of Swoole / Open Swoole web-server.


  • Server middleware manipulation
  • Response lifecycle tracking


The library is to be installed via Composer as a dependency:

composer require upscale/swoole-reflection


Middleware Manipulation

Override server middleware optionally reusing the original callback:

$server = new \Swoole\Http\Server('', 8080);
$server->on('request', function ($request, $response) {
   $response->end("Served by Swoole server\n");

$reflection = new \Upscale\Swoole\Reflection\Http\Server($server);
$middleware = $reflection->getMiddleware();
$reflection->setMiddleware(function ($request, $response) use ($middleware) {
   $response->header('Content-Type', 'text/plain');
   $middleware($request, $response);


Response Lifecycle

Headers Tracking

Modify response headers before they have been sent:

$server->on('request', function ($request, $response) {
    $callback = function () use ($request, $response) {
        $response->header('Content-Type', 'text/plain');
    $response = new \Upscale\Swoole\Reflection\Http\Response\Observable($response);
    $response->end("Served by Swoole server\n");

Callback is invoked on every request upon the first call to \Swoole\Http\Response::write/end/sendfile().

Warning! Callbacks that need to modify response must use the original response rather than its observable proxy. Dependency on observable proxy creates circular reference between the proxy and callbacks registered within it. Instances involved in orphan circular cross-references will not be destroyed until the next garbage collection cycle. Swoole calls \Swoole\Http\Response::end() in the response destructor executed upon the request completion. The response destructor will not be called causing the the worker to hang up without sending the response.

Body Interception

Modify response body before sending it out:

$server->on('request', function ($request, $response) use ($server) {
    $response = new \Upscale\Swoole\Reflection\Http\Response\Observable($response);
    $response->onBodyAppend(function (&$content) use ($server) {
        $content .= "<!-- Served by worker {$server->worker_id} -->\n";
    $response->header('Content-Type', 'text/html');
    $response->end("Served by <b>Swoole server</b>\n");

Callback is invoked on every call to \Swoole\Http\Response::write/end() with non-empty contents.


Pull Requests with fixes and improvements are welcome!


Copyright © Upscale Software. All rights reserved.

Licensed under the Apache License, Version 2.0.