php-thumbnail/php-thumbnail 未在 Packagist 注册且无 composer.json，Composer 默认无法发现该包，故报“No package found”；需手动克隆至 vendor/ 并配置 PSR-0 自动加载。
PHP-Thumbnail 并不是一个通过 Composer 官方发布的标准库，composer require 直接安装会失败——它没有在 Packagist 上注册，也没有 composer.json 元数据支持自动加载。
为什么 composer require php-thumbnail/php-thumbnail 报错？
执行该命令后你会看到类似错误：
No package found matching your query.
或更具体的提示：
Could not find a version of package php-thumbnail/php-thumbnail matching your minimum-stability
根本原因：这个项目长期托管在 GitHub（如 https://github.com/briceburg/php-thumbnail），但作者未发布到 Packagist，也未声明 autoload 规则。Composer 默认只拉取 Packagist 上的包。
立即学习“PHP免费学习笔记（深入）”；
手动引入并启用自动加载的实操步骤
你需要绕过 Packagist，把源码当作本地依赖处理，关键在于让 Composer 能识别并加载它的类：
- 克隆仓库到项目内：
git clone https://github.com/briceburg/php-thumbnail.git vendor/php-thumbnail（注意路径必须是vendor/php-thumbnail） - 在项目根目录的
composer.json中添加自定义 autoload 配置："autoload": { "psr-0": { "Thumbnail": "vendor/php-thumbnail/src/" } } - 运行
composer dump-autoload刷新自动加载映射 - 确认类能被正确加载：尝试
new Thumbnail\Thumbnail()不报Class not found
生成响应式缩略图时要注意的尺寸逻辑
PHP-Thumbnail 本身不内置“为不同屏幕生成多尺寸图”的功能，它只生成单张图。所谓“响应式缩略图”，实际是你自己控制输出路径、文件名和调用时机：
- 不要用
$thumb->resize(320, 240)硬编码尺寸，改用配置数组驱动：$sizes = ['sm' => [320, 180], 'md' => [768, 432], 'lg' => [1200, 675]]; - 生成时保留原始比例 + 强制裁剪，避免变形：
$thumb->resize($w, $h, 'crop')（第三个参数必须显式传'crop'，默认是'fit'，会导致留白） - 输出路径建议按尺寸分目录，例如：
thumbnails/sm/image.jpg，方便 CDN 或 Nginx 直接命中 - 注意 GD 扩展限制：如果原图超大（如 >5000px），
imagecreatefromjpeg()可能内存溢出，需提前检查getimagesize()和memory_limit
替代方案：为什么更推荐 Intervention Image
如果你只是需要可靠生成多尺寸缩略图，intervention/image 是更稳妥的选择：
- 它在 Packagist 上维护良好，
composer require intervention/image一行即可安装 - 支持 GD 和 Imagick 双后端，对 WebP、AVIF 等新格式兼容更好
- 链式调用清晰：
Image::make($path)->resize(320, null, function ($constraint) { $constraint->aspectRatio(); })->save(...) - 配合 Laravel 或纯 PHP 都容易封装出
generateResponsiveThumbs($src, $sizes)这样的工具函数
PHP-Thumbnail 的代码较老（最后更新在 2015 年），没适配 PHP 8+ 的严格类型提示，某些方法（如 setQuality()）在 JPEG 外格式上行为不一致——这些细节，往往要等第一次生成 WebP 失败才暴露出来。
