Laravel.io 项目中的 Unsplash 图片迁移方案解析

在 Laravel.io 开源项目中，Unsplash 图片服务突然终止了 source.unsplash.com 域名的支持，导致所有图片获取功能失效。本文将深入分析这一技术问题的解决方案。

问题背景

Unsplash 作为流行的免费图片服务平台，原本通过 source.unsplash.com 域名提供图片服务。Laravel.io 项目使用该服务为文章生成封面图片。然而 Unsplash 在未提前通知的情况下停止了该域名的支持，导致项目中的图片功能完全失效。

技术挑战

迁移到 Unsplash API 面临几个关键挑战：

1. API 调用限制问题：直接使用 API 可能会触及调用频率限制
2. 图片 URL 持久性：需要确认生成的图片链接是否长期有效
3. 现有数据迁移：如何平滑迁移已有的图片引用

解决方案分析

经过技术调研，发现 Unsplash API 提供了 get 端点，可以获取图片的热链接 CDN URL。这些 URL 具有以下特点：

• 保持长期不变
• 支持动态调整尺寸参数
• 无需担心调用频率限制

具体实施有两种可选方案：

方案一：保存 CDN URL

通过 API 获取所有图片 ID 对应的热链接 CDN URL，并将其存储在数据库的新列中。这种方案的优点是：

• 实现简单
• 只需一次性迁移
• 后续无需再调用 API

方案二：本地存储图片

从 Unsplash 下载图片并存储在本地文件系统或 S3 中，保存本地图片 URL。这种方案的优点是：

• 完全掌控图片资源
• 不受 Unsplash 政策变化影响
• 可自由进行图片处理

实施细节

项目最终采用了方案一，主要基于以下考虑：

1. 现有图片 ID 仍然有效，可以直接通过 API 获取新格式的 URL
2. 热链接 CDN URL 具有长期稳定性
3. 实现成本较低，适合快速修复问题

实施过程中，开发了专门的命令来遍历所有文章记录，通过 Unsplash API 获取新的图片 URL 并更新数据库。这种批处理方式确保了数据迁移的完整性和效率。

经验总结

这一案例提供了几个有价值的经验：

1. 依赖第三方服务时需要考虑备用方案
2. API 接口通常比非官方域名更稳定
3. 批量数据迁移命令是处理类似问题的有效工具
4. 在技术选型时需要权衡控制权与实现成本

通过这次迁移，Laravel.io 项目不仅解决了当前问题，还为未来的图片管理功能奠定了基础，为后续开发图片选择器等高级功能做好了准备。