搭建PHP微服务需配置Swoole环境、用Composer管理依赖、Docker容器化、Consul实现服务注册与发现，通过HTTP或gRPC通信，最后用Docker Compose统一编排服务，确保网络互通与健康检查。
搭建PHP微服务框架需要从环境配置、服务拆分、通信机制到部署运维整体考虑。下面以使用Swoole + Composer + Docker + Consul作为技术栈为例，详细说明如何一步步搭建一个基础的PHP微服务环境。
一、准备基础运行环境
确保你的开发或服务器环境满足以下条件：
- PHP版本 >= 7.4（推荐8.0+）
- 安装Composer包管理工具
- 安装Docker和Docker Compose
- Linux/macOS系统（Windows建议使用WSL）
检查PHP是否支持Swoole扩展：
php -m | grep swoole如果没有输出，需手动安装Swoole：
立即学习“PHP免费学习笔记（深入）”；
pecl install swoole然后在php.ini中添加：
extension=swoole.so二、创建项目结构与初始化服务
每个微服务应独立为一个项目目录。假设我们要创建两个服务：user-service 和 order-service。
创建用户服务目录：
mkdir user-service && cd user-servicecomposer init
composer require league/route* middlewares/fast-route* swoole/website-skeleton
创建入口文件 index.php：
// index.php$server = new Swoole\Http\Server("0.0.0.0", 9501);
$server->on("request", function ($req, $res) {
$res->end("Hello from User Service");
});
$server->start();
测试启动服务：
php index.php访问 http://localhost:9501 应能看到返回内容。
三、实现服务注册与发现（使用Consul）
Consul用于服务注册和健康检查。通过Docker快速启动Consul：
docker run -d --name consul \-p 8500:8500 \
-p 8600:8600/udp \
consul agent -server -bootstrap -ui -client=0.0.0.0
在 user-service 中添加服务注册逻辑（可封装为registerToConsul函数）：
$ch = curl_init();curl_setopt($ch, CURLOPT_URL, "http://localhost:8500/v1/agent/service/register");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
"ID" => "user-service-1",
"Name" => "user-service",
"Address" => "host.docker.internal", // 或宿主机IP
"Port" => 9501,
"Check" => [
"HTTP" => "http://host.docker.internal:9501/health",
"Interval" => "10s"
]
]));
curl_exec($ch); curl_close($ch);
访问 http://localhost:8500 查看Web UI，确认服务已注册。
四、服务间通信（HTTP/gRPC）
order-service 需要调用 user-service 获取用户信息。可以使用Guzzle发送HTTP请求：
composer require guzzlehttp/guzzle在 order-service 中发起请求：
$client = new \GuzzleHttp\Client();$response = $client->get('http://localhost:9501/user/123');
echo $response->getBody();
更高效的方式是使用gRPC（需额外安装Protobuf和PHP gRPC扩展），适合高频内部调用。
五、容器化部署（Docker）
为 user-service 创建 Dockerfile：
FROM php:8.1-cliRUN apt-get update \
&& docker-php-ext-install sockets \
&& pecl install swoole \
&& docker-php-ext-enable swoole
COPY . /app
WORKDIR /app
RUN composer install
CMD ["php", "index.php"]
编写 docker-compose.yml 统一编排：
version: '3'services:
consul:
image: consul
ports:
- "8500:8500"
user-service:
build: ./user-service
ports:
- "9501:9501"
order-service:
build: ./order-service
ports:
- "9502:9502"
启动所有服务：
docker-compose up -d基本上就这些。不复杂但容易忽略的是网络互通和服务健康检查机制。
