第詳解PHP使用OSS上傳文件目錄一、安裝阿里云osssdk二、使用1、獲取OSSAccessKeyId、AccessKeySecret2、簡易上傳Html處理3、控制器處理OssImageController.php4、service層處理OssImageService.php5、oss實例及參數獲取封裝AliOss.php6、結果是可以上傳成功三、問題說明

一、安裝阿里云osssdk

在網站根目錄執行下面命令，安裝osssdk。

composerrequirealiyuncs/oss-sdk-php

安裝后，會在網站根目錄/vendor下找到一個名為`aliyuncs`的文件夾。

注：[阿里云oss-sdk文檔（可不用關注）](/document_detail/32099.html"官方oss-sdk文檔")

二、使用

1、獲取OSSAccessKeyId、AccessKeySecret

如果沒有這兩個數據可以參考/m_nanle_xiaobudiu/article/details/101756805。

2、簡易上傳Html處理

upload.html

!DOCTYPEhtml

htmllang="en"

head

metacharset="UTF-8"

title小卜丟個人站-oss圖片上傳/title

/head

body

formaction="oss-image/upload-image.json"method="post"enctype="multipart/form-data"

labelfor="file"文件名：/label

inputtype="file"name="image"id="file"br

inputtype="submit"name="submit"value="提交"

/form

/body

/html

3、控制器處理OssImageController.php

直接將請求發送到service，不用關注此層

declare(strict_types=1);

namespaceapp\controllers;

useapp\services\OssImageService;

classOssImageControllerextendsBaseController

*oss上傳圖片

*@returnstring

*@throws\OSS\Core\OssException

publicfunctionactionUploadImage()

return$this-response(OssImageService::service()-uploadImage());

}

4、service層處理OssImageService.php

PHP處理在此層，關注此層即可

declare(strict_types=1);

namespaceapp\services;

useapp\extensions\AliOss;

classOssImageServiceextendsBaseService

*oss上傳圖片

*@returnarray

*@throws\OSS\Core\OssException

publicfunctionuploadImage()

$ossClient=AliOss::getOssClient();

$bucketName=AliOss::getBucketName();

//文件名

$fileName=$_FILES['image']['name'];

//臨時文件位置

$tmpFile=$_FILES['image']['tmp_name'];

//定義文件存儲的oss位置

$ossPath='test/'.date('Y-m-d').'/'.date('Hi').mt_rand(10000,99999);

//定義ossobject

$object=$ossPath.'.'.$this-getExtension($fileName);

//執行上傳并獲取返回oss信息

$info=$ossClient-uploadFile($bucketName,$object,$tmpFile);

$ossUrl=$info['oss-request-url'];

//如果圖片的協議是http，則轉換成https

if(substr($ossUrl,0,4)=='http'){

$ossUrl=substr_replace($ossUrl,'https',0,4);

$data=[

'file_url'=$ossUrl,

'file_name'=basename($ossUrl)

return$data;

*返回文件擴展名

*@param$fileName

*@returnmixed

privatefunctiongetExtension($fileName)

returnpathinfo($fileName)['extension'];

}

5、oss實例及參數獲取封裝AliOss.php

declare(strict_types=1);

namespaceapp\extensions;

useOSS\OssClient;

useOSS\Core\OssException;

*阿里云oss文件上傳

classAliOss

constendpoint='';

constaccessKeyId='LSDFskkdDDSSdkfg';

constaccessKeySecret='LT9cG3JkGKffRPalgk4n33lk8Ll41d';

constbucket='hk-server';

*根據Config配置，得到一個OssClient實例

*@returnOssClient一個OssClient實例

publicstaticfunctiongetOssClient()

try{

$ossClient=newOssClient(self::accessKeyId,self::accessKeySecret,self::endpoint,false);

}catch(OssException$e){

printf(__FUNCTION__."creatingOssClientinstance:FAILED\n");

printf($e-getMessage()."\n");

returnnull;

return$ossClient;

publicstaticfunctiongetBucketName()

returnself::bucket;

}

6、結果是可以上傳成功

返回圖片在oss中的完整訪問url的

status:1,

msg:"success",

data:{

file_url:"/test/2025-08-22/211753008.jpg",

file_name:"211753008.jpg"

}

這時，我們訪問/test/2025-08-22/211753008.jpg就可以正常獲取到圖片了，并且在oss管理控制臺也是可以找到上傳的文件的。

這只是將文件上傳到oss上，并將文件的url返給前端，但還沒有將文件的信息存在本地。這里建議前端接收到該url后，連同文件的其他數據（比如分類、文件名