1. 安装¶
1.1. SDK¶
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
- 如果项目中已经引用过autoload.php,则加入了sdk依赖之后,不需要再引入autoload.php了
- 如果使用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文件
- 修改 NOS_ACCESS_ID, 您从NOS获得的AccessKeyId
- 修改 NOS_ACCESS_KEY, 您从NOS获得的AccessKeySecret
- 修改 NOS_ENDPOINT, 您选定的NOS数据中心访问域名,例如:nos-eastchina1.126.net
- 修改 NOS_TEST_BUCKET, 您要用来运行sample使用的bucket,sample 程序会在这个bucket中创建一些文件,注意不能用生产环境的bucket,以 免污染用户数据
- 到samples目录中执行 php RunAll.php, 也可以单个运行某个Sample文件