安装
SDK
GitHub 地址: https://github.com/NetEase-Object-Storage/nos-php-sdk
ChangLog: https://github.com/NetEase-Object-Storage/nos-php-sdk/blob/master/README
历史版本: 无
环境要求
php5.3+ 使用以下命令显示当前的 php 版本:
php -v
cURL 扩展 使用以下命令查看 curl 扩展是否已经安装好:
php -m
Windows 下用户,请参考 Windows 下使用 NOS PHP SDK
安装
composer 方式
如果您通过 composer 管理您的项目依赖,可以在你的项目根目录运行:
composer require netease/nos-php-sdk
或者在你的 composer.json 中声明对 NOS SDK for PHP 的依赖:
"require": {
"netease/nos-php-sdk": "1.0.0"
}
然后通过 conposer install 安装依赖,安装完成后形成如下目录结构:
.
├── app.php
├── composer.json
├── composer.lock
└── vendor
其中 app.php 是用户的应用程序,vendor/ 目录下包含了所依赖的库,用户需要在 app.php 中引入如下依赖:
require_once __DIR__ . '/vendor/autoload.php';
-
如果项目中已经引用过 autoload.php,则加入了 sdk 依赖之后,不需要再引入 autoload.php 了
-
如果使用 composer 出现网络错误,可以使用 composer 中国区的镜像源,方法是在命令行执行:
composer config -g repositories.packagist composer http://packagist.phpcomposer.com
phar 方式
使用 phar 单文件方式,可以在以下 链接,下载已经打好包的 phar 文件,或者根据源文件自行编译,然后在你的源代码中引入 phar 文件:
require_once '/path/to/nos-sdk-php.phar';
源码方式
使用 SDK 源码,在发布页面,选择相应的版本,下载打好包的 zip 文件,解压后的根目录中包含一个 autoload.php 文件,在您的代码中引入这个文件:
require_once '/path/to/nos-sdk/autoload.php';
运行 Samples
Note
本示例包含删除桶内文件和桶的操作,程序最后会将测试用的桶及其桶内文件删除,不要在生产环境下测试此示例。
- 解压下载到的 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 文件