AI代码生成工具

app/Service/common/upload/AliyunStorageService.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace App\Service\common\upload;
+
+use App\BaseApp\BaseNotAuthService;
+use App\Service\common\oss\OssStorageInterface;
+use App\Service\common\UtilsService;
+use Illuminate\Support\Facades\Http;
+
+/**
+ * 阿里云 OSS：REST PutObject（Authorization 签名）
+ */
+class AliyunStorageService extends BaseNotAuthService implements OssStorageInterface
+{
+    protected array $config = [];
+
+    public function withConfig(array $config): static
+    {
+        $this->config = $config;
+        return $this;
+    }
+
+    public function uploadImage($filePath, string $key): bool|array
+    {
+        return $this->uploadFile($filePath, $key);
+    }
+
+    public function uploadVideo($filePath, string $key): bool|array
+    {
+        return $this->uploadFile($filePath, $key);
+    }
+
+    /**
+     * 使用 OSS V1 签名上传对象
+     */
+    private function uploadFile($filePath, string $key): bool|array
+    {
+        $accessKey = (string) ($this->config['access_key'] ?? '');
+        $secretKey = (string) ($this->config['secret_key'] ?? '');
+        $bucket = (string) ($this->config['bucket'] ?? '');
+        $endpoint = (string) ($this->config['endpoint'] ?? '');
+        $domain = rtrim((string) ($this->config['domain'] ?? ''), '/');
+        if ($accessKey === '' || $secretKey === '' || $bucket === '' || $endpoint === '') {
+            UtilsService::getInstance()->errorThrow('阿里云 OSS 配置不完整（需要 AccessKey/Secret/Bucket/Endpoint）');
+        }
+        $prefix = trim((string) ($this->config['path_prefix'] ?? ''), '/');
+        if ($prefix !== '' && !str_starts_with($key, $prefix . '/')) {
+            $key = $prefix . '/' . ltrim($key, '/');
+        }
+        $path = is_object($filePath) && method_exists($filePath, 'getRealPath')
+            ? $filePath->getRealPath()
+            : (string) $filePath;
+        $content = file_get_contents($path);
+        $contentType = 'application/octet-stream';
+        $date = gmdate('D, d M Y H:i:s \G\M\T');
+        $resource = '/' . $bucket . '/' . $key;
+        $stringToSign = "PUT\n\n{$contentType}\n{$date}\n{$resource}";
+        $signature = base64_encode(hash_hmac('sha1', $stringToSign, $secretKey, true));
+        $host = preg_replace('#^https?://#', '', rtrim($endpoint, '/'));
+        // 支持传入 oss-cn-xxx.aliyuncs.com 或带 bucket 的域名
+        if (!str_starts_with($host, $bucket . '.')) {
+            $host = $bucket . '.' . $host;
+        }
+        $url = 'https://' . $host . '/' . $key;
+        $response = Http::withHeaders([
+            'Date' => $date,
+            'Content-Type' => $contentType,
+            'Authorization' => 'OSS ' . $accessKey . ':' . $signature,
+        ])->withBody($content, $contentType)->put($url);
+        if (!$response->successful()) {
+            UtilsService::getInstance()->errorThrow('阿里云上传失败：' . $response->body());
+        }
+        $publicUrl = $domain !== '' ? ($domain . '/' . $key) : $url;
+        return ['key' => $key, 'url' => $publicUrl];
+    }
+}

app/Service/common/upload/LocalhostStorageService.php

@@ -2,105 +2,72 @@
 
 namespace App\Service\common\upload;
 
-use App\BaseApp\BaseService;
+use App\BaseApp\BaseNotAuthService;
+use App\Service\common\oss\OssStorageInterface;
 use Illuminate\Support\Facades\Storage;
 
-class LocalhostStorageService extends BaseService
+/**
+ * 本地磁盘上传；支持 domain / path_prefix 覆盖
+ */
+class LocalhostStorageService extends BaseNotAuthService implements OssStorageInterface
 {
-    /**
-     * @var mixed 单例实例，确保该类只有一个全局实例
-     */
-    protected static mixed $_instance;
+    protected array $config = [
+        'domain' => '',
+        'path_prefix' => '',
+    ];
 
-    public function __construct()
+    /**
+     * 注入运行时配置（链式）
+     */
+    public function withConfig(array $config): static
     {
-        parent::__construct();
+        $this->config = array_merge($this->config, $config);
+        return $this;
     }
 
-    /**
-     * 获取实例
-     * @return null|static
-     */
-    public static function getInstance(): null|static
-    {
-        $name = get_called_class();
-        if (!isset(self::$_instance[$name])) {
-            self::$_instance[$name] = new static();
-        }
-
-        return self::$_instance[$name];
-    }
-
-    /**
-     * 上传图片
-     *
-     * @param string $filePath 文件本地路径
-     * @param string $key 上传到本地存储的文件名
-     * @return array|bool
-     */
-    public function uploadImage($filePath, $key): bool|array
+    public function uploadImage($filePath, string $key): bool|array
     {
         return $this->uploadFile($filePath, $key);
     }
 
-    /**
-     * 上传视频
-     *
-     * @param string $filePath 文件本地路径
-     * @param string $key 上传到本地存储的文件名
-     * @return array|bool
-     */
-    public function uploadVideo($filePath, $key): bool|array
+    public function uploadVideo($filePath, string $key): bool|array
     {
         return $this->uploadFile($filePath, $key);
     }
 
-    /**
-     * 删除图片
-     *
-     * @param string $key 本地存储的文件名
-     * @return bool
-     */
     public function deleteImage($key): bool
     {
         return $this->deleteFile($key);
     }
 
-    /**
-     * 删除视频
-     *
-     * @param string $key 本地存储的文件名
-     * @return bool
-     */
     public function deleteVideo($key): bool
     {
         return $this->deleteFile($key);
     }
 
     /**
-     * 上传文件
-     *
-     * @param string $filePath 文件本地路径
-     * @param string $key 上传到本地存储的文件名
-     * @return array|bool
+     * 写入本地 storage；兼容 UploadedFile 与路径字符串
      */
-    private function uploadFile(string $filePath, string $key): bool|array
+    private function uploadFile(mixed $filePath, string $key): bool|array
     {
-        if (Storage::put($key, file_get_contents($filePath))) {
-            return [
-                'key' => $key,
-                'url' => asset('/storage/' . $key)
-            ];
+        $prefix = trim((string) ($this->config['path_prefix'] ?? ''), '/');
+        if ($prefix !== '' && !str_starts_with($key, $prefix . '/')) {
+            $key = $prefix . '/' . ltrim($key, '/');
         }
-        return false;
+        $path = is_object($filePath) && method_exists($filePath, 'getRealPath')
+            ? $filePath->getRealPath()
+            : (string) $filePath;
+        if (!Storage::put($key, file_get_contents($path))) {
+            return false;
+        }
+        $domain = rtrim((string) ($this->config['domain'] ?? ''), '/');
+        $url = $domain !== '' ? ($domain . '/' . $key) : asset('/storage/' . $key);
+        return [
+            'key' => $key,
+            'url' => $url,
+        ];
     }
 
-    /**
-     * 删除文件
-     *
-     * @param string $key 本地存储的文件名
-     * @return bool
-     */
     private function deleteFile(string $key): bool
     {
         return Storage::delete($key);

app/Service/common/upload/QcloudStorageService.php

@@ -0,0 +1,81 @@
+<?php
+
+namespace App\Service\common\upload;
+
+use App\BaseApp\BaseNotAuthService;
+use App\Service\common\oss\OssStorageInterface;
+use App\Service\common\UtilsService;
+use Illuminate\Support\Facades\Http;
+
+/**
+ * 腾讯云 COS：简易 PUT（Authorization 签名 v5）
+ */
+class QcloudStorageService extends BaseNotAuthService implements OssStorageInterface
+{
+    protected array $config = [];
+
+    public function withConfig(array $config): static
+    {
+        $this->config = $config;
+        return $this;
+    }
+
+    public function uploadImage($filePath, string $key): bool|array
+    {
+        return $this->uploadFile($filePath, $key);
+    }
+
+    public function uploadVideo($filePath, string $key): bool|array
+    {
+        return $this->uploadFile($filePath, $key);
+    }
+
+    /**
+     * COS 对象上传（Sign Algorithm=sha1）
+     */
+    private function uploadFile($filePath, string $key): bool|array
+    {
+        $secretId = (string) ($this->config['access_key'] ?? '');
+        $secretKey = (string) ($this->config['secret_key'] ?? '');
+        $bucket = (string) ($this->config['bucket'] ?? '');
+        $region = (string) ($this->config['region'] ?? '');
+        $domain = rtrim((string) ($this->config['domain'] ?? ''), '/');
+        if ($secretId === '' || $secretKey === '' || $bucket === '' || $region === '') {
+            UtilsService::getInstance()->errorThrow('腾讯云 COS 配置不完整（需要 SecretId/SecretKey/Bucket/Region）');
+        }
+        $prefix = trim((string) ($this->config['path_prefix'] ?? ''), '/');
+        if ($prefix !== '' && !str_starts_with($key, $prefix . '/')) {
+            $key = $prefix . '/' . ltrim($key, '/');
+        }
+        $path = is_object($filePath) && method_exists($filePath, 'getRealPath')
+            ? $filePath->getRealPath()
+            : (string) $filePath;
+        $content = file_get_contents($path);
+        $host = $bucket . '.cos.' . $region . '.myqcloud.com';
+        $urlPath = '/' . ltrim($key, '/');
+        $now = time();
+        $keyTime = $now . ';' . ($now + 600);
+        $signKey = hash_hmac('sha1', $keyTime, $secretKey);
+        $httpString = strtolower('put') . "\n" . $urlPath . "\n\nhost=" . strtolower($host) . "\n";
+        $stringToSign = "sha1\n{$keyTime}\n" . sha1($httpString) . "\n";
+        $signature = hash_hmac('sha1', $stringToSign, $signKey);
+        $authorization = 'q-sign-algorithm=sha1'
+            . '&q-ak=' . $secretId
+            . '&q-sign-time=' . $keyTime
+            . '&q-key-time=' . $keyTime
+            . '&q-header-list=host'
+            . '&q-url-param-list='
+            . '&q-signature=' . $signature;
+        $url = 'https://' . $host . $urlPath;
+        $response = Http::withHeaders([
+            'Host' => $host,
+            'Authorization' => $authorization,
+            'Content-Type' => 'application/octet-stream',
+        ])->withBody($content, 'application/octet-stream')->put($url);
+        if (!$response->successful()) {
+            UtilsService::getInstance()->errorThrow('腾讯云上传失败：' . $response->body());
+        }
+        $publicUrl = $domain !== '' ? ($domain . $urlPath) : $url;
+        return ['key' => $key, 'url' => $publicUrl];
+    }
+}

app/Service/common/upload/QiniuStorageService.php

@@ -2,131 +2,95 @@
 
 namespace App\Service\common\upload;
 
-use App\BaseApp\BaseService;
-use Exception;
-use Qiniu\Auth;
-use Qiniu\Storage\BucketManager;
-use Qiniu\Storage\UploadManager;
+use App\BaseApp\BaseNotAuthService;
+use App\Service\common\oss\OssStorageInterface;
+use App\Service\common\UtilsService;
 
-class QiniuStorageService extends BaseService
+/**
+ * 七牛云上传；优先使用官方 SDK，未安装时给出明确提示
+ */
+class QiniuStorageService extends BaseNotAuthService implements OssStorageInterface
 {
-    /**
-     * @var mixed 单例实例，确保该类只有一个全局实例
-     */
-    protected static mixed $_instance;
-    private $accessKey;
-    private $secretKey;
-    private $bucket;
-    private $domain;
+    protected array $config = [
+        'access_key' => '',
+        'secret_key' => '',
+        'bucket' => '',
+        'domain' => '',
+        'path_prefix' => '',
+    ];
 
-    public function __construct()
+    /**
+     * 注入解密后的运行时配置
+     */
+    public function withConfig(array $config): static
     {
-        parent::__construct();
-        $this->accessKey = config('nl.oss.qiniu.access_key');
-        $this->secretKey = config('nl.oss.qiniu.secret_key');
-        $this->bucket = config('nl.oss.qiniu.bucket');
-        $this->domain = config('nl.oss.qiniu.domain');
+        $this->config = array_merge($this->config, $config);
+        return $this;
     }
 
-
-    /**
-     * 获取实例
-     * @return null|static
-     */
-    public static function getInstance(): null|static
-    {
-        $name = get_called_class();
-        if (!isset(self::$_instance[$name])) {
-            self::$_instance[$name] = new static();
-        }
-
-        return self::$_instance[$name];
-    }
-
-    /**
-     * 上传图片
-     *
-     * @param string $filePath 文件本地路径
-     * @param string $key 上传到七牛云的文件名
-     * @return array|bool
-     * @throws Exception
-     */
-    public function uploadImage($filePath, $key): bool|array
+    public function uploadImage($filePath, string $key): bool|array
     {
         return $this->uploadFile($filePath, $key);
     }
 
-    /**
-     * 上传视频
-     *
-     * @param string $filePath 文件本地路径
-     * @param string $key 上传到七牛云的文件名
-     * @return array|bool
-     */
-    public function uploadVideo($filePath, $key): bool|array
+    public function uploadVideo($filePath, string $key): bool|array
     {
         return $this->uploadFile($filePath, $key);
     }
 
-    /**
-     * 删除图片
-     *
-     * @param string $key 七牛云存储的文件名
-     * @return bool
-     */
     public function deleteImage($key): bool
     {
         return $this->deleteFile($key);
     }
 
-    /**
-     * 删除视频
-     *
-     * @param string $key 七牛云存储的文件名
-     * @return bool
-     */
     public function deleteVideo($key): bool
     {
         return $this->deleteFile($key);
     }
 
     /**
-     * 上传文件
-     *
-     * @param string $filePath 文件本地路径
-     * @param string $key 上传到七牛云的文件名
-     * @return array|bool
-     * @throws Exception
+     * 上传到七牛；无 SDK 时抛业务异常引导安装或改本地
      */
-    private function uploadFile(string $filePath, string $key): bool|array
+    private function uploadFile($filePath, string $key): bool|array
     {
-        $auth = new Auth($this->accessKey, $this->secretKey);
-        $token = $auth->uploadToken($this->bucket);
-        $uploadMgr = new UploadManager();
-
-        list($ret, $err) = $uploadMgr->putFile($token, $key, $filePath);
+        if (!class_exists(\Qiniu\Auth::class)) {
+            UtilsService::getInstance()->errorThrow('未安装 qiniu/php-sdk，请改用本地存储或安装依赖');
+        }
+        $accessKey = (string) ($this->config['access_key'] ?? '');
+        $secretKey = (string) ($this->config['secret_key'] ?? '');
+        $bucket = (string) ($this->config['bucket'] ?? '');
+        $domain = rtrim((string) ($this->config['domain'] ?? ''), '/');
+        if ($accessKey === '' || $secretKey === '' || $bucket === '') {
+            UtilsService::getInstance()->errorThrow('七牛云配置不完整');
+        }
+        $prefix = trim((string) ($this->config['path_prefix'] ?? ''), '/');
+        if ($prefix !== '' && !str_starts_with($key, $prefix . '/')) {
+            $key = $prefix . '/' . ltrim($key, '/');
+        }
+        $path = is_object($filePath) && method_exists($filePath, 'getRealPath')
+            ? $filePath->getRealPath()
+            : (string) $filePath;
+        $auth = new \Qiniu\Auth($accessKey, $secretKey);
+        $token = $auth->uploadToken($bucket);
+        $uploadMgr = new \Qiniu\Storage\UploadManager();
+        list($ret, $err) = $uploadMgr->putFile($token, $key, $path);
         if ($err !== null) {
             return false;
-        } else {
-            return [
-                'key' => $ret['key'],
-                'url' => $this->domain . '/' . $ret['key']
-            ];
         }
+        return [
+            'key' => $ret['key'],
+            'url' => $domain . '/' . $ret['key'],
+        ];
     }
 
-    /**
-     * 删除文件
-     *
-     * @param string $key 七牛云存储的文件名
-     * @return bool
-     */
     private function deleteFile(string $key): bool
     {
-        $auth = new Auth($this->accessKey, $this->secretKey);
-        $bucketMgr = new BucketManager($auth);
-
-        $err = $bucketMgr->delete($this->bucket, $key);
+        if (!class_exists(\Qiniu\Auth::class)) {
+            return false;
+        }
+        $auth = new \Qiniu\Auth($this->config['access_key'], $this->config['secret_key']);
+        $bucketMgr = new \Qiniu\Storage\BucketManager($auth);
+        $err = $bucketMgr->delete($this->config['bucket'], $key);
         return $err === null;
     }
 }

app/Service/common/upload/S3CompatibleStorageService.php

@@ -0,0 +1,90 @@
+<?php
+
+namespace App\Service\common\upload;
+
+use App\BaseApp\BaseNotAuthService;
+use App\Service\common\oss\OssStorageInterface;
+use App\Service\common\UtilsService;
+use Illuminate\Support\Facades\Http;
+
+/**
+ * S3 兼容上传（AWS / MinIO / 华为 OBS / 百度 BOS）
+ * 使用 AWS Signature Version 4 的 PUT Object
+ */
+class S3CompatibleStorageService extends BaseNotAuthService implements OssStorageInterface
+{
+    protected array $config = [];
+
+    public function withConfig(array $config): static
+    {
+        $this->config = $config;
+        return $this;
+    }
+
+    public function uploadImage($filePath, string $key): bool|array
+    {
+        return $this->uploadFile($filePath, $key);
+    }
+
+    public function uploadVideo($filePath, string $key): bool|array
+    {
+        return $this->uploadFile($filePath, $key);
+    }
+
+    /**
+     * SigV4 PUT；endpoint 必填（如 https://s3.amazonaws.com 或 MinIO 地址）
+     */
+    private function uploadFile($filePath, string $key): bool|array
+    {
+        $accessKey = (string) ($this->config['access_key'] ?? '');
+        $secretKey = (string) ($this->config['secret_key'] ?? '');
+        $bucket = (string) ($this->config['bucket'] ?? '');
+        $region = (string) ($this->config['region'] ?? 'us-east-1');
+        $endpoint = rtrim((string) ($this->config['endpoint'] ?? ''), '/');
+        $domain = rtrim((string) ($this->config['domain'] ?? ''), '/');
+        $driver = (string) ($this->config['driver'] ?? 'aws');
+        if ($accessKey === '' || $secretKey === '' || $bucket === '' || $endpoint === '') {
+            UtilsService::getInstance()->errorThrow(strtoupper($driver) . ' 配置不完整（需要 AccessKey/Secret/Bucket/Endpoint）');
+        }
+        $prefix = trim((string) ($this->config['path_prefix'] ?? ''), '/');
+        if ($prefix !== '' && !str_starts_with($key, $prefix . '/')) {
+            $key = $prefix . '/' . ltrim($key, '/');
+        }
+        $path = is_object($filePath) && method_exists($filePath, 'getRealPath')
+            ? $filePath->getRealPath()
+            : (string) $filePath;
+        $payload = file_get_contents($path);
+        $host = parse_url($endpoint, PHP_URL_HOST) ?: preg_replace('#^https?://#', '', $endpoint);
+        // path-style: endpoint/bucket/key
+        $canonicalUri = '/' . rawurlencode($bucket) . '/' . str_replace('%2F', '/', rawurlencode($key));
+        // 简化：多数 MinIO/OBS 接受 path-style
+        $url = $endpoint . '/' . $bucket . '/' . $key;
+        $amzDate = gmdate('Ymd\THis\Z');
+        $dateStamp = gmdate('Ymd');
+        $payloadHash = hash('sha256', $payload);
+        $canonicalHeaders = "host:{$host}\nx-amz-content-sha256:{$payloadHash}\nx-amz-date:{$amzDate}\n";
+        $signedHeaders = 'host;x-amz-content-sha256;x-amz-date';
+        $canonicalRequest = "PUT\n{$canonicalUri}\n\n{$canonicalHeaders}\n{$signedHeaders}\n{$payloadHash}";
+        $service = $driver === 'huawei' ? 's3' : 's3';
+        $credentialScope = "{$dateStamp}/{$region}/{$service}/aws4_request";
+        $stringToSign = "AWS4-HMAC-SHA256\n{$amzDate}\n{$credentialScope}\n" . hash('sha256', $canonicalRequest);
+        $kDate = hash_hmac('sha256', $dateStamp, 'AWS4' . $secretKey, true);
+        $kRegion = hash_hmac('sha256', $region, $kDate, true);
+        $kService = hash_hmac('sha256', $service, $kRegion, true);
+        $kSigning = hash_hmac('sha256', 'aws4_request', $kService, true);
+        $signature = hash_hmac('sha256', $stringToSign, $kSigning);
+        $authorization = "AWS4-HMAC-SHA256 Credential={$accessKey}/{$credentialScope}, SignedHeaders={$signedHeaders}, Signature={$signature}";
+        $response = Http::withHeaders([
+            'Authorization' => $authorization,
+            'x-amz-content-sha256' => $payloadHash,
+            'x-amz-date' => $amzDate,
+            'Content-Type' => 'application/octet-stream',
+            'Host' => $host,
+        ])->withBody($payload, 'application/octet-stream')->put($url);
+        if (!$response->successful()) {
+            UtilsService::getInstance()->errorThrow($driver . ' 上传失败：' . $response->body());
+        }
+        $publicUrl = $domain !== '' ? ($domain . '/' . $key) : $url;
+        return ['key' => $key, 'url' => $publicUrl];
+    }
+}