Eleme 的 Thrift-PHP 库使用教程

1. 项目目录结构及介绍

在Eleme/thrift-php仓库中，主要目录结构如下：

• lib: 包含了Thrift编译器生成的PHP代码库。
• src: 存放Thrift接口定义（.thrift）文件，这些文件描述服务接口和数据结构。
• examples: 提供了一些示例应用，演示如何使用Thrift-PHP库。
• tests: 单元测试相关的代码。

lib目录下的代码是通过Thrift编译器从.thrift文件生成的，它包含了PHP客户端和服务端所需的类和接口。src中的.thrift文件是你定义服务的地方，而examples和tests则帮助你理解和测试库的用法。

2. 项目的启动文件介绍

在examples目录下，有对应的服务器和客户端脚本，例如server.php和client.php。这些文件是用来启动和交互Thrift服务的典型例子。以server.php为例，它通常会包含以下操作：

1. 引入必要的Thrift库。
2. 配置Thrift加载器（如使用PSR-4或classmap）。
3. 加载生成的服务和类型定义。
4. 实现Thrift服务处理程序。
5. 创建并启动Thrift服务器监听特定端口。

客户端的client.php文件则负责连接到服务器，实例化服务代理，调用服务方法，并处理结果。

// 在服务器脚本（例如 server.php）
require_once 'generated/TutoriaServiceHandler.php';
$handler = new TutorialServiceHandler();
.processorFactory(new TutorialProcessorFactory($handler));
.serverTransport(new TServerSocket(9090));
.protocolFactory(new TBinaryProtocolFactory());
.run();

// 在客户端脚本（例如 client.php）
require_once 'generated/TutorialService.php';
$transport = new THttpClient('http://localhost:9090');
$protocol = new TBinaryProtocol($transport);
$client = new TutorialServiceClient($protocol);
$transport->open();
$client->callSomeMethod();
$transport->close();

3. 项目的配置文件介绍

由于Thrift-PHP库本身不依赖任何配置文件来运行，配置工作主要是在代码中完成。例如，你可以通过以下方式配置Thrift协议工厂和传输层：

• 协议工厂（Protocol Factory）：像TBinaryProtocolFactory用于指定序列化和反序列化的规则。
• 传输层（Transport Layer）：例如TSocket用于TCP通信，THttpClient用于HTTP通信。可以设置相应的主机名、端口等参数。

如果你的项目需要更复杂的配置（如日志、缓存或服务发现），可能需要自定义扩展或者在你的应用程序代码中实现。在examples中，这些配置通常是直接在启动脚本中进行的。

请确保你已经安装了Thrift编译器，并且正确地设置了PHP环境。根据examples目录内的脚本，你可以快速上手体验Thrift-PHP库。如果你遇到任何问题，参考官方文档或检查项目中的示例代码。