C++ TinyWebServer：一个轻量级高性能Web服务器项目

icy 昨天 16 抢沙发

默认

摘要： C++ TinyWebServer：一个轻量级高性能Web服务器项目项目概述 TinyWebServer 是一个基于 C++11 开发的轻量级、高性能的 Web 服务器项目，由开...

C++ TinyWebServer：一个轻量级高性能Web服务器项目

项目概述

TinyWebServer 是一个基于 C++11 开发的轻量级、高性能的 Web 服务器项目，由开发者 qinguoyi 创建并维护。该项目采用现代 C++ 编程范式，实现了完整的 HTTP 服务器功能，是学习网络编程、多线程编程和服务器架构的优秀实践项目。

核心特性

1. 高性能架构设计

多线程模型：采用线程池技术处理并发连接
I/O 多路复用：使用 epoll 实现高效的 I/O 事件驱动
非阻塞 I/O：全异步非阻塞网络编程模型

2. 完整 HTTP 协议支持

支持 HTTP/1.1 协议
实现 GET、POST 等常用请求方法
支持持久连接（Keep-Alive）
完整的 HTTP 响应状态码处理

3. 模块化设计

清晰的模块划分：网络模块、日志模块、数据库连接池等
易于扩展和维护的代码结构

项目架构详解

线程池实现

text

// 线程池核心代码示例
template<typename T>
class threadpool {
private:
    std::vector<std::thread> workers;      // 工作线程
    std::queue<T*> task_queue;             // 任务队列
    std::mutex queue_mutex;                // 队列互斥锁
    std::condition_variable condition;     // 条件变量
    bool stop;                             // 停止标志
    
public:
    threadpool(int thread_number = 8);
    ~threadpool();
    bool append(T* request);               // 添加任务
};

epoll 事件驱动

text

// epoll 事件处理核心
class Epoll {
private:
    static const int MAX_FD = 65536;       // 最大文件描述符
    static const int MAX_EVENT_NUMBER = 10000; // 最大事件数
    int epollfd;                           // epoll 文件描述符
    epoll_event events[MAX_EVENT_NUMBER];  // 事件数组
    
public:
    Epoll();
    ~Epoll();
    int addfd(int fd, bool one_shot);      // 添加文件描述符
    int removefd(int fd);                  // 移除文件描述符
    int wait(int timeout = -1);            // 等待事件
};

HTTP 连接处理

text

// HTTP 连接类示例
class HttpConn {
private:
    int m_sockfd;                          // 套接字描述符
    sockaddr_in m_address;                 // 客户端地址
    char m_read_buf[READ_BUFFER_SIZE];     // 读缓冲区
    char m_write_buf[WRITE_BUFFER_SIZE];   // 写缓冲区
    
    // HTTP 解析状态
    CHECK_STATE m_check_state;             // 主状态机状态
    METHOD m_method;                       // 请求方法
    
public:
    void init(int sockfd, const sockaddr_in& addr);
    bool read();                           // 读取数据
    bool write();                          // 写入数据
    void process();                        // 处理请求
};

快速开始指南

环境要求

Linux 操作系统（推荐 Ubuntu/CentOS）
C++11 或更高版本编译器
MySQL 数据库（可选）

编译与运行

text

# 克隆项目
git clone https://github.com/qinguoyi/TinyWebServer.git
cd TinyWebServer

# 编译项目
make

# 运行服务器
./server

配置文件示例

text

// 服务器配置
const int PORT = 9006;                    // 监听端口
const int SQL_NUM = 8;                    // 数据库连接数
const int THREAD_NUM = 8;                 // 线程池线程数
const int MAX_REQUESTS = 10000;           // 最大请求数

实际应用示例

1. 静态文件服务

TinyWebServer 可以轻松配置为静态文件服务器：

text

// 在代码中配置根目录
const char* doc_root = "/var/www/html";

// 处理文件请求
bool HttpConn::do_request() {
    strcpy(m_real_file, doc_root);
    int len = strlen(doc_root);
    strncpy(m_real_file + len, m_url, FILENAME_LEN - len - 1);
    
    // 检查文件是否存在并获取文件状态
    if (stat(m_real_file, &m_file_stat) < 0) {
        return false;
    }
    
    // 处理文件请求逻辑
    // ...
}

2. 数据库集成示例

text

// 数据库连接池使用
class ConnectionPool {
public:
    static ConnectionPool* GetInstance();
    MYSQL* GetConnection();                // 获取连接
    bool ReleaseConnection(MYSQL* conn);   // 释放连接
    
private:
    std::queue<MYSQL*> connQueue;          // 连接队列
    std::mutex lock;                       // 互斥锁
    // ... 其他成员
};

// 在 HTTP 处理中使用数据库
void HttpConn::do_sql() {
    MYSQL* mysql = connPool->GetConnection();
    // 执行 SQL 查询
    mysql_query(mysql, "SELECT * FROM users");
    // 处理结果
    // ...
    connPool->ReleaseConnection(mysql);
}

3. 日志系统

text

// 日志记录示例
class Log {
public:
    static Log* get_instance();
    bool init(const char* file_name, int log_buf_size = 8192, 
              int split_lines = 5000000, int max_queue_size = 0);
    
    void write_log(int level, const char* format, ...);
    
private:
    // 异步日志队列
    block_queue<std::string>* m_log_queue;
    // ... 其他成员
};

// 使用日志
LOG_INFO("%s", "Client connected");
LOG_ERROR("%s:%d", "Connection error", errno);