What’s New in Workerman 5.0? Release, RFC3875 Compliance, and Upgrade Guide

Workerman v5.0.0 has been officially released after two years of development, marking a major milestone with numerous beta and release‑candidate iterations.

RFC3875 Specification

RFC3875 defines the Common Gateway Interface (CGI) version 1.1 standard, which enables web servers to communicate with external programs and return their output as HTTP responses. The specification details CGI’s purpose, requirements, terminology, and the meta‑variables that describe client requests.

Standard:

https://datatracker.ietf.org/doc/html/rfc3875

PHP 8.3 Compatibility with RFC3875

PHP includes a built‑in CGI‑compatible server that now fully follows RFC3875. Prior to PHP 8.3, the $_SERVER['SERVER_SOFTWARE'] value was formatted as PHP %version% Development Server, which violated RFC 3875 section 4.1.17. PHP 8.3 corrects this, exposing the proper format.

- PHP 8.2.0 Development Server
+ PHP/8.3.0 (Development Server)

Workerman 5.0 and RFC3875

Installation

composer require workerman/workerman

./composer.json has been created
Running composer update workerman/workerman
Loading composer repositories with package information
Updating dependencies
Lock file operations: 1 install, 0 updates, 0 removals
  - Locking workerman/workerman (v5.0.0)
Writing lock file
Installing dependencies from lock file (including require‑dev)
Package operations: 1 install, 0 updates, 0 removals
  - Installing workerman/workerman (v5.0.0): Extracting archive
Generating autoload files
1 package you are using is looking for funding.
Use the `composer fund` command to find out more!
No security vulnerability advisories found.
Using version ^5.0 for workerman/workerman

Environment requirements

Ensure PHP version is greater than or equal to 8.0 Make sure Composer uses the official mirror source

Below 5.0

Check Workerman runtime status with:

php start.php status

Workerman[start.php] status
----------------------------------------------GLOBAL STATUS----------------------------------------------------
Workerman version:4.2.1          PHP version:8.2.24
start time:2024-12-10 23:08:37   run 22 days 20 hours
load average: 0.03, 0.01, 0
event-loop:\Workerman\Events\Event
2 workers   9 processes
worker_name  exit_status  exit_count
webman       0            88
monitor      0            0

5.0 and Above

Check Workerman runtime status with the same command:

php start.php status

Workerman[start.php] status
Start worker in DAEMON mode.
---------------------------------------------------GLOBAL STATUS---------------------------------------------------------
Workerman/5.0.0          PHP/8.2.24 (Jit on)          Linux/5.15.0-92-generic
start time:2025-01-01 20:47:32   run 0 days 22 hours
load average: 0, 0, 0
4 workers    11 processes
name                     event-loop    exit_status    exit_count
webman                   revolt        0              0
monitor                  revolt        0              0
plugin.webman.push.server revolt        0              0

Differences Compared to Previous Versions

PHP version string changed from PHP 8.2.24 to PHP/8.2.24 (Jit on).

Workerman version upgraded from 4.2.1 to 5.0.0.

Operating system information added, e.g., Linux/5.15.0-92-generic.

Event‑loop implementation changed from a unified event-loop:\Workerman\Events\Event to per‑process identifiers such as event-loop:revolt.