使用PHP SDK上傳文件
本文通過示例詳細介紹如何使用服務(wù)端上傳SDK(PHP語言)將各類媒體文件上傳至點播存儲。
整體說明
建議在PHP中構(gòu)建BS(Browser/Server)架構(gòu)進行開發(fā)。
從內(nèi)部邏輯角度看,PHP上傳SDK遵循點播服務(wù)端SDK的通用流程。詳情請參見上傳流程。從操作角度看,使用PHP上傳SDK的基礎(chǔ)流程如下:
完成前提條件。請參見前提條件。
集成PHP上傳SDK。請參見集成PHP上傳SDK。
實現(xiàn)上傳邏輯(主要是上傳信息配置)。
音視頻上傳請參見場景一:上傳音視頻。
圖片上傳請參見場景二:上傳圖片。
輔助媒資上傳請參見場景三:上傳輔助媒資文件。
PHP上傳SDK默認服務(wù)接入點為
cn-shanghai
(上海), 若需要上傳媒體文件到其他區(qū)域,可以通過AliyunVodUploader
在初始化時指定區(qū)域,點播支持的服務(wù)接入點,請參見服務(wù)接入點。以指定上傳區(qū)域為
cn-beijing
(北京)為例,配置示例如下:$apiRegionId = 'cn-beijing'; //上傳目標區(qū)域region $uploader = new AliyunVodUploader($accessKeyId, $accessKeySecret, $apiRegionId);
前提條件
您已經(jīng)開通了視頻點播服務(wù)。開通步驟請參見開通視頻點播服務(wù)。
您已經(jīng)完成上傳相關(guān)的系統(tǒng)配置,包括啟用目標存儲地域的存儲地址和配置回調(diào)。操作指引請參見管理存儲Bucket及回調(diào)設(shè)置。
您已準備好用于調(diào)用點播服務(wù)的賬號。為避免阿里云賬號AccessKey泄露帶來的安全風險,推薦您創(chuàng)建RAM用戶并授予其VOD相關(guān)權(quán)限。然后使用RAM用戶的AK對(AccessKey ID和AccessKey Secret)訪問點播服務(wù)。操作指引請參見創(chuàng)建RAM用戶并授權(quán)。
已配置環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。具體操作,請參見在Linux、macOS和Windows系統(tǒng)配置環(huán)境變量。
重要阿里云賬號的AccessKey擁有所有API的訪問權(quán)限,建議您使用RAM用戶的AccessKey進行API訪問或日常運維。
強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
(可選)如需使用STS臨時授權(quán)方式(阿里云Security Token Service)訪問點播服務(wù),請為RAM用戶創(chuàng)建角色并授予角色VOD相關(guān)權(quán)限。操作指引請參見使用STS臨時授權(quán)方案上傳視頻。
說明STS臨時授權(quán)方式的適用場景請參見憑證方式與STS方式對比。
集成PHP上傳SDK
更新PHP上傳SDK
若發(fā)現(xiàn)新的接口或已有接口新的功能在當前SDK沒有,請下載最新的PHP上傳SDK覆蓋到本地SDK文件。更多信息,請參見上傳SDK。
您可以打開voduploadsdk目錄下的ChangeLog.txt文件查看當前SDK的版本號和發(fā)布日期。
PHP上傳SDK目錄說明
/VodUploadSDK-PHP_1.0.3.zip解壓目錄/VodUploadSDK-PHP_1.0.3/voduploadsdk/uploader
UploadVideoRequest.php
目錄
說明
UploadVideoRequest
上傳視頻的請求類,字段請參見獲取音視頻上傳地址和憑證。
UploadImageRequest.php
目錄
說明
UploadImageRequest
上傳圖片的請求類,字段請參見獲取圖片上傳地址和憑證。
UploadAttachedMediaRequest.php
目錄
說明
UploadAttachedMediaRequest
上傳輔助媒資的請求類,字段請參見獲取輔助媒資上傳地址和憑證。
AliyunVodUploader.php
目錄
說明
__construct
uploadLocalVideo
上傳本地視頻的接口。
uploadWebVideo
上傳網(wǎng)絡(luò)視頻的接口。
uploadLocalImage
上傳本地圖片。
uploadWebImage
上傳網(wǎng)絡(luò)圖片。
uploadLocalAttachedMedia
上傳本地輔助媒資文件。
uploadWebAttachedMedia
上傳網(wǎng)絡(luò)輔助媒資文件。
uploadLocalM3u8
上傳本地m3u8文件。
uploadWebM3u8
上傳網(wǎng)絡(luò)m3u8文件。
parseM3u8File
解析m3u8索引文件得到分片地址列表。
setEcsRegionId
設(shè)置上傳腳本部署的ECS區(qū)域(如果有),如果與視頻點播存儲同一區(qū)域會自動啟用內(nèi)網(wǎng)上傳。
setEnableSSL
是否啟用SSL(網(wǎng)絡(luò)請求使用HTTPS),默認不啟用,以避免相關(guān)擴展未安裝或配置異常時無法使用。
uploadProgressCallback
上傳進度回調(diào)函數(shù),可重寫。
AliyunVodUtils.php
目錄
說明
AliyunVodUtils
工具類,提供截取字符串、獲取擴展名、獲取文件名等靜態(tài)函數(shù)。
AliyunVodLog
實現(xiàn)簡單打印的日志類,logSwitch為日志開關(guān)。
AliyunVodDownloader
實現(xiàn)下載網(wǎng)絡(luò)文件。
AliyunVodReportUpload
實現(xiàn)上傳進度匯報。
AliyunVodError
定義錯誤碼。
/VodUploadSDK-PHP_1.0.3.zip解壓目錄/VodUploadSDK-PHP_1.0.3/voduploadsdk
aliyun-php-sdk-core:上傳SDK依賴的基礎(chǔ)類,封裝了阿里云API簽名和HTTP請求等。
aliyun-php-sdk-vod:視頻點播的服務(wù)端接口SDK,封裝了視頻點播API的請求。
aliyun-php-sdk-oss:上傳SDK依賴的OSS類,封裝了OSS上傳等操作。
/VodUploadSDK-PHP_1.0.3.zip解壓目錄/VodUploadSDK-PHP_1.0.3/samples
uploadVideo.php:上傳視頻的示例代碼。
uploadImage.php:上傳圖片的示例代碼。
uploadAttachedMedia.php:上傳輔助媒資的示例代碼。
場景一:上傳音視頻
普通音視頻
音視頻上傳目前支持以下類型文件上傳:
上傳本地文件,使用分片上傳,最大支持48.8 TB的單個文件,不支持斷點續(xù)傳。請參見testUploadLocalVideo函數(shù)。
上傳網(wǎng)絡(luò)文件,可指定文件URL進行上傳,最大支持48.8 TB的單個文件。該上傳方式需要先將網(wǎng)絡(luò)文件下載到本地磁盤,再進行上傳,所以要保證本地磁盤有充足的空間。請參見testUploadWebVideo函數(shù)。
<?php
/**
* Created by Aliyun ApsaraVideo VOD.
*/
require_once dirname(__DIR__) . DIRECTORY_SEPARATOR . 'voduploadsdk' . DIRECTORY_SEPARATOR . 'Autoloader.php';
date_default_timezone_set('PRC');
//測試上傳本地視頻
function testUploadLocalVideo($accessKeyId, $accessKeySecret, $filePath)
{
try {
$uploader = new AliyunVodUploader($accessKeyId, $accessKeySecret);
$uploadVideoRequest = new UploadVideoRequest($filePath, 'testUploadLocalVideo via PHP-SDK');
//$uploadVideoRequest->setCateId(1);
//CoverURL示例:http://example.com/example****.jpg
//$uploadVideoRequest->setCoverURL("<your CoverURL>");
//$uploadVideoRequest->setTags('test1,test2');
//$uploadVideoRequest->setStorageLocation('outin-xx.oss-cn-beijing.aliyuncs.com');
//$uploadVideoRequest->setTemplateGroupId('6ae347b0140181ad371d197ebe289****');
$userData = array(
//Callback示例:https://demo.aliyundoc.com/ProcessMessageCallback
"MessageCallback"=>array("CallbackURL"=>"<your callback URL>"),
"Extend"=>array("localId"=>"xxx", "test"=>"www")
);
$uploadVideoRequest->setUserData(json_encode($userData));
$res = $uploader->uploadLocalVideo($uploadVideoRequest);
print_r($res);
} catch (Exception $e) {
printf("testUploadLocalVideo Failed, ErrorMessage: %s\n Location: %s %s\n Trace: %s\n",
$e->getMessage(), $e->getFile(), $e->getLine(), $e->getTraceAsString());
}
}
// 測試上傳網(wǎng)絡(luò)視頻
function testUploadWebVideo($accessKeyId, $accessKeySecret, $fileURL)
{
try {
$uploader = new AliyunVodUploader($accessKeyId, $accessKeySecret);
$uploadVideoRequest = new UploadVideoRequest($fileURL, 'testUploadWebVideo via PHP-SDK');
$res = $uploader->uploadWebVideo($uploadVideoRequest);
print_r($res);
} catch (Exception $e) {
printf("testUploadWebVideo Failed, ErrorMessage: %s\n Location: %s %s\n Trace: %s\n",
$e->getMessage(), $e->getFile(), $e->getLine(), $e->getTraceAsString());
}
}
#### 執(zhí)行測試代碼 ####
// 阿里云賬號AccessKey擁有所有API的訪問權(quán)限,建議您使用RAM用戶進行API訪問或日常運維。
// 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
// 本示例通過從環(huán)境變量中讀取AccessKey,來實現(xiàn)API訪問的身份驗證。運行代碼示例前,請配置環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
$accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');
$accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
$localFilePath = '/opt/video/sample.mp4';
// testUploadLocalVideo($accessKeyId, $accessKeySecret, $localFilePath);
// webFileURL示例:http://example-bucket-****.cn-shanghai.aliyuncs.com/b55b904bc612463b812990b7c8cc****/daa30814c0c340cf8199926f78aa****-a0bc05ba62c3e95cc672e88b8281****-ld.mp4?auth_key=1608774986-0-0-c56acd302bea0c331370d8ed6865****
$webFileURL = '<your webFileURL>';
testUploadWebVideo($accessKeyId, $accessKeySecret, $webFileURL);
M3U8視頻文件
部分代碼示例如下所示:
<?php
/**
* Created by Aliyun ApsaraVideo VOD.
*/
require_once dirname(__DIR__) . DIRECTORY_SEPARATOR . 'voduploadsdk' . DIRECTORY_SEPARATOR . 'Autoloader.php';
date_default_timezone_set('PRC');
// 測試上傳本地m3u8視頻
function testUploadLocalM3u8($accessKeyId, $accessKeySecret, $m3u8FilePath)
{
try {
$uploader = new AliyunVodUploader($accessKeyId, $accessKeySecret);
$uploadVideoRequest = new UploadVideoRequest($m3u8FilePath, 'testUploadLocalM3u8 via PHP-SDK');
// 調(diào)用接口解析m3u8的分片地址列表,如果解析結(jié)果不準確,請自行拼接地址列表(默認分片文件和m3u8文件位于同一目錄)
$sliceFiles = $uploader->parseM3u8File($m3u8FilePath);
//print_r($sliceFiles);
$res = $uploader->uploadLocalM3u8($uploadVideoRequest, $sliceFiles);
print_r($res);
} catch (Exception $e) {
printf("testUploadLocalM3u8 Failed, ErrorMessage: %s\n Location: %s %s\n Trace: %s\n",
$e->getMessage(), $e->getFile(), $e->getLine(), $e->getTraceAsString());
}
}
// 測試上傳網(wǎng)絡(luò)m3u8視頻
function testUploadWebM3u8($accessKeyId, $accessKeySecret, $m3u8FileUrl)
{
try {
$uploader = new AliyunVodUploader($accessKeyId, $accessKeySecret);
$uploadVideoRequest = new UploadVideoRequest($m3u8FileUrl, 'testUploadWebM3u8 via PHP-SDK');
// 調(diào)用接口解析m3u8的分片地址列表,如果解析結(jié)果不準確,請自行拼接地址列表(默認分片文件和m3u8文件位于同一目錄)
$sliceFileUrls = $uploader->parseM3u8File($m3u8FileUrl);
//print_r($sliceFileUrls);
$res = $uploader->uploadWebM3u8($uploadVideoRequest, $sliceFileUrls);
print_r($res);
} catch (Exception $e) {
printf("testUploadWebM3u8 Failed, ErrorMessage: %s\n Location: %s %s\n Trace: %s\n",
$e->getMessage(), $e->getFile(), $e->getLine(), $e->getTraceAsString());
}
}
#### 執(zhí)行測試代碼 ####
// 阿里云賬號AccessKey擁有所有API的訪問權(quán)限,建議您使用RAM用戶進行API訪問或日常運維。
// 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
// 本示例通過從環(huán)境變量中讀取AccessKey,來實現(xiàn)API訪問的身份驗證。運行代碼示例前,請配置環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
$accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');
$accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
$localM3u8FilePath = '/opt/video/m3u8/sample.m3u8';
//testUploadLocalM3u8($accessKeyId, $accessKeySecret, $localM3u8FilePath);
//webM3u8FileURL示例:http://example-bucket-****.cn-shanghai.aliyuncs.com/b55b904bc612463b812990b7c8cc****/daa30814c0c340cf8199926f78aa****-195a25af366b5edae324c47e99a0****-ld.m3u8?auth_key=1608775606-0-0-9fb038deaecd009dadd86721c585****
$webM3u8FileURL = '<your webM3u8FileURL>';
//testUploadWebM3u8($accessKeyId, $accessKeySecret, $webM3u8FileURL);
場景二:上傳圖片
<?php
/**
* Created by Aliyun ApsaraVideo VoD.
* User: https://www.aliyun.com/product/vod
* API document: http://m.bestwisewords.com/document_detail/55619.html
*/
require_once dirname(__DIR__) . DIRECTORY_SEPARATOR . 'voduploadsdk' . DIRECTORY_SEPARATOR . 'Autoloader.php';
date_default_timezone_set('PRC');
// 測試上傳本地圖片
function testUploadLocalImage($accessKeyId, $accessKeySecret, $filePath)
{
try {
$uploader = new AliyunVodUploader($accessKeyId, $accessKeySecret);
$uploadImageRequest = new UploadImageRequest($filePath, 'testUploadLocalImage via PHP-SDK');
$uploadImageRequest->setCateId(1000009458);
$res = $uploader->uploadLocalImage($uploadImageRequest);
print_r($res);
} catch (Exception $e) {
printf("testUploadLocalImage Failed, ErrorMessage: %s\n", $e->getMessage());
}
}
// 測試上傳網(wǎng)絡(luò)圖片
function testUploadWebImage($accessKeyId, $accessKeySecret, $fileURL)
{
try {
$uploader = new AliyunVodUploader($accessKeyId, $accessKeySecret);
$uploadImageRequest = new UploadImageRequest($fileURL, 'testUploadWebImage via PHP-SDK');
$uploadImageRequest->setCateId(1000009458);
$res = $uploader->uploadWebImage($uploadImageRequest);
print_r($res);
} catch (Exception $e) {
printf("testUploadWebImage Failed, ErrorMessage: %s\n", $e->getMessage());
}
}
#### 執(zhí)行測試代碼 ####
// 阿里云賬號AccessKey擁有所有API的訪問權(quán)限,建議您使用RAM用戶進行API訪問或日常運維。
// 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
// 本示例通過從環(huán)境變量中讀取AccessKey,來實現(xiàn)API訪問的身份驗證。運行代碼示例前,請配置環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
$accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');
$accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
$localFilePath = '/opt/image/test-image.jpg';
//testUploadLocalImage($accessKeyId, $accessKeySecret, $localFilePath);
$webFileURL = 'http://vod-download.cn-shanghai.aliyuncs.com/retina/pic/20180208/496AE240-54AE-4CC8-8578-3EEC8F38****.gif';
testUploadWebImage($accessKeyId, $accessKeySecret, $webFileURL);
場景三:上傳輔助媒資文件
部分代碼示例如下所示:
<?php
/**
* Created by Aliyun ApsaraVideo VoD.
* User: https://www.aliyun.com/product/vod
* API document: http://m.bestwisewords.com/document_detail/98467.html
*/
require_once dirname(__DIR__) . DIRECTORY_SEPARATOR . 'voduploadsdk' . DIRECTORY_SEPARATOR . 'Autoloader.php';
date_default_timezone_set('PRC');
// 測試上傳本地輔助媒資文件
function testUploadLocalAttachedMedia($accessKeyId, $accessKeySecret, $filePath)
{
try {
$uploader = new AliyunVodUploader($accessKeyId, $accessKeySecret);
$uploadAttachedRequest = new UploadAttachedMediaRequest($filePath, 'watermark',
'testUploadLocalAttachedMedia via PHP-SDK');
//$uploadAttachedRequest->setCateId(100000****);
$res = $uploader->uploadLocalAttachedMedia($uploadAttachedRequest);
print_r($res);
} catch (Exception $e) {
printf("testUploadLocalAttachedMedia Failed, ErrorMessage: %s\n", $e->getMessage());
}
}
// 測試上傳網(wǎng)絡(luò)輔助媒資文件
function testUploadWebAttachedMedia($accessKeyId, $accessKeySecret, $fileURL)
{
try {
$uploader = new AliyunVodUploader($accessKeyId, $accessKeySecret);
$uploadAttachedRequest = new UploadAttachedMediaRequest($fileURL, 'watermark',
'testUploadWebAttachedMedia via PHP-SDK');
//$uploadAttachedRequest->setCateId(100000****);
$res = $uploader->uploadWebAttachedMedia($uploadAttachedRequest);
print_r($res);
} catch (Exception $e) {
printf("testUploadWebAttachedMedia Failed, ErrorMessage: %s\n", $e->getMessage());
}
}
#### 執(zhí)行測試代碼 ####
// 阿里云賬號AccessKey擁有所有API的訪問權(quán)限,建議您使用RAM用戶進行API訪問或日常運維。
// 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
// 本示例通過從環(huán)境變量中讀取AccessKey,來實現(xiàn)API訪問的身份驗證。運行代碼示例前,請配置環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
$accessKeyId = getenv('ALIBABA_CLOUD_ACCESS_KEY_ID');
$accessKeySecret = getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET');
$localFilePath = '/opt/image/test.png';
//testUploadLocalAttachedMedia($accessKeyId, $accessKeySecret, $localFilePath);
$webFileURL = 'http://vod-download.cn-shanghai.aliyuncs.com/retina/pic/20180208/496AE240-54AE-4CC8-8578-3EEC8F38****.gif';
testUploadWebAttachedMedia($accessKeyId, $accessKeySecret, $webFileURL);