0

0

Workerman怎么进行连接重用?Workerman持久连接管理?

月夜之吻

月夜之吻

发布时间:2025-09-07 12:09:01

|

1004人浏览过

|

来源于php中文网

原创

workerman通过事件循环和长驻进程实现连接重用,作为服务器时天然保持客户端长连接,作为客户端时在onworkerstart中初始化数据库、redis等持久连接,并通过心跳检测与异常捕获实现自动重连,结合guzzle等支持连接池的http客户端优化后端请求复用,提升性能与稳定性。

workerman怎么进行连接重用?workerman持久连接管理?

Workerman在连接重用和持久连接管理上,其核心优势就体现在它基于事件循环和长驻进程模型。简单来说,Workerman作为服务器时,客户端的TCP连接只要不主动断开,它就会一直保持,这就天然实现了连接重用。而当Workerman作为客户端去连接数据库、Redis或其他外部服务时,我们则需要通过一些策略,确保这些后端连接也能在单个Worker进程的生命周期内被高效地管理和复用,避免每次请求都重新建立连接的开销。这不仅仅是性能问题,更是资源利用率和系统稳定性的关键。

解决方案

Workerman对连接的重用和管理,实际上可以从两个维度来看:一是它作为服务器端,如何处理客户端连接;二是在它作为客户端去访问其他服务时,如何管理这些出站连接。

对于Workerman作为服务器端的情况,例如处理WebSocket或HTTP长连接,连接重用是其架构的天然属性。一个客户端连接一旦建立,只要不发生网络中断或客户端/服务器主动关闭,这个TCP连接就会持续存在。Workerman的事件循环会监听这个连接上的数据,而不是每次请求都重新握手。这意味着,只要客户端保持连接,它就可以通过同一个TCP通道发送多次请求,Workerman的Worker进程会持续处理这些请求。这种模型在实时通信、消息推送等场景下效率极高,因为它省去了反复建立和销毁TCP连接的巨大开销。

而对于Workerman作为客户端,需要连接数据库(如MySQL)、缓存(如Redis)或其他API服务时,持久连接的管理就显得尤为重要。通常的做法是,在每个Worker进程启动时(即

onWorkerStart
事件中),初始化这些需要长期保持的连接。比如,你可以创建一个PDO实例连接到MySQL,或者一个Redis客户端实例。这些实例会被该Worker进程独占并复用。当有客户端请求到达,触发
onMessage
或相应的业务逻辑时,Worker进程可以直接使用这些已建立的连接去与后端服务交互,而无需为每个请求都重新建立连接。

然而,仅仅初始化一次并不意味着万事大吉。这些持久连接可能会因为网络波动、后端服务重启、或者长时间不活动被防火墙/路由设备关闭等原因而失效。因此,一套健壮的连接管理机制还需要包括:心跳检测(ping/pong)、错误处理与自动重连逻辑。当检测到连接失效时,Worker进程应该能够捕获异常,并尝试重新建立连接,确保服务的持续可用性。

Workerman如何有效管理数据库长连接以避免资源耗尽?

在Workerman应用中,数据库长连接的管理是个值得深思的问题,处理不当确实容易导致资源耗尽或连接失效。我个人在实践中发现,最有效的方法是让每个Worker进程独立维护自己的数据库连接池,而不是共享连接。

具体来说,你可以在

onWorkerStart
回调函数中为每个Worker进程初始化一个数据库连接(比如PDO或MySQLi)。这个连接实例是该Worker进程私有的,它会在Worker进程的整个生命周期中被复用。这样做的好处显而易见:减少了TCP握手和认证的开销,显著提升了数据库操作的性能。

use Workerman\Worker;
use PDO;

$worker = new Worker('tcp://0.0.0.0:8080');
$worker->count = 4; // 启动4个Worker进程

// 每个Worker进程启动时
$worker->onWorkerStart = function($worker) {
    // 将数据库连接存储在Worker进程的全局变量中,以便onMessage等回调函数使用
    global $db;
    try {
        $db = new PDO('mysql:host=localhost;dbname=test;charset=utf8', 'root', 'password');
        $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        // 设置长连接属性,确保连接在空闲时不会被PHP垃圾回收
        $db->setAttribute(PDO::ATTR_PERSISTENT, true); 
        echo "Worker {$worker->id} database connection established.\n";
    } catch (PDOException $e) {
        echo "Worker {$worker->id} database connection failed: " . $e->getMessage() . "\n";
        // 适当的错误处理,比如记录日志或者退出进程让Workerman重新拉起
        exit(250); 
    }
};

$worker->onMessage = function($connection, $data) {
    global $db;
    try {
        // 每次使用前可以尝试ping一下,确保连接有效
        // 实际生产中,ping的频率需要权衡,频繁ping会增加开销
        // 更好的做法是捕获异常后尝试重连
        $db->query('SELECT 1'); 
        $stmt = $db->prepare('SELECT * FROM users WHERE id = :id');
        $stmt->execute([':id' => 1]);
        $user = $stmt->fetch(PDO::FETCH_ASSOC);
        $connection->send(json_encode($user));
    } catch (PDOException $e) {
        // 连接失效,尝试重新建立连接
        echo "Database error: " . $e->getMessage() . ", trying to reconnect.\n";
        global $db; // 重新声明global $db,确保作用域正确
        try {
            $db = new PDO('mysql:host=localhost;dbname=test;charset=utf8', 'root', 'password');
            $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
            $db->setAttribute(PDO::ATTR_PERSISTENT, true);
            // 重新执行之前的操作
            $stmt = $db->prepare('SELECT * FROM users WHERE id = :id');
            $stmt->execute([':id' => 1]);
            $user = $stmt->fetch(PDO::FETCH_ASSOC);
            $connection->send(json_encode($user));
        } catch (PDOException $reconnect_e) {
            $connection->send("Database connection failed after retry: " . $reconnect_e->getMessage());
            // 严重错误,可能需要记录日志并通知管理员
        }
    }
};

Worker::runAll();

需要注意的是,即使设置了

PDO::ATTR_PERSISTENT
,这仅仅是让PHP在请求结束后不关闭连接,但对于Workerman的长驻进程来说,它更重要的是在进程内复用同一个PDO实例。真正的挑战在于如何处理数据库服务器重启、网络波动或长时间空闲导致的连接断开。我的经验是,不要过度依赖
ATTR_PERSISTENT
,而是要建立一套可靠的错误捕获和重连机制。在每次数据库操作前,如果能有一个轻量级的
ping
操作(比如
SELECT 1
)来检测连接活性是最好的,但更实际的做法是捕获
PDOException
,并在捕获到连接错误时尝试重新建立连接。如果重连失败,则可能需要记录日志并返回错误信息。

在Workerman中,如何处理长连接的心跳机制与断线重连?

长连接的心跳机制和断线重连,是确保Workerman应用稳定性的关键环节,无论是面对客户端还是后端服务。这不仅仅是技术实现,更是一种容错设计的哲学。

Lumen5
Lumen5

一个在线视频创建平台,AI将博客文章转换成视频

下载

客户端心跳(Workerman作为服务器): 对于Workerman作为服务器,处理WebSocket等长连接客户端时,心跳机制是必不可少的。它主要解决两个问题:

  1. 保持连接活性: 许多NAT设备或防火墙会关闭长时间没有数据传输的TCP连接。通过定期发送心跳包,可以欺骗这些设备,让它们认为连接仍然活跃。
  2. 检测死连接: 客户端可能因为网络中断、设备关机等原因突然离线,但TCP连接并不会立即断开(直到超时)。通过心跳,服务器可以主动发现这些“僵尸连接”,及时清理资源。

实现方式通常是Workerman服务器定时向所有客户端发送一个心跳包(例如一个特定的JSON消息),客户端收到后需要回复。如果在设定的时间内没有收到客户端的回复,服务器就认为该客户端已离线,并主动关闭连接。

use Workerman\Worker;
use Workerman\Timer;

$ws_worker = new Worker('websocket://0.0.0.0:2346');
$ws_worker->count = 4;

