为 Longbridge OpenAPI 提供社区版 PHP SDK

[BrownSweet]

长桥团队你好，

我开发了一个社区版 PHP SDK，用于接入 Longbridge OpenAPI：

• GitHub: https://github.com/BrownSweet/longbridge-php
• Packagist: https://packagist.org/packages/brown/longbridge-php
• License: MIT
• PHP: >= 8.2
• Composer命令: composer require brown/longbridge-php

目前已支持的能力包括：

• OAuth2.0 HTTP 客户端
• 传统appkey + appsecret + access_token客户端
• OAuth2.0 + 传统混合客户端
• HTTP API
• WebSocket通信协议的封装
• protobuf 协议编解码和生成类
• WebSocket 行情 pull / subscribe / push

当前项目准备情况：

• 已接入 PHPUnit 自动化测试
• 已提供中文和英文功能覆盖表
• 已提供 MIT License

相关文档：

• README.md 提供完整的接入流程

其他说明：
PHP SDK 已经接入到我本人的实际项目中，websocket客户端使用的是swoole拓展，并没有进行原生socket开发，sdk的php语言版本>=8.2

我注意到长桥官方SDK并没有PHP SDK，因此想请教：
1、PHP版本的SDK为什么没有开发
2、长桥团队是否接受我的 PHP SDK 作为社区版SDK？
3、如果希望未来PHP纳入官方 SDK 体系，我作为个人开发者，我的PHP SDK可否成为官方SDK？
4、官方更倾向于将其作为社区 SDK 引用，还是未来迁移到 官方仓库 组织下维护？
5、是否有推荐的 API 风格或返回结构，以便更好地与现有官方 SDK 保持一致？

我愿意根据官方建议调整包名、namespace、文档、CI、测试覆盖、API 设计或发布流程。我的目标是让 PHP 用户也能稳定、规范地接入 Longbridge OpenAPI，并尽可能与官方 SDK 标准保持一致。

同时其他小伙伴在使用过程中出现一些问题，可以到我的仓库提交issue。也希望有志同道合的老伙子们和我一起维护。

谢谢。

[huacnlee]

1. 我们提供 SDK 目的是为了给股票分析、量化开发的用户来用的，目前选择的均为常见的常见，PHP 不是首选，同理 Ruby 也不是（虽然我们团队与 Ruby 有较深的渊源），因此我们没打算覆盖 PHP，否则日常维护会跟不上，主要得考虑受众面。
2. 否
3. 我们趋向于保持它作为社区版本。
4. 否
5. 你可以看一下 Node.js 采用 FFI 的方式用 Rust 实现，这样可以用相同机制。

同理对比 PHP 那么为何我们不能提供 ruby, c#, zig、elxir、erlang，主要还是要考虑维护性的问题，我们不单是要提供这么一个实现，还得解决用户开发过程遇到的问题。

当前已经是 AI 时代，我认为没必要完全提供全面的 SDK 了，如果希望有较好的性能，应该选择 Rust、Go、Java 的实现，如果想要易用性可以选择 Python 和 Node.js，这些对于开发均非常方便，一方面当前提供的已经足够覆盖热门编程语言了，另一方便借助于 AI 已经不需要开发者掌握这些语言也可能完成开发。

[BrownSweet]

感谢详细回复，我理解长桥团队在 SDK 覆盖范围、用户受众和长期维护成本上的考虑。

我会将该项目明确定位为非官方社区版 PHP SDK，不再以短期纳入官方 SDK 体系作为目标。同时会在 README 和 Packagist 描述中明确说明：

• 本项目是 community / unofficial SDK
• 不由 Longbridge 官方维护
• Longbridge 官方不承担该 SDK 的使用支持
• SDK 本身问题请在我项目仓库提交 issue

关于你提到的 Node.js 通过 FFI 的方式，我会作为后续技术路线参考。不过 PHP FFI 在部署、扩展启用、跨平台分发和普通用户安装体验上有一定门槛，因此当前版本会先保持纯 PHP + protobuf + Swoole 的实现方式，优先保证 PHP 用户可以简单安装和使用。

后续我会继续以社区项目方式维护。如果未来官方愿意在文档中以“社区项目”形式引用，我也很欢迎。再次感谢说明。