php 接口返回文件下载,文件下载_存储与 CDN_产品文档_帮助与文档-网易数帆

文件下载

S3 PHP SDK提供了丰富的文件下载接口，用户可以通过以下方式从S3获取文件:

下载文件到内存

下载到本地文件

分段下载

条件下载

下载文件到内存

以下源代码实现下载文件到内存中:

/**

* 获取对象

* @param $s3Client S3Client实例

* @param $bucketName 桶名

* @param $objectName 对象名

*/

function getObject($s3Client,$bucketName,$objectName){

try{

$result = $s3Client->getObject(['Bucket'=>$bucketName,

'Key'=>$objectName]);

// The 'Body' value of the result is an EntityBody object

echo get_class($result['Body']) . "\n";

// > Guzzle\Http\EntityBody

// The 'Body' value can be cast to a string

echo $result['Body'] . "\n";

// > Hello!

} catch (\Aws\Exception\AwsException $e){

echo $e->getMessage();

}

}

下载文件到本地文件

以下源代码实现将S3文件下载到本地文件:

/**

* 获取对象

* @param $s3Client S3Client实例

* @param $bucketName 桶名

* @param $objectName 对象名

* @param $fileName 存储的文件名

*/

function getObjectToLocalFile($s3Client,$bucketName,$objectName,$fileName){

try{

$result = $s3Client->getObject(['Bucket'=>$bucketName,

'Key'=>$objectName,

'SaveAs'=>$fileName]);

} catch (\Aws\Exception\AwsException $e){

echo $e->getMessage();

}

}

范围下载

如果存储在S3中的文件较大，并且您只需要其中的一部分内容，您可以使用范围下载，下载指定范围的数据，如果指定的下载范围为"0-100"，则返回结果为第0字节到第100字节的数据，返回的数据包含第100字节，即[0,100]，如果指定的范围无效则下载整个文件，以下源代码获取[0,100]字节的内容:

/**

* 获取对象

* @param $s3Client S3Client实例

* @param $bucketName 桶名

* @param $objectName 对象名

* @param $fileName 存储的文件名

*/

function getObjectOfRange($s3Client,$bucketName,$objectName,$range){

try{

$result = $s3Client->getObject(['Bucket'=>$bucketName,

'Key'=>$objectName,

'Range'=>$range]);

echo $result['Body'] . "\n";

} catch (\Aws\Exception\AwsException $e){

echo $e->getMessage();

}

}

getObjectOfRange($s3Client,$bucketName,$objectName,'bytes=0-3');

Attention

下载内容也可以存储到文件中

注意下载的区间为闭区间

条件下载

下载文件时，可以指定限定条件，满足限定条件时下载，不满足时报错，不下载文件。可以使用的限定条件如下：

参数说明NosClient对应值

If-Modified-Since如果指定的时间早于实际修改时间，则正常传送。否则返回错误NosClient::NOS_IF_MODIFIED_SINCE

/**

* @param $s3Client S3Client实例

* @param $bucketName 桶名

* @param $objectName 对象名

* @param $lastMod mixed type: string (date format)|int (unix timestamp)|\DateTime

*/

function getObjectByLastModifiedTime($s3Client,$bucketName,$objectName,$lastMod){

try{

$result = $s3Client->getObject(['Bucket'=>$bucketName,

'Key'=>$objectName,

'IfModifiedSince'=>$lastMod]);

echo $result['Body'] . "\n";

} catch (\Aws\Exception\AwsException $e){

echo $e->getMessage();

}

}

Attention

1.下载内容也可以存储到文件中