PHPackages                             westng/oceanengine-sdk-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. westng/oceanengine-sdk-php

ActiveLibrary[API Development](/categories/api)

westng/oceanengine-sdk-php
==========================

巨量引擎开放平台PHP语言SDK

4.0.3(2mo ago)14411[3 issues](https://github.com/whalesky-labs/oceanengine-sdk-php/issues)MITPHPPHP >=8.0CI passing

Since Jan 10Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/whalesky-labs/oceanengine-sdk-php)[ Packagist](https://packagist.org/packages/westng/oceanengine-sdk-php)[ RSS](/packages/westng-oceanengine-sdk-php/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (5)Versions (22)Used By (0)

 [![OceanEngine SDK for PHP](https://avatars.githubusercontent.com/u/277389313?s=200&v=4)](https://avatars.githubusercontent.com/u/277389313?s=200&v=4)

OceanEngine SDK for PHP
=======================

[](#oceanengine-sdk-for-php)

 巨量引擎开放平台 PHP SDK

 🚀 巨量引擎开放平台 PHP SDK - 为 PHP 开发者提供完整的巨量引擎 API 集成解决方案

 [![PHP >= 8.1](https://camo.githubusercontent.com/4cc99e4b10627fa5bb11782e3a51e7daace17a2107820826c485fd66d8ebb2c9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/4cc99e4b10627fa5bb11782e3a51e7daace17a2107820826c485fd66d8ebb2c9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465) [![Composer package](https://camo.githubusercontent.com/cfea69caf9f850d3a18e7b85f4e69fee3bcab69d217964d280a8e4185c753183/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6d706f7365722d7061636b6167652d3838353633303f6c6f676f3d636f6d706f736572266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/cfea69caf9f850d3a18e7b85f4e69fee3bcab69d217964d280a8e4185c753183/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6d706f7365722d7061636b6167652d3838353633303f6c6f676f3d636f6d706f736572266c6f676f436f6c6f723d7768697465) [![Guzzle 7.x](https://camo.githubusercontent.com/ee3e5fcb6b21446a6b8fec895260146ad98312462eade0a7b075ed202d9b7051/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f47757a7a6c652d372e782d304538334344)](https://camo.githubusercontent.com/ee3e5fcb6b21446a6b8fec895260146ad98312462eade0a7b075ed202d9b7051/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f47757a7a6c652d372e782d304538334344) [![License](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

📖 概述
----

[](#-概述)

在技术蓬勃发展的当下，巨量引擎开放平台的 Marketing API SDK，本应是普惠所有开发者的得力工具，涵盖巨量广告、巨量千川、巨量本地推、巨量星图及企业号相关功能，从 Token 获取到请求封装、响应解释，每个环节都暗藏助力高效开发的玄机。

其本地化设计，理应为开发者开辟便捷通道，无论经验如何，都能借它在 API 调用之路上畅行无阻。可现实却令人咋舌，面对 PHP 这片高手云集、活力满满的领域，官方竟然缺失 PHP 版本的 SDK！

这简直荒谬至极。PHP 开发者们为互联网立下汗马功劳，如今却像被抛弃的孩子。看着其他语言开发者仗着官方 SDK 大步快跑，自己只能徒手在荆棘中挣扎，太不公平！好比马拉松赛场，别人装备精良、补给充足，自己却赤脚前行、无水可饮。

幸有补救性 SDK，让 PHP 开发者不至于掉队，能凭本事搭起投放管理系统，但背后是他们付出的诸多额外心血。官方这种"偏心"做法，实在该反省，给 PHP 开发者们一个交代！

✨ 特性
----

[](#-特性)

- 🎯 **完整覆盖**：支持巨量广告、千川、本地推、星图等全平台 API
- ⚡ **高性能**：基于 GuzzleHttp，支持连接复用和智能重试
- 🧠 **运行时自适配**：自动识别 FPM/CLI/Swoole 运行环境并调整连接复用策略
- 🔧 **易配置**：支持环境变量、配置文件等多种配置方式
- 🛡️ **强健性**：内置错误处理、重试机制、频控处理
- 📚 **文档完善**：详细的使用文档和示例代码
- 🔄 **现代化**：支持 PHP 8.0+，使用现代 PHP 特性

🚀 快速开始
------

[](#-快速开始)

### 环境要求

[](#环境要求)

- **PHP >= 8.0**
- **GuzzleHttp 7.0+** (自动安装)
- **推荐使用 Composer** 安装依赖

### 安装

[](#安装)

```
composer require westng/oceanengine-sdk-php
```

### 基础使用

[](#基础使用)

```