Нормалізація завантаження
Мета. Прийняти зображення від користувача й зберегти безпечну, узгоджену версію: обмежений вхід, вертикальні пікселі, не більше 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)) }
normalised.webpWEBP · 1600 × 1000 · 30 KB
Програма вивела upload → 1600 × 1000 webp exif: 0 bytes, а для завантаження, що не є зображенням, — HokusaiError.
Як це працює
Section titled “Як це працює”InputOptions(failOn: .truncated, limits: …)обмежує вхід до роботи з пікселями: тут 20 МБ байтів і 50 мегапікселів. Звужуйте їх до своєї політики (ліміти).autoOrient()робить пікселі вертикальними, тож збережений розмір (1000 × 1600) більше не має значення (чому).resize(width: 1600, height: 1600, fit: .inside, withoutEnlargement: true)обмежує довгу сторону 1600 і ніколи не збільшує: безпечний вибір для невідомих розмірів, на відміну від.cover(захисти).webp(quality: 82)і типова політика метаданих відкидають EXIF, XMP та IPTC; зчитування назад показало 0 байтів EXIF (метадані).- Помилки типізовані: хибне завантаження викидає
HokusaiErrorізdata(), а не з конструктора. На сервері відображайте на 400/413/422 (усунення проблем).
Варіації
Section titled “Варіації”- Великі тіла: використовуйте
Hokusai(spooling:), щоб завантаження не тримали в пам’яті (завантаження). - Недовірені формати: увімкніть
RuntimeConfiguration.blockUntrustedOperations, щоб відмовляти завантажувачам PDF, SVG тощо (середовище виконання). - Лише колірний профіль: типова політика вже так робить; використайте
MetadataPolicy(exif: .remove, icc: .preserve), щоб бути явним.