{"id":19829669,"url":"https://github.com/workbunny/event-loop","last_synced_at":"2025-05-01T14:33:41.469Z","repository":{"id":42176829,"uuid":"450452442","full_name":"workbunny/event-loop","owner":"workbunny","description":"🐇 A high-performance event loop library for PHP","archived":true,"fork":false,"pushed_at":"2023-09-14T10:34:51.000Z","size":132,"stargazers_count":24,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-06T14:51:12.447Z","etag":null,"topics":["event-loop","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/workbunny.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-01-21T10:43:37.000Z","updated_at":"2025-04-03T02:26:02.000Z","dependencies_parsed_at":"2022-08-12T08:41:10.446Z","dependency_job_id":"368d0f5e-1199-424c-8803-aefc3c14bbf2","html_url":"https://github.com/workbunny/event-loop","commit_stats":{"total_commits":66,"total_committers":2,"mean_commits":33.0,"dds":"0.19696969696969702","last_synced_commit":"9f1f3939ede34a1397dc545a392cdb7db95e8fc5"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workbunny%2Fevent-loop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workbunny%2Fevent-loop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workbunny%2Fevent-loop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/workbunny%2Fevent-loop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/workbunny","download_url":"https://codeload.github.com/workbunny/event-loop/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251890359,"owners_count":21660503,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["event-loop","php"],"created_at":"2024-11-12T11:19:31.407Z","updated_at":"2025-05-01T14:33:41.122Z","avatar_url":"https://github.com/workbunny.png","language":"PHP","readme":"\n\u003cp align=\"center\"\u003e\u003cimg width=\"260px\" src=\"https://chaz6chez.cn/images/workbunny-logo.png\" alt=\"workbunny\"\u003e\u003c/p\u003e\n\n**\u003cp align=\"center\"\u003eworkbunny/event-loop\u003c/p\u003e**\n\n**\u003cp align=\"center\"\u003e🐇 A high-performance event loop library for PHP 🐇\u003c/p\u003e**\n\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://github.com/workbunny/event-loop/actions\"\u003e\n        \u003cimg src=\"https://github.com/workbunny/event-loop/actions/workflows/CI.yml/badge.svg\" alt=\"Build Status\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/workbunny/event-loop/blob/main/composer.json\"\u003e\n        \u003cimg alt=\"PHP Version Require\" src=\"http://poser.pugx.org/workbunny/event-loop/require/php\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/workbunny/event-loop/blob/main/LICENSE\"\u003e\n        \u003cimg alt=\"GitHub license\" src=\"http://poser.pugx.org/workbunny/event-loop/license\"\u003e\n    \u003c/a\u003e\n    \n\u003c/div\u003e\n\n\n## 简介\n\n    一个事件循环库，目的是为了构建高性能网络应用。\n\n## 使用\n\n注：本文档为 1.2.x 版本，旧版请点击 **[1.1.x 版本](https://github.com/workbunny/event-loop/tree/1.1.x)** 跳转\n注：swowloop还未完成单元测试，敬请等待\n\n### 安装\n```\ncomposer require workbunny/event-loop\n```\n\n### 创建loop\n\n```php\nuse WorkBunny\\EventLoop\\Loop;\nuse WorkBunny\\EventLoop\\Drivers\\NativeLoop;\nuse WorkBunny\\EventLoop\\Drivers\\EventLoop;\nuse WorkBunny\\EventLoop\\Drivers\\EvLoop;\nuse WorkBunny\\EventLoop\\Drivers\\SwowLoop;\n\n// 创建PHP原生loop\n$loop = Loop::create(NativeLoop::class);\n// 创建ext-event loop\n$loop = Loop::create(EventLoop::class);\n// 创建ext-ev loop\n$loop = Loop::create(EvLoop::class);\n// 创建swow loop\n$loop = Loop::create(SwowLoop::class);\n```\n\n### 注册loop\n\n- 创建 YourLoopClass 实现 LoopInterface\n- 调用 Loop::register() 注册 YourLoopClass\n\n```php\nuse WorkBunny\\EventLoop\\Loop;\n// 注册\nloop::register(YourLoopClass::class);\n// 创建\n$yourLoop = Loop::create(YourLoopClass::class);\n```\n\n### 创建定时器\n\n- Future 触发器\n```php\n/**\n * @Future [delay=0.0, repeat=false]\n *  在下一个周期执行，执行一次即自动销毁\n */\n$loop-\u003eaddTimer(0.0, false, function (){ echo 'timer'; }); // loop-\u003erun()后立即输出字符串\n```\n\n- ReFuture 重复触发器\n```php\n/**\n * @ReFuture [delay=0.0, repeat=0.0]\n *  在每一个周期执行，不会自动销毁\n */\n$id = $loop-\u003eaddTimer(0.0, 0.0, function () use(\u0026$loop, \u0026$id) {\n    // 此方法可以实现自我销毁\n    $loop-\u003edelTimer($id);\n});\n```\n\n- DelayReFuture 延迟的重复触发器\n```php\n/**\n * @DelayReFuture [delay\u003e0.0, repeat=0.0]\n *  延迟delay秒后每一个周期执行，不会自动销毁\n */\n$id = $loop-\u003eaddTimer(1.0, 0.0, function () use(\u0026$loop, \u0026$id) {\n    // 此方法可以实现自我销毁\n    $loop-\u003edelTimer($id);\n});\n```\n\n- Delayer 延迟器\n```php\n/**\n * @Delayer [delay\u003e0.0, repeat=false]\n *  延迟delay秒后执行，执行一次即自动销毁\n */\n$loop-\u003eaddTimer(2.0, false, function (){ echo 'timer'; }); // loop-\u003erun() 2秒后输出字符串\n```\n\n- Timer 定时器\n```php\n/**\n * @Timer [delay=0.0, repeat\u003e0.0]\n *  在下一个周期开始每间隔repeat秒执行，不会自动销毁\n */\n$id = $loop-\u003eaddTimer(0.1, 0.1, function () use(\u0026$loop, \u0026$id) {\n    // 此方法可以实现自我销毁\n    $loop-\u003edelTimer($id);\n});\n```\n\n- DelayTimer 延迟的定时器\n```php\n/**\n * @DelayTimer [delay\u003e0.0, repeat\u003e0.0]\n *  延迟delay秒后每间隔repeat秒执行，不会自动销毁\n */\n$id = $loop-\u003eaddTimer(0.2, 0.1, function () use(\u0026$loop, \u0026$id) {\n    // 此方法可以实现自我销毁\n    $loop-\u003edelTimer($id);\n});\n```\n\n### 流事件\n\n  这里的流是指 **[PHP Streams](https://www.php.net/manual/zh/book.stream.php)**\n\n- 读取流\n```php\n// 创建\n$loop-\u003eaddReadStream(resource, function (resource $stream) { });\n// 注意：EvLoop在这里较为特殊，回调函数的入参为EvIo对象\n$loop-\u003eaddReadStream(resource, function (\\EvIo $evio) {\n    $evio-\u003estream // resource 资源类型\n});\n// 移除\n$loop-\u003edelReadStream(resource);\n```\n\n- 写入流\n```php\n// 创建\n$loop-\u003eaddWriteStream(resource, function (resource $stream) { });\n// 注意：EvLoop在这里较为特殊，回调函数的入参为EvIo对象\n$loop-\u003eaddWriteStream(resource, function (\\EvIo $evio) {\n    $evio-\u003estream // resource 资源类型\n});\n// 移除\n$loop-\u003edelWriteStream(resource);\n```\n\n### 信号事件\n\n  用于接收系统的信号，比如kill等\n```php\n// 注册\n$loop-\u003eaddSignal(\\SIGUSR1, function (){});\n// 移除\n$loop-\u003edelSignal(\\SIGUSR1, function (){});\n```\n\n### 启动/停止\n\n- 启动\n\n  以下代码会持续阻塞，请放在程序最后一行\n```php\n# 该函数后会阻塞\n$loop-\u003eloop();\n\n# 该行代码不会执行\nvar_dump('123');\n```\n\n- 停止\n\n  以下代码不会阻塞等待\n```php\n$loop-\u003edestroy();\n\n# 该行代码会执行\nvar_dump('123');\n```\n\n---\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkbunny%2Fevent-loop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fworkbunny%2Fevent-loop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworkbunny%2Fevent-loop/lists"}