详解PHP使用OSS上传文件

第详解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后，连同文件的其他数据（比如分类、文件名