当前位置：首页 > PHP

php实现fastcgi协议

2026-02-16 12:04:07PHP

PHP 实现 FastCGI 协议

FastCGI 是一种用于 Web 服务器（如 Nginx、Apache）与应用程序（如 PHP）通信的协议。PHP 本身通过 PHP-FPM（FastCGI Process Manager）实现了 FastCGI 协议，但也可以手动实现 FastCGI 通信。

FastCGI 协议基础

FastCGI 协议基于二进制格式，通过 TCP 或 Unix Socket 传输。核心结构包括：

请求头（FCGI_Header）：包含请求类型、请求 ID、内容长度等信息。
请求体（FCGI_Body）：包含具体的数据（如环境变量、HTTP 请求内容）。

常见的请求类型：

FCGI_BEGIN_REQUEST：开始一个请求。
FCGI_PARAMS：传递环境变量。
FCGI_STDIN：传递标准输入（如 POST 数据）。
FCGI_STDOUT：返回标准输出（响应内容）。
FCGI_END_REQUEST：结束请求。

实现 FastCGI 客户端

以下是一个简单的 PHP 实现 FastCGI 客户端的示例代码：

<?php
// 连接 FastCGI 服务（如 PHP-FPM）
$socket = stream_socket_client('unix:///var/run/php/php7.4-fpm.sock');

// 构造 FastCGI 请求头
function buildHeader($type, $requestId, $contentLength, $paddingLength = 0) {
    return pack(
        'CCnnCx',
        1,            // 版本号
        $type,        // 请求类型
        $requestId,   // 请求 ID
        $contentLength, // 内容长度
        $paddingLength  // 填充长度
    );
}

// 构造 BEGIN_REQUEST 请求体
$beginRequestBody = pack('nCx5', 1, 0); // 角色为响应器，标志为 0

// 发送 BEGIN_REQUEST
$header = buildHeader(1, 1, strlen($beginRequestBody));
fwrite($socket, $header . $beginRequestBody);

// 发送环境变量（FCGI_PARAMS）
$params = [
    'SCRIPT_FILENAME' => '/path/to/script.php',
    'REQUEST_METHOD'  => 'GET',
    'QUERY_STRING'    => 'foo=bar',
];

$paramsBody = '';
foreach ($params as $key => $value) {
    $paramsBody .= pack('NN', strlen($key), strlen($value)) . $key . $value;
}

$header = buildHeader(4, 1, strlen($paramsBody));
fwrite($socket, $header . $paramsBody);

// 发送空的 FCGI_PARAMS 表示结束
$header = buildHeader(4, 1, 0);
fwrite($socket, $header);

// 发送空的 FCGI_STDIN 表示结束
$header = buildHeader(5, 1, 0);
fwrite($socket, $header);

// 读取响应
$response = '';
while (!feof($socket)) {
    $response .= fread($socket, 4096);
}

fclose($socket);

// 解析响应（跳过 FastCGI 头）
$pos = strpos($response, "\r\n\r\n");
if ($pos !== false) {
    $response = substr($response, $pos + 4);
}

echo $response;
?>

关键点说明

连接方式：
- FastCGI 通常通过 Unix Socket（如 /var/run/php/php-fpm.sock）或 TCP（如 127.0.0.1:9000）通信。
- 使用 stream_socket_client 建立连接。
请求构造：
- FCGI_BEGIN_REQUEST 表示开始一个请求。
- FCGI_PARAMS 传递环境变量（如 SCRIPT_FILENAME、REQUEST_METHOD）。
- FCGI_STDIN 传递输入数据（如 POST 内容）。
响应解析：
- FastCGI 响应可能包含多个数据块，需跳过 FastCGI 头提取实际内容。