Temporal PHP SDK 使用指南

Temporal PHP SDK 使用指南

sdk-phpTemporal PHP SDK项目地址:https://gitcode.com/gh_mirrors/sdkp/sdk-php

项目目录结构及介绍

Temporal.io 的 PHP SDK 存储在 GitHub 上，其仓库地址为 https://github.com/temporalio/sdk-php.git。下面是该SDK的主要目录结构及其简介：

sdk-php/
├── composer.json         # 项目依赖管理文件
├── src/                  # 核心源代码目录
│   ├── Client.php        # Temporal客户端类，用于与Temporal服务交互
│   ├── Enum/             # 包含各种枚举类型定义
│   └── ...               # 其他核心类与接口
├── examples/             # 示例代码目录，展示如何使用SDK进行工作流和活动任务的实现
├── tests/                # 单元测试目录
├── README.md             # 主要的说明文档，包含快速入门等内容
└── LICENSE               # 许可证文件

这个结构清晰地划分了库的组成部分，使得开发者能够容易地找到相关的实现代码以及学习示例。

项目的启动文件介绍

Temporal SDK for PHP本身不直接提供一个“启动文件”以运行整个应用，而是需要开发者在其PHP应用程序中集成Temporal客户端来初始化连接Temporal服务。通常，这通过以下方式完成：

use \Temporal\WorkerFactory;
use \Temporal\WorkflowClient;

// 初始化WorkflowClient实例，设置Temporal服务地址等配置
$workflowClient = new WorkflowClient([
    'serviceAddress' => 'localhost:7233',
]);

// 创建Worker工厂以注册工作流程和活动
$workerFactory = new WorkerFactory($workflowClient);

开发者应根据自己的应用逻辑，在应用入口或特定配置阶段引入这些初始化代码。

项目的配置文件介绍

Temporal SDK for PHP本身并不强制要求有特定的配置文件格式。配置主要通过代码中的参数直接指定，如在创建WorkflowClient实例时提供的服务地址等。然而，实际应用开发中，为了提高灵活性和可维护性，开发者可能会选择自定义配置文件（例如.env、config.php等）来存储Temporal服务的地址、认证信息等敏感或易变数据，然后在应用启动时读取这些配置并传递给Temporal客户端。

例如，在一个假想的config.php中：

return [
    'temporal' => [
        'serviceAddress' => 'your-temporal-service:port',
        // 可能还包括认证信息等其他配置项
    ],
];

随后在应用代码中加载此配置，并基于它初始化Temporal客户端。

通过这种方式，开发者可以根据项目需求灵活管理和调整Temporal的配置细节，确保应用的稳定性和扩展性。

sdk-phpTemporal PHP SDK项目地址:https://gitcode.com/gh_mirrors/sdkp/sdk-php