Workerman通过常驻内存和事件循环机制实现高性能RESTful API，避免了传统PHP-FPM的重复加载开销，支持HTTP协议解析、路由分发、JSON响应构建，并可结合fast-route等库优化路由，配合全局异常处理、日志记录（如Monolog）、输入验证、HTTPS、JWT认证、限流等措施保障服务稳定与安全。
Workerman实现API接口，尤其是开发RESTful API，核心在于它能够作为一个常驻内存的HTTP服务器，直接处理客户端的请求。这与传统的PHP-FPM模式有显著不同，Workerman通过监听特定的端口，当HTTP请求到来时，由其内部的事件循环调度到相应的业务逻辑进行处理，并最终返回响应。这种模式省去了每次请求都重新启动PHP解释器、加载框架的开销，从而带来了极高的性能和并发能力。
要用Workerman实现API接口，你主要需要利用其HTTP协议支持。以下是一个基本的实现思路和代码示例：
Worker
Worker
onMessage
Response
Content-Type: application/json
以下是一个简单的Workerman API骨架代码：
<?php
require_once __DIR__ . '/vendor/autoload.php'; // 假设你使用了Composer
use Workerman\Worker;
use Workerman\Protocols\Http\Request;
use Workerman\Protocols\Http\Response;
// 创建一个Worker，监听8080端口，使用HTTP协议
$http_worker = new Worker('http://0.0.0.0:8080');
// 启动1个进程（根据实际情况调整）
$http_worker->count = 1;
$http_worker->onMessage = function(TcpConnection $connection, Request $request)
{
// 获取请求URI
$uri = $request->uri();
// 获取请求方法
$method = $request->method();
// 简单的路由逻辑
if ($uri === '/api/users' && $method === 'GET') {
// 假设这里从数据库获取用户列表
$users = [
['id' => 1, 'name' => 'Alice'],
['id' => 2, 'name' => 'Bob']
];
$response = new Response(200, ['Content-Type' => 'application/json'], json_encode(['code' => 0, 'data' => $users]));
} elseif (strpos($uri, '/api/user/') === 0 && $method === 'GET') {
// 获取用户ID，例如 /api/user/1
$pathParts = explode('/', $uri);
$userId = end($pathParts);
// 简单模拟数据
if ($userId == 1) {
$user = ['id' => 1, 'name' => 'Alice', 'email' => 'alice@example.com'];
$response = new Response(200, ['Content-Type' => 'application/json'], json_encode(['code' => 0, 'data' => $user]));
} else {
$response = new Response(404, ['Content-Type' => 'application/json'], json_encode(['code' => 404, 'message' => 'User not found']));
}
} elseif ($uri === '/api/users' && $method === 'POST') {
// 获取POST请求体数据
$postData = $request->post();
// 或者获取原始JSON数据
// $rawData = $request->rawBody();
// $input = json_decode($rawData, true);
// 假设这里处理创建新用户逻辑
$newUser = ['id' => rand(100, 999), 'name' => $postData['name'] ?? 'Guest'];
$response = new Response(201, ['Content-Type' => 'application/json'], json_encode(['code' => 0, 'message' => 'User created', 'data' => $newUser]));
} else {
// 未匹配的路由
$response = new Response(404, ['Content-Type' => 'application/json'], json_encode(['code' => 404, 'message' => 'Not Found']));
}
$connection->send($response);
};
// 运行Worker
Worker::runAll();当我第一次接触到Workerman时，它给我的感觉就像是PHP世界里的一股清流，尤其是在构建API服务方面。它能把PHP从“请求-响应-退出”的传统模式中解放出来，以一种常驻内存、异步非阻塞的方式运行，这对于追求高性能和低延迟的RESTful API来说，简直是如虎添翼。
性能优势显而易见：
然而，在实践中，我们也不能忽视一些重要的考量：
try-catch
总的来说，Workerman在构建高性能RESTful API方面具有强大的潜力，但它要求开发者对PHP的运行机制有更深入的理解，并更加注重代码的健壮性和资源管理。一旦掌握了这些，你将能够构建出非常高效且稳定的API服务。
在Workerman中处理路由和请求参数，是构建任何API服务的核心。虽然Workerman本身不像大型框架那样内置了复杂的路由系统，但它提供了足够的基础设施，让我们能够灵活地实现自己的路由逻辑，并高效地获取各种请求数据。
优雅的路由处理：
最基础的路由方式，如前面示例所示，是直接通过
$request->uri()
$request->method()
if/else
switch
if ($request->uri() === '/api/v1/users' && $request->method() === 'GET') {
// ...
} elseif (strpos($request->uri(), '/api/v1/user/') === 0 && $request->method() === 'GET') {
// ... 动态参数匹配
}nikic/fast-route
// 假设你已经集成了fast-route
// DispatcherFactory::create(...)
// ...
$routeInfo = $dispatcher->dispatch($request->method(), $request->uri());
switch ($routeInfo[0]) {
case \FastRoute\Dispatcher::NOT_FOUND:
$connection->send(new Response(404, [], json_encode(['code' => 404, 'message' => 'Not Found'])));
break;
case \FastRoute\Dispatcher::METHOD_NOT_ALLOWED:
$allowedMethods = $routeInfo[1];
$connection->send(new Response(405, ['Allow' => implode(',', $allowedMethods)], json_encode(['code' => 405, 'message' => 'Method Not Allowed'])));
break;
case \FastRoute\Dispatcher::FOUND:
$handler = $routeInfo[1];
$vars = $routeInfo[2]; // 动态路由参数
// 调用对应的控制器方法，并传入$vars
// call_user_func_array($handler, [$connection, $request, $vars]);
break;
}使用这样的库，路由规则可以集中管理，逻辑清晰，也更容易进行性能优化。
onMessage
dispatch
高效获取请求参数：
Workerman的
Request
$request->get()
$request->get('param_name', $defaultValue)$request->post()
$request->post('param_name', $defaultValue)application/x-www-form-urlencoded
$request->post()
$request->rawBody()
application/json
application/xml
$_POST
rawBody()
json_decode
$contentType = $request->header('Content-Type');
if (strpos($contentType, 'application/json') !== false) {
$data = json_decode($request->rawBody(), true);
// ...处理JSON数据
}$request->header('Header-Name', $defaultValue)$request->header()
$request->cookie('cookie_name', $defaultValue)$request->cookie()
在处理请求参数时，参数校验是至关重要的一环。无论你使用的是哪种方式获取参数，都必须在业务逻辑层对参数的类型、格式、长度、范围等进行严格的校验，以防止恶意输入、保证数据完整性和系统安全。Workerman本身不提供参数校验功能，但这正是我们作为开发者需要补足的部分，可以引入像
Respect/Validation
构建一个健壮、可靠且安全的Workerman API服务，错误处理、日志记录和安全性是不可或缺的三个支柱。我个人认为，这三者就像是API服务的“免疫系统”，它们决定了服务在面对异常、攻击时的抵抗力和恢复力。
1. 精细的错误处理机制：
在Workerman的常驻内存环境中，一个未处理的错误或异常可能导致整个进程崩溃，影响所有正在服务的客户端。
Worker
set_exception_handler()
set_error_handler()
try-catch
// 在Worker::runAll()之前设置
set_exception_handler(function (Throwable $exception) {
// 记录详细错误日志
error_log($exception->getMessage() . "\n" . $exception->getTraceAsString());
// 给客户端返回通用错误信息，避免泄露内部细节
// 假设这里有一个$connection对象可用，或者通过其他方式获取
// $connection->send(new Response(500, ['Content-Type' => 'application/json'], json_encode(['code' => 500, 'message' => 'Internal Server Error'])));
});200 OK
201 Created
204 No Content
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
405 Method Not Allowed
429 Too Many Requests
500 Internal Server Error
{
"code": 1001,
"message": "Invalid user ID format",
"request_id": "abc-123-xyz"
}2. 全面的日志记录策略：
日志是排查问题、监控服务运行状态的“眼睛”。没有完善的日志，API服务就像在黑暗中摸索。
3. 不可忽视的安全性最佳实践：
API是服务对外暴露的窗口，安全性是重中之重。
filter_var()
onMessage
Access-Control-Allow-Origin
X-Content-Type-Options
X-Frame-Options
Strict-Transport-Security
安全性是一个持续的过程，没有一劳永逸的解决方案。我们需要不断关注新的安全威胁，并定期对API进行安全审计。在
以上就是Workerman如何实现API接口？Workerman开发RESTfulAPI？的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
1010
收藏
