PHPackages                             jdcloud-api/jdcloud-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. jdcloud-api/jdcloud-sdk-php

ActiveLibrary

jdcloud-api/jdcloud-sdk-php
===========================

JDCloud SDK for PHP

5.3.56(2mo ago)105.1k↑1478.9%9[11 issues](https://github.com/jdcloud-api/jdcloud-sdk-php/issues)[2 PRs](https://github.com/jdcloud-api/jdcloud-sdk-php/pulls)Apache-2.0PHPPHP &gt;=5.5CI failing

Since Jul 4Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/jdcloud-api/jdcloud-sdk-php)[ Packagist](https://packagist.org/packages/jdcloud-api/jdcloud-sdk-php)[ Docs](https://www.jdcloud.com/help/faq?act=3)[ RSS](/packages/jdcloud-api-jdcloud-sdk-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (192)Used By (0)

简介
==

[](#简介)

欢迎使用京东云开发者Php工具套件（Php SDK）。使用京东云Php SDK，您无需复杂编程就可以访问京东云提供的各种服务。

为了方便您理解SDK中的一些概念和参数的含义，使用SDK前建议您先查看[京东云OpenAPI使用入门](http://www.jdcloud.com/help/detail/355/isCatalog/0)。要了解每个API的具体参数和含义，请参考程序注释或参考OpenAPI&amp;SDK下具体产品线的API文档。

环境准备
====

[](#环境准备)

1.京东云Php SDK适用于Php 5.5及以上。

2.在开始调用京东云open API之前，需提前在京东云用户中心账户管理下的[AccessKey管理页面](https://uc.jdcloud.com/accesskey/index)申请accesskey和secretKey密钥对（简称AK/SK）。AK/SK信息请妥善保管，如果遗失可能会造成非法用户使用此信息操作您在云上的资源，给你造成数据和财产损失。

SDK使用方法
=======

[](#sdk使用方法)

建议使用Composer安装京东云Php SDK：

首先在composer.json添加

```
"require" : {
	"php" : ">=5.5",
	"jdcloud-api/jdcloud-sdk-php" : ">=4.0.0"
}

```

然后使用Composer安装

```
php composer.phar install

```

或

```
composer install

```

您还可以下载sdk源代码自行使用。

SDK使用中的任何问题，欢迎您[SDK使用问题反馈页面](https://github.com/jdcloud-api/jdcloud-sdk-php/issues)交流。

注意：京东云并没有提供其他下载方式，请务必使用上述官方下载方式！

调用示例
----

[](#调用示例)

以下是创建单个云主机实例详情的调用示例

```
use Jdcloud\Credentials\Credentials;
use Jdcloud\Result;
use Jdcloud\Vm\VmClient;
public function testCreateInstances()
{
    $vm = new VmClient([
        'credentials'  => new Credentials('ak', 'sk'),
        'version' => 'latest',
        'scheme' => 'https'
    ]);

    try{
        $res = $vm->createInstances([
            'regionId'  => 'cn-north-1',
            'instanceSpec' => [
                'az' => 'cn-north-1a',
                'imageId' => '8e187a0a-ea7c-4ad1-ba32-f21e52fb8926',
                'instanceType' =>  'g.n2.medium',
                'name' => 'phpcreate',
                'primaryNetworkInterface' => [
                    'networkInterface' => [
                        'subnetId' => 'subnet-ll47yy373i'
                     ]
                ],
                'systemDisk' => [
                    'diskCategory' => 'local'
                ]
            ]
        ]);
        print_r($res);
        print("Request Id: ". $res['requestId']. "\n");
        print_r($res['result']);
    }catch (\Jdcloud\Exception\JdcloudException $e) {
        print("Detail Message: " . $e->getMessage(). "\n");
        print("Request Id: ". $e->getJdcloudRequestId(). "\n");
        print("Error Type: ". $e->getJdcloudErrorType(). "\n");
        print("Error Code: " . $e->getJdcloudErrorCode(). "\n");
        print("Error Detail Status: ". $e->getJdcloudErrorStatus(). "\n");
        print("Error Detail Message: ". $e->getJdcloudErrorMessage(). "\n");
    }
}

```

如果需要设置额外的header，例如要调用开启了MFA操作保护的接口，需要传递x-jdcloud-security-token，则按照如下方式：

```
    $res = $vm->deleteInstances([
        'regionId'  => 'cn-north-1',
        'instanceId'  => 'xxx',
        'extraHeaders' => [
            'x-jdcloud-security-token' => 'xxxx'
        ]
    ]);

```

如果需要设置访问点，配置超时等，请参考如下更复杂的例子：

```
$fix_endpoint = EndpointProvider::patterns([
    '*/*' => ['endpoint' => 'vm.cn-north-1.jdcloud-api.com'] //指定非默认访问地址 step 1
]);

$vm = new VmClient([
    'credentials'  => new Credentials('ak', 'sk'),
    'version' => 'latest',
     'debug' => [
         'logfn'        => function ($msg) { echo $msg . "\n"; }, //输出调试详细日志
         ],
     'validate' => false, //关闭客户端参数验证
     'endpoint_provider' => $fix_endpoint, //指定非默认访问地址 step 2
     'scheme' => 'https',
     'http'    => [
        'verify' => 'C:/ca-bundle.crt', //指定本地证书文件
        'connect_timeout' => 20,   //指定连接超时
	'proxy' => 'http://192.168.16.1:10', //指定代理
         'timeout' => 5   //指定请求超时
    ]
]);

```

更多调用示例参考 [SDK使用Demo](https://github.com/jdcloud-api/jdcloud-sdk-php/tree/master/tests)

###  Health Score

53

—

FairBetter than 96% of packages

Maintenance73

Regular maintenance activity

Popularity30

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 71.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~14 days

Total

190

Last Release

68d ago

Major Versions

0.2.8 → 1.0.02018-09-28

1.2.3 → 2.0.02019-05-05

2.0.7 → 3.0.02019-09-04

3.0.1 → 4.0.02019-09-19

4.0.3 → 5.0.02019-11-29

### Community

Maintainers

![](https://www.gravatar.com/avatar/da7f3be5a9622f4d8afe5c3e32df5e3cbdf9acbd78586519619b941ad849d740?d=identicon)[wdwqw](/maintainers/wdwqw)

---

Top Contributors

[![jdcloud-apigateway](https://avatars.githubusercontent.com/u/47737830?v=4)](https://github.com/jdcloud-apigateway "jdcloud-apigateway (310 commits)")[![wdwqw](https://avatars.githubusercontent.com/u/34049321?v=4)](https://github.com/wdwqw "wdwqw (65 commits)")[![Tanc009](https://avatars.githubusercontent.com/u/18569287?v=4)](https://github.com/Tanc009 "Tanc009 (56 commits)")[![lidaobing](https://avatars.githubusercontent.com/u/27529?v=4)](https://github.com/lidaobing "lidaobing (1 commits)")[![shijunLee](https://avatars.githubusercontent.com/u/12538135?v=4)](https://github.com/shijunLee "shijunLee (1 commits)")

---

Tags

sdkcloudjdcloud

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jdcloud-api-jdcloud-sdk-php/health.svg)

```
[![Health](https://phpackages.com/badges/jdcloud-api-jdcloud-sdk-php/health.svg)](https://phpackages.com/packages/jdcloud-api-jdcloud-sdk-php)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k511.3M2.2k](/packages/aws-aws-sdk-php)[kreait/firebase-php

Firebase Admin SDK

2.4k39.7M72](/packages/kreait-firebase-php)[saloonphp/saloon

Build beautiful API integrations and SDKs with Saloon

2.4k9.6M467](/packages/saloonphp-saloon)[cloudinary/cloudinary_php

Cloudinary PHP SDK

39913.5M90](/packages/cloudinary-cloudinary-php)[huaweicloud/huaweicloud-sdk-php

Huawei Cloud SDK for PHP

1829.2k2](/packages/huaweicloud-huaweicloud-sdk-php)[onesignal/onesignal-php-api

A powerful way to send personalized messages at scale and build effective customer engagement strategies. Learn more at onesignal.com

34170.2k2](/packages/onesignal-onesignal-php-api)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
