Hata başvurusu

Bu, NextPDF Core’un fırlattığı istisnaların, alana göre düzenlenmiş başvuru listesidir. Her kategori sayfası, sınıf bazında, ne zaman fırlatıldığını, taşıdığı yapılandırılmış veriyi ve nasıl kurtulacağınızı belgeler. Belirli bir sınıfı yakalamak yerine bir belirtiyi tanılıyorsanız, bunun yerine sorun giderme kılavuzlarıyla başlayın — bunlar gözlemlediğiniz şeye göre düzenlenmiştir.

Genel bakış

• İstisnaların çoğu tek bir temel sınıfı, NextPdfException sınıfını genişletir; böylece tüm aileyi tek bir catch bloğuyla yakalayabilirsiniz.
• NextPdfException bağlam farkındadır: getContext(): array bildiren ContextAwareExceptionInterface arayüzünü uygular. Birçok alt sınıf, yapılandırılmış tanılama anahtarları döndürmek için getContext() yöntemini geçersiz kılar; diğerleri boş varsayılanı devralır ve ayrıntılarını ileti ile türlü erişimciler üzerinden sunar.
• Az sayıda düşük seviyeli istisna, NextPdfException yerine doğrudan PHP’nin \RuntimeException sınıfını genişletir. Bunlar bağlam farkında değildir ve ayrıntılarını genel salt okunur özellikler üzerinde taşır. Her kategori sayfası bunları açıkça işaretler.
• …Violation adlı iki uygunluk türü (ComplianceViolation, RuleViolation) istisna değil, değer nesnesidir — fırlatılmadan bir bulguyu tanımlarlar.

Temel tür ve bağlam sözleşmesi

NextPdfException, \RuntimeException sınıfını genişleten ve ContextAwareExceptionInterface arayüzünü uygulayan soyut bir sınıftır. Sözleşme küçüktür:

interface ContextAwareExceptionInterface
{
    /** @return array<string, mixed> structured, log-safe diagnostic context */
    public function getContext(): array;
}

Bu nedenle savunmacı bir işleyici şöyle görünür:

use NextPDF\Exception\NextPdfException;

try {
    // … NextPDF operation …
} catch (NextPdfException $e) {
    $logger->error($e->getMessage(), $e->getContext());
    // getContext() returns [] when a subclass does not override it;
    // the message and any typed getters still carry the detail.
}

Bazı hatalar çıplak bir \RuntimeException olarak yüzeye çıktığından (kategori başına notlara bakın), kemer-ve-pantolon askısı bir sınır, somut türü incelemek için ayrıca \RuntimeException türünü de yakalayabilir.

Kategoriler

• Çekirdek ve genel hatalar — belge, birleştirme, erişilebilirlik, e-fatura, renk uzayı, değer nesnesi ve katı kip hatalarının yanı sıra paylaşılan temel türler.
• Güvenlik, imzalama ve PKI hataları — imza oluşturma ve doğrulama, zaman damgaları, PKI yol ve ad kısıtlaması doğrulaması, karma, bütünlük ve PKCS#11.
• Oluşturma ve G/Ç hataları — HTML yerleşimi ve sayfalı ortam, yazı tipleri ve metin şekillendirme, yazıcı ve okuyucu ve XMP üst verisi.
• Çalışma zamanı ve destek hataları — HTTP taşıması, dayanıklılık (devre kesici, düşürülmüş kip), gözlemlenebilirlik ve manifest işleme.
• Accelerator hataları — isteğe bağlı hızlandırma yardımcısı taşıması.
• Uygunluk hataları — hüküm karması gereksinimleri ve uygunluk yaşam döngüsü.

Ayrıca bakınız

• Sorun giderme — imza doğrulama, şifreleme ve izinler, yazı tipleri ve etiketleme ve PDF/A ve PDF/UA doğrulama için belirtiye göre düzenlenmiş kılavuzlar.