$ws_worker->onWorkerStart = function($worker) {
    // 每隔55秒检查一次客户端心跳
    Timer::add(55, function() use ($worker) {
        foreach ($worker->connections as $connection) {
            // 如果客户端连接的心跳时间超过了60秒,则认为其已断开
            if (empty($connection->lastHeartbeatTime)) {
                $connection->lastHeartbeatTime = time();
            }
            if (time() - $connection->lastHeartbeatTime > 60) {
                echo "Client " . $connection->id . " heartbeat timeout, closing connection.\n";
                $connection->close();
            }
        }
    });
};

$ws_worker->onConnect = function($connection) {
    $connection->lastHeartbeatTime = time(); // 记录连接时间作为初始心跳时间
    echo "Client " . $connection->id . " connected.\n";
};

$ws_worker->onMessage = function($connection, $data) {
    // 收到任何消息都更新心跳时间
    $connection->lastHeartbeatTime = time();
    // 如果是心跳包,回复一个pong
    if ($data === '{"type":"ping"}') {
        $connection->send('{"type":"pong"}');
    } else {
        // 处理业务逻辑
        $connection->send("You said: " . $data);
    }
};

$ws_worker->onClose = function($connection) {
    echo "Client " . $connection->id . " disconnected.\n";
};

Worker::runAll();

客户端也需要实现相应的逻辑,定时发送ping,并响应pong。

后端服务断线重连(Workerman作为客户端): 当Workerman连接数据库、Redis等后端服务时,断线重连是确保业务连续性的关键。这通常涉及捕获连接相关的异常,然后在异常发生时尝试重新建立连接。

核心思路是:

  1. 异常捕获: 在进行后端服务操作时,使用
    try-catch
    块捕获可能出现的连接异常(例如
    PDOException
    RedisException
    )。
  2. 重新连接:
    catch
    块中,尝试重新初始化连接。这可能需要多次尝试,并引入“指数退避”(exponential backoff)策略,即每次重试的间隔时间逐渐增长,避免短时间内对后端服务造成过大压力。
  3. 重试操作: 重新连接成功后,可以尝试再次执行之前失败的操作。
  4. 失败处理: 如果多次重试后仍然无法连接,则需要记录详细日志,并向客户端返回一个友好的错误信息,或者触发告警机制。
// 假设这是Redis连接的重连逻辑
global $redis;
function getRedisConnection() {
    global $redis;
    if ($redis && $redis->ping()) {
        return $redis;
    }
    // 连接失效或未连接,尝试重连
    $max_retries = 3;
    $retry_delay = 1; // 初始延迟1秒
    for ($i = 0; $i < $max_retries; $i++) {
        try {
            $redis = new Redis();
            $redis->connect('127.0.0.1', 6379, 1.0); // 1秒连接超时
            $redis->auth('your_password'); // 如果有密码
            if ($redis->ping()) {
                echo "Redis reconnected successfully.\n";
                return $redis;
            }
        } catch (RedisException $e) {
            echo "Redis connection attempt " . ($i + 1) . " failed: " . $e->getMessage() . "\n";
            sleep($retry_delay);
            $retry_delay *= 2; // 指数退避
        }
    }
    echo "Failed to connect to Redis after multiple retries.\n";
    return null; // 返回null表示连接失败
}

// 在onMessage或其他业务逻辑中使用
$worker->onMessage = function($connection, $data) {
    $redis = getRedisConnection();
    if ($redis) {
        try {
            $value = $redis->get('some_key');
            $connection->send("Value from Redis: " . $value);
        } catch (RedisException $e) {
            $connection->send("Error accessing Redis: " . $e->getMessage());
        }
    } else {
        $connection->send("Redis service unavailable.");
    }
};

这种策略使得系统在面对临时性故障时更具韧性,避免了因单点故障导致整个服务崩溃。

使用Workerman构建高性能API服务时,如何优化HTTP客户端的连接复用?

当我们用Workerman构建API服务,并且这个服务还需要作为客户端去调用其他外部HTTP API时,优化HTTP客户端的连接复用是提升整体性能的关键一环。每次发起HTTP请求都重新建立TCP连接,进行DNS解析、TCP三次握手、TLS握手(如果是HTTPS),这些开销累积起来会非常显著。

