如何通过Unix套接字编写FastCGI的FCGI_PARAMS参数

你的代码错误点 #

• 长度编码错误：FastCGI的名称/值长度不是直接写入普通整数，而是采用可变长度编码规则：
  • 长度小于128时，用1字节存储，最高位为0
  • 长度大于等于128时，用4字节存储，最高位设1，剩余3字节存储实际长度的二进制值
• 类型混用错误：你直接把字符串和整数混放到Vec中，Rust不允许这种异构类型集合，所有数据必须统一转为u8字节数组
• 缺少标准记录帧：FCGI_PARAMS参数必须包裹在FastCGI标准记录结构中，不能直接裸写键值对字节流

正确实现步骤 #

1. 实现FastCGI长度编码函数 #

fn encode_fcgi_length(len: usize) -> Vec<u8> {
    if len < 128 {
        vec![len as u8]
    } else {
        // 最高位设1，后续3字节存储长度值
        let mut bytes = vec![0x80 | ((len >> 24) & 0xFF) as u8];
        bytes.push(((len >> 16) & 0xFF) as u8);
        bytes.push(((len >> 8) & 0xFF) as u8);
        bytes.push((len & 0xFF) as u8);
        bytes
    }
}

2. 构造单个键值对的字节流 #

fn build_param(key: &str, value: &str) -> Vec<u8> {
    let key_bytes = key.as_bytes();
    let value_bytes = value.as_bytes();
    
    let mut param = Vec::new();
    param.extend_from_slice(&encode_fcgi_length(key_bytes.len()));
    param.extend_from_slice(&encode_fcgi_length(value_bytes.len()));
    param.extend_from_slice(key_bytes);
    param.extend_from_slice(value_bytes);
    
    param
}

3. 构造FCGI_PARAMS标准记录帧 #

FastCGI记录固定结构：

实现记录构造函数：

fn build_fcgi_record(record_type: u8, request_id: u16, content: &[u8]) -> Vec<u8> {
    let content_len = content.len();
    let padding_len = (8 - (content_len % 8)) % 8; // 按8字节对齐填充
    
    let mut record = Vec::new();
    record.push(0x01); // FCGI_VERSION_1
    record.push(record_type);
    record.extend_from_slice(&request_id.to_be_bytes()); // 网络大端序
    record.extend_from_slice(&(content_len as u16).to_be_bytes());
    record.push(padding_len as u8);
    record.push(0x00); // reserved
    record.extend_from_slice(content);
    // 添加填充字节
    record.extend(std::iter::repeat(0x00).take(padding_len));
    
    record
}

4. 完整发送流程示例 #

use std::os::unix::net::UnixStream;
use std::io::Write;

// 上方的encode_fcgi_length、build_param、build_fcgi_record函数需放在此处

fn main() -> std::io::Result<()> {
    // 连接php-fpm的Unix套接字（路径需根据你的php-fpm配置调整）
    let mut socket = UnixStream::connect("/run/php-fpm/www.sock")?;
    
    // 构造所需的CGI参数集合
    let mut params = Vec::new();
    params.extend_from_slice(&build_param("SCRIPT_FILENAME", "/var/www/html/index.php"));
    params.extend_from_slice(&build_param("REQUEST_METHOD", "GET")); // 按需添加其他参数，如CONTENT_TYPE等
    
    // 发送FCGI_PARAMS记录
    let params_record = build_fcgi_record(0x04, 0x0001, &params);
    socket.write_all(&params_record)?;
    
    // 必须发送空FCGI_PARAMS记录，告知php-fpm参数传输结束
    let empty_params_record = build_fcgi_record(0x04, 0x0001, &[]);
    socket.write_all(&empty_params_record)?;
    
    // 若为POST请求，需继续发送FCGI_STDIN记录；之后可读取php-fpm返回的响应
    // ...
    
    Ok(())
}

关键注意事项 #

• 参数结束标记：必须发送内容长度为0的FCGI_PARAMS记录，否则php-fpm会一直等待参数传输完成
• 请求ID一致性：整个请求流程（PARAMS、STDIN、STDOUT等）的请求ID需保持一致
• 字节序要求：记录中的请求ID、内容长度必须使用大端序（网络字节序）
• 参数完整性：除SCRIPT_FILENAME外，php-fpm可能还需要REQUEST_METHOD、CONTENT_TYPE等参数才能正确处理请求

内容的提问来源于stack exchange，提问作者DFG