准备：

php版本：7.4

tp版本：6.0

阿里云accessKeyId；

阿里云accessKeySecret；

阿里云存储bucket名称，如 examplebucket；

地域节点endpoint，如：oss-cn-hangzhou.aliyuncs.com；

1. 安装SDK

参考官网https://help.aliyun.com/zh/oss/developer-reference/installation-13?spm=a2c4g.11186623.0.0.568f6583XllxTu

这里我们使用composer安装

composer require aliyuncs/oss-sdk-php

下载后composer.json文件里面显示

"aliyuncs/oss-sdk-php": "^2.7"

2. 上传文件到OSS

参考官网：https://help.aliyun.com/zh/oss/developer-reference/simple-upload?spm=a2c4g.11186623.0.0.75b95347Cv3irf

SDK提供了好几种上传文件的方法

直接上传文件对象

/**
     * Uploads a local file
     *
     * @param string $bucket bucket name
     * @param string $object object name
     * @param string $file local file path
     * @param array $options
     * @return array|null
     * @throws OssException|RequestCore_Exception
     */
    public function uploadFile($bucket, $object, $file, $options = NULL)

上传文件内容

/**
     * Uploads object from file handle
     *
     * @param string $bucket bucket name
     * @param string $object object name
     * @param resource $handle file handle
     * @param array $options
     * @return array|null
     * @throws OssException|RequestCore_Exception
     */
    public function uploadStream($bucket, $object, $handle, $options = NULL)

结合我们的业务需要，因为客户端直接上传的是文件对象，所有我们采用uploadFile方法。

uploadFile参数说明：

第一个参数bucket：存储空间bucket的名称

第二个参数object：存储文件的名称（原以为是文件对象，实际上是存储文件的名称，可以包含路径，比如 '2024/01/01/xxx.png'）

第三个参数file：文件的本地路径，根据这个路径获取文件，并上传保存到第二个参数对应的文件

封装的上传文件类

<?php

namespace app\service;

use app\model\SysConfig;
use OSS\Core\OssException;
use OSS\OssClient;
use think\facade\Log;

class OssService
{
    private $accessKeyId = '';
    private $accessKeySecret = '';
    private $bucket = '';
    private $endpoint = '';


    /**
     * 构造方法
     * @access public
     * @param  App  $app  应用对象
     */
    public function __construct()
    {
        $this->accessKeyId = SysConfig::get('accessKeyId');
        $this->accessKeySecret = SysConfig::get('accessKeySecret');
        $this->bucket = SysConfig::get('bucket');
        $this->endpoint = SysConfig::get('endpoint');
    }

    /**
     * 上传文件
     * @param $file_path 文件路径
     * @param $file_name 文件名称
     * @return mixed|string
     * @throws \OSS\Http\RequestCore_Exception
     */
    public function save($file_path,$file_name)
    {
        try {
            //实例化
            $ossClient = new OssClient($this->accessKeyId, $this->accessKeySecret, $this->endpoint);
            //生成文件名 连接后缀
            $save_name = date('Y').'/'.date('m').'/'.date('d') .'/'. $file_name;
            //Log::info($save_name);
            //执行阿里云上传
            $result = $ossClient->uploadFile($this->bucket, $save_name, $file_path);
            //Log::info($result);
            
            if (!empty($result['info']['url']))
            {
                return $result['info']['url'];
            }
        } catch (OssException $e) {
            //Log::info($e->getMessage());

        }

        return '';
    }
}

上传文件接口

public function addImg($cid)
    {
        $file = $this->request->file('file');
        $files = $_FILES['file'];
        $oss = new OssService();
        $file_name = md5($file->getOriginalName()) . '.' . $file->getOriginalExtension();
        $tmp_name = $files['tmp_name'];//上传文件的缓存路径
        $url = $oss->save($tmp_name,$file_name);
        
        if (!empty($url))
        {
             $this->success('成功',['url' => $url]);
        }
        else
        {
            $this->error('失败');
        }
    }

已上就是本次tp使用阿里云SDK上传OSS的操作。

后记

原想只是一个简单上传，想要直接使用阿里云提供的API，但是API里面一些签名什么的还要花时间做，最终还是选择了使用SDK更快捷方便。