Download the PHP package westng/oceanengine-sdk-php without Composer
On this page you can find all versions of the php package westng/oceanengine-sdk-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
Informations about the package oceanengine-sdk-php
Marketing PHP SDK
🚀 巨量引擎开放平台 PHP SDK - 为 PHP 开发者提供完整的巨量引擎 API 集成解决方案
📖 概述
在技术蓬勃发展的当下，巨量引擎开放平台的 Marketing API SDK，本应是普惠所有开发者的得力工具，涵盖巨量广告、巨量千川、巨量本地推、巨量星图及企业号相关功能，从 Token 获取到请求封装、响应解释，每个环节都暗藏助力高效开发的玄机。
其本地化设计，理应为开发者开辟便捷通道，无论经验如何，都能借它在 API 调用之路上畅行无阻。可现实却令人咋舌，面对 PHP 这片高手云集、活力满满的领域，官方竟然缺失 PHP 版本的 SDK！
这简直荒谬至极。PHP 开发者们为互联网立下汗马功劳，如今却像被抛弃的孩子。看着其他语言开发者仗着官方 SDK 大步快跑，自己只能徒手在荆棘中挣扎，太不公平！好比马拉松赛场，别人装备精良、补给充足，自己却赤脚前行、无水可饮。
幸有补救性 SDK，让 PHP 开发者不至于掉队，能凭本事搭起投放管理系统，但背后是他们付出的诸多额外心血。官方这种"偏心"做法，实在该反省，给 PHP 开发者们一个交代！
✨ 特性
- 🎯 完整覆盖：支持巨量广告、千川、本地推、星图等全平台 API
- ⚡ 高性能：基于 GuzzleHttp，支持连接复用和智能重试
- 🔧 易配置：支持环境变量、配置文件等多种配置方式
- 🛡️ 强健性：内置错误处理、重试机制、频控处理
- 📚 文档完善：详细的使用文档和示例代码
- 🔄 现代化：支持 PHP 8.0+，使用现代 PHP 特性
🚀 快速开始
环境要求
- PHP >= 8.0
- GuzzleHttp 7.0+ (自动安装)
- 推荐使用 Composer 安装依赖
安装
基础使用
📋 使用条件
开发者条件
- 使用 SDK 需要首先注册成为巨量引擎开发者，请参考开发者快速入门文档
- 使用 SDK 需要先拥有 API 的访问权限，所有 SDK 的使用与应用拥有的权限组相关联
📁 项目结构
📚 详细使用指南
1. 用户授权（获取 Access Token）
获取授权 URL
| 参数 | 说明 | 默认值 | 示例值 |
|---|---|---|---|
cb_url |
回调链接 | - | https://xxx.xxx.xxx |
scope |
授权范围（全部权限 null 即可） | - | - |
state |
自定义参数 | your_custom_params | - |
type |
授权类型 | QC | QC｜AD |
获取 Access Token
2. API 调用
配置重试机制
| 参数 | 说明 | 默认值 | 示例值 |
|---|---|---|---|
maxRetries |
最大重试次数 | 3 | 5 |
retryDelay |
重试延迟（毫秒） | 1000 | 2000 |
retryableStatusCodes |
可重试 HTTP 状态码 | [408, 429, 500, 502, 503, 504] | [408, 429, 500] |
enableRetry |
是否启用重试 | true | false |
retryableBusinessCodes |
可重试业务错误码 | [40100, 40110, 50000] | [40100, 50000] |
获取广告主信息
🔧 配置说明
环境变量配置
创建 .env 文件：
配置优先级
- 系统环境变量 (最高优先级)
- .env 文件
- 默认配置 (最低优先级)
🚨 错误处理
SDK 提供了完善的错误处理机制：
📊 开发进度
| 模块 | 调用方式 | 状态 | 文档 |
|---|---|---|---|
| 账户管理 | $client->module('Account') |
✅ 已完成 | 查看文档 |
| 素材管理 | $client->module('Materials') |
✅ 已完成 | 查看文档 |
| 数据报表 | $client->module('DataReports') |
✅ 已完成 | 查看文档 |
| 工具 | $client->module('Tools') |
✅ 已完成 | 查看文档 |
| 巨量广告 | $client->module('JuLiangAds') |
✅ 已完成 | 查看文档 |
| 巨量千川 | $client->module('JuLiangQianChuan') |
✅ 已完成 | 查看文档 |
| 巨量星图 | $client->module('JuLiangStarMap') |
✅ 已完成 | 查看文档 |
| 巨量本地推 | $client->module('JuLiangLocalPush') |
✅ 已完成 | 查看文档 |
| 企业号 | $client->module('EnterpriseAccount') |
⏳ 未开始 | - |
⚠️ 上述进度仅供参考，实际以源码为准。
🧠 欢迎查看源码深入探索，接口比文档更诚实！
📚 相关文档
- 🚀 HTTP 迁移指南 - 了解从 cURL 到 GuzzleHttp 的迁移
- ⚙️ 配置管理指南 - 学习如何使用.env 文件和配置管理
- 🚨 错误码说明 - 了解 HTTP 状态码和业务错误码的处理
- 🧪 测试文件迁移指南 - 了解测试文件的现代化改进
🤝 贡献指南
欢迎提交 Issue 和 Pull Request！
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
📄 开源协议
本项目采用 MIT 协议 - 查看 LICENSE 文件了解详情。
📞 问题反馈
如在使用过程中遇到问题、建议或灵感……请无视（开玩笑的）。
📨 实在憋不住可以提 Issue 或 PR ～
**如果这个项目对您有帮助，请给个 ⭐️ 支持一下！**
Made with ❤️ by [westng](https://github.com/westng)
All versions of oceanengine-sdk-php with dependencies
PHP Build Version
Package Version
The package westng/oceanengine-sdk-php contains the following files
Loading the files please wait ....