我通常会推荐使用像Guzzle这样的现代HTTP客户端库,并结合它的连接池功能来优化。Guzzle本身就支持HTTP/1.1的

Keep-Alive
机制,并且在配合Workerman这种长驻进程环境时,能发挥出巨大优势。

核心思路是:

  1. 初始化一个持久化的Guzzle客户端实例: 在每个Worker进程启动时(
    onWorkerStart
    ),创建一个Guzzle客户端实例。这个实例内部会维护一个连接池,用于复用与目标服务器的TCP连接。
  2. 配置Guzzle客户端: 确保Guzzle客户端配置了适当的超时时间、
    Keep-Alive
    头(Guzzle默认会发送,但可以显式配置)。
  3. 复用客户端实例:
    onMessage
    或其他处理请求的回调中,直接使用这个全局的Guzzle客户端实例来发起HTTP请求。
use Workerman\Worker;
use GuzzleHttp\Client;
use GuzzleHttp\HandlerStack;
use GuzzleHttp\Handler\CurlHandler;

$http_worker = new Worker('http://0.0.0.0:8081');
$http_worker->count = 4;

$http_worker->onWorkerStart = function($worker) {
    global $httpClient;
    // 使用CurlHandler作为Guzzle的底层HTTP处理器,它支持连接复用
    $handler = new CurlHandler();
    $stack = HandlerStack::create($handler);

    // 初始化Guzzle客户端,设置基础URI、超时等
    // 这个客户端实例在Worker进程的生命周期内只会创建一次
    $httpClient = new Client([
        'base_uri' => 'http://api.example.com/', // 你的目标API基础URI
        'timeout'  => 5.0, // 请求超时时间
        'handler'  => $stack,
        'http_errors' => false, // 不抛出HTTP错误,方便统一处理响应
        // 确保发送Keep-Alive头部,尽管Guzzle默认会这样做
        'headers' => [
            'Connection' => 'keep-alive',
        ],
    ]);
    echo "Worker {$worker->id} Guzzle HTTP client initialized.\n";
};

$http_worker->onMessage = function($connection, $request) {
    global $httpClient;
    $path = $request->path(); // 获取请求路径
    $method = $request->method(); // 获取请求方法

    try {
        // 使用同一个Guzzle客户端实例发送请求
        $response = $httpClient->request($method, $path, [
            'query' => $request->get(), // 将客户端GET参数转发
            'json' => $request->post(), // 如果是POST请求,可以转发JSON数据
        ]);

        $statusCode = $response->getStatusCode();
        $body = (string) $response->getBody();

        $connection->send(new \Workerman\Protocols\Http\Response($statusCode, [
            'Content-Type' => $response->getHeaderLine('Content-Type')
        ], $body));

    } catch (\GuzzleHttp\Exception\RequestException $e) {
        // 处理Guzzle请求异常,例如网络问题、连接超时等
        $errorMessage = "External API request failed: " . $e->getMessage();
        echo $errorMessage . "\n";
        $connection->send(new \Workerman\Protocols\Http\Response(500, [], $errorMessage));
    } catch (\Throwable $e) {
        // 处理其他未知异常
        $errorMessage = "An unexpected error occurred: " . $e->getMessage();
        echo $errorMessage . "\n";
        $connection->send(new \Workerman\Protocols\Http\Response(500, [], $errorMessage));
    }
};

Worker::runAll();

通过这种方式,当Workerman的Worker进程向

api.example.com
发送多个请求时,Guzzle客户端会尝试复用已建立的TCP连接,而不是每次都重新建立。这极大地减少了网络延迟和服务器资源消耗,尤其是在高并发场景下,效果非常显著。当然,Guzzle的连接池也有其生命周期,如果长时间没有请求,连接可能会被目标服务器或中间网络设备关闭。Guzzle内部会处理这些情况,并在必要时重新建立连接,但作为开发者,我们只需要关心如何有效地利用这个客户端实例即可。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

682

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

452

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

286

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

519

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

264

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

392

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

541

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

662

2023.08.14

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

6

2026.02.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 2.4万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 838人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号