Перейти до вмісту
Hokusai2.2.2
ivantokar.com

Нормалізація завантаження

Мета. Прийняти зображення від користувача й зберегти безпечну, узгоджену версію: обмежений вхід, вертикальні пікселі, не більше 1600 px, без приватних метаданих. Вхідні дані: phone.jpg (боком, з EXIF). Потрібно: Hokusai 2.2.2.

// Normalise an untrusted upload: bounded input, upright pixels, sane size, no private metadata.
func normalise(_ upload: Data) async throws -> Output {
try await Hokusai(
data: upload,
options: .init(failOn: .truncated, limits: .init(maxBytes: 20_000_000, maxPixels: 50_000_000))
)
.autoOrient()
.resize(width: 1600, height: 1600, fit: .inside, withoutEnlargement: true)
.webp(quality: 82)
.data() // default metadata policy: EXIF, XMP, IPTC removed
}
let phone = try Data(contentsOf: URL(fileURLWithPath: "phone.jpg"))
let output = try await normalise(phone)
let meta = try await Hokusai(data: output.data).metadata()
print("upload →", output.info.width, "×", output.info.height, output.info.format.rawValue,
"exif:", meta.exif?.count ?? 0, "bytes")
try output.data.write(to: URL(fileURLWithPath: "normalised.webp"))
do { _ = try await normalise(Data("not an image".utf8)) } catch { print("bad upload →", type(of: error)) }
  • Сцена вертикально, 1600 на 1000 пікселів, у форматі WebP.
    normalised.webpWEBP · 1600 × 1000 · 30 KB

Програма вивела upload → 1600 × 1000 webp exif: 0 bytes, а для завантаження, що не є зображенням, — HokusaiError.

  1. InputOptions(failOn: .truncated, limits: …) обмежує вхід до роботи з пікселями: тут 20 МБ байтів і 50 мегапікселів. Звужуйте їх до своєї політики (ліміти).
  2. autoOrient() робить пікселі вертикальними, тож збережений розмір (1000 × 1600) більше не має значення (чому).
  3. resize(width: 1600, height: 1600, fit: .inside, withoutEnlargement: true) обмежує довгу сторону 1600 і ніколи не збільшує: безпечний вибір для невідомих розмірів, на відміну від .cover (захисти).
  4. webp(quality: 82) і типова політика метаданих відкидають EXIF, XMP та IPTC; зчитування назад показало 0 байтів EXIF (метадані).
  5. Помилки типізовані: хибне завантаження викидає HokusaiError із data(), а не з конструктора. На сервері відображайте на 400/413/422 (усунення проблем).
  • Великі тіла: використовуйте Hokusai(spooling:), щоб завантаження не тримали в пам’яті (завантаження).
  • Недовірені формати: увімкніть RuntimeConfiguration.blockUntrustedOperations, щоб відмовляти завантажувачам PDF, SVG тощо (середовище виконання).
  • Лише колірний профіль: типова політика вже так робить; використайте MetadataPolicy(exif: .remove, icc: .preserve), щоб бути явним.