官方原生集成与 SDK

面向 Laravel 应用的无缝媒体压缩方案

为 Laravel 10 与 11 提供无缝集成。包含 Flysystem 存储驱动、Blade 指令（@smallpict）、模型 Trait 及队列异步优化任务。

安装命令:composer require smallpict/smallpict-laravel

PHP 软件包

代码接入示例

php

// In your Controller
use SmallPict\Laravel\Facades\SmallPict;

public function upload(Request $request)
{
    $image = $request->file('banner');
    
    // Automatically compresses and stores to your S3 or Cloudflare R2
    $optimized = SmallPict::optimize($image)
        ->toFormat('webp')
        ->resize(1400)
        ->store('banners', 's3');

    return response()->json(['url' => $optimized->url()]);
}

// In your Blade View
<picture>
    <source srcset="@smallpict($banner->url, ['format' => 'avif'])" type="image/avif">
    <source srcset="@smallpict($banner->url, ['format' => 'webp'])" type="image/webp">
    <img src="@smallpict($banner->url, ['width' => 800])" alt="Banner" loading="lazy" />
</picture>

集成接入步骤

11. 通过 Composer 安装

在项目目录运行 composer require smallpict/smallpict-laravel。

22. 发布配置文件

运行 php artisan vendor:publish 并配置 .env 中的 SMALLPICT_API_KEY。

33. 使用 Facade 或 Blade

使用 SmallPict::optimize() 或 @smallpict 模板指令。

核心优势与收益

提供媒体批量优化 Artisan 命令（php artisan smallpict:optimize）
与 Spatie Media Library 无缝兼容
支持 Laravel Queue 异步队列（Redis、SQS、数据库）
可配置自动缩略图规格变体

官方开发者技术文档

需要完整的开发指南与 API 规范？

在官方 Laravel 扩展包开发者指南中查阅完整的参数参考、鉴权机制、错误码说明及本地调试教程。

查阅 Laravel 扩展包完整文档

全面加速您的 Laravel 扩展包图像管线

在您的应用中体验低于 50 毫秒的极速 AVIF 与 WebP 转换。零入网费，即刻获取沙箱 API Key，支持弹性扩展。

获取免费开发者 API Key 试用浏览器内转换工具