1. 安装

1.2. 环境要求

  • php5.3+ 使用以下命令显示当前的php版本:

    php -v
    
  • cURL 扩展 使用以下命令查看curl扩展是否已经安装好:

    php -m
    
  • Windows下用户,请参考 Windows下使用NOS PHP SDK

1.3. 安装

1.3.1. composer方式

如果您通过composer管理您的项目依赖,可以在你的项目根目录运行:

composer require netease/nos-php-sdk

或者在你的composer.json中声明对NOS SDK for PHP的依赖:

"require": {
"netease/nos-php-sdk": "1.0.1"
}

然后通过conposer install 安装依赖,安装完成后形成如下目录结构:

.
├── app.php
├── composer.json
├── composer.lock
└── vendor

其中 app.php是用户的应用程序,vendor/目录下包含了所依赖的库,用户需要在 app.php中引入如下依赖:

require_once __DIR__ . '/vendor/autoload.php';

Attention

  1. 如果项目中已经引用过autoload.php,则加入了sdk依赖之后,不需要再引入autoload.php了
  2. 如果使用composer出现网络错误,可以使用composer中国区的镜像源,方法是在命令行执行:composer config -g repositories.packagist composer http://packagist.phpcomposer.com

1.3.2. phar方式

使用phar单文件方式,可以在以下 链接 ,下载已经打好包的phar文件,或者根据源文件自行编译,然后在你的源代码中引入phar文件:

require_once '/path/to/nos-sdk-php.phar';

1.3.3. 源码方式

使用SDK源码,在发布页面,选择相应的版本,下载打好包的zip文件,解压后的根目录中包含一个autoload.php文件,在您的代码中引入这个文件:

require_once '/path/to/nos-sdk/autoload.php';

1.4. 运行Samples

  • 解压下载到的sdk包
  • 修改samples目录中的Config.php文件
  1. 修改 NOS_ACCESS_ID, 您从NOS获得的AccessKeyId
  2. 修改 NOS_ACCESS_KEY, 您从NOS获得的AccessKeySecret
  3. 修改 NOS_ENDPOINT, 您选定的NOS数据中心访问域名,例如:nos-eastchina1.126.net
  4. 修改 NOS_TEST_BUCKET, 您要用来运行sample使用的bucket,sample 程序会在这个bucket中创建一些文件,注意不能用生产环境的bucket,以 免污染用户数据
  • 到samples目录中执行 php RunAll.php, 也可以单个运行某个Sample文件