PDFlib是業界領先的PDF開發工具箱，可用于生成和操縱PDF文件。PDFlib最大的亮點是在Web服務器或其他服務器端動態完成PDF創建，并且在現有應用中將文件另存為PDF格式。你可以使用PDFlib將數據庫中的內容動態創建到PDF文件中，類似動態的網頁。

點擊下載PDFlib

如果在程序中出現錯誤，這在許多語言中被稱為異常，這是偶然發生的事情，在程序的生命周期內不會經常發生。一般的策略是對可能經常失敗的函數調用使用常規的錯誤報告機制（即-1等特殊錯誤返回代碼），對于在少數情況下不會因條件而混亂的代碼使用特殊的異常機制。這正是PDFlib的發展道路某些可能會經常出錯的操作，例如：

• 嘗試打開一個沒有權限的輸出文件
• 嘗試使用錯誤的文件名打開輸入的PDF
• 嘗試打開損壞的圖像文件

PDFlib通過返回PDFlib API參考中記錄的特殊值（通常為–1，但在PHP綁定中為0）來發出此類錯誤信號。應用程序開發人員必須檢查此錯誤代碼的所有功能，這些功能在錯誤時記錄為返回-1。其他事件可能被認為是有害的，但很少發生，例如：

• 虛擬內存不足
• 范圍沖突（例如，在打開文檔之前先關閉它）
• 向PDFlib API函數提供錯誤的參數（例如，嘗試繪制半徑為負的圓，或提供錯誤的選項。）

當PDFlib檢測到這種情況時，將引發異常，而不是將特殊的錯誤返回值傳遞給調用方法。重要的是要理解，發生異常時無法完成生成的PDF文檔。可以在異常之后安全地調用的唯一方法是PDF_delete（），PDF_get_apiname（），PDF_get_errnum（）和PDF_get_errmsg（）。發生異常后調用任何其他PDFlib方法可能會導致意外結果。 該異常將包含以下信息：

• 唯一的錯誤號；
• 導致異常的PDFlib API函數的名稱；
• 描述性文本，包含問題的詳細信息

查詢函數調用失敗的原因。如上所述，發生異常時，必須始終放棄生成的PDF輸出文檔。但是，當函數通過返回錯誤值報告非致命問題時，可以繼續文檔。客戶端應用程序可以通過調整程序流程或提供不同的數據來繼續文檔。例如，當無法加載特定字體時，大多數客戶端將放棄該文檔，而其他客戶端則可能更喜歡使用其他字體。在這種情況下，可能需要檢索一條錯誤消息，以更詳細地描述問題。在這種情況下，函數PDF_get_errnum（），PDF_get_errmsg（）和PDF_get_apiname（）可以在失敗的函數調用之后即立即返回錯誤值-1（在PHP中為0）的函數調用之后被調用。

• 錯誤政策。當PDFlib檢測到錯誤情況時，它將根據可以使用errorpolicy選項配置的幾種策略之一進行響應。 所有可以返回錯誤代碼的函數也都支持errorpolicy選項。支持以下錯誤策略：
• errorpolicy = legacy：不建議使用的設置可確保行為與PDFlib的早期版本兼容。 一些函數返回錯誤代碼，而其他函數則根據各自的API描述拋出異常。 舊設置是默認錯誤策略。
• errorpolicy = return：檢測到錯誤情況時，函數將返回-1（在PHP中為0）錯誤值。 應用程序開發人員必須檢查返回值以識別問題，并且必須以適合于應用程序的任何方式對問題做出反應。 這是推薦的方法，因為它允許使用統一的方法來處理錯誤。
• errorpolicy = exception：檢測到錯誤條件時引發異常。 發生異常后，輸出文檔將不完整且無法使用。 可以將其用于惰性編程，而不會產生任何錯誤條件，但以犧牲輸出文檔為代價，即使是可能由應用程序解決的問題

以下代碼片段演示了有關異常處理的不同策略，這些示例嘗試加載可能不可用的字體。如果errorpolicy = return，則必須檢查返回值是否有錯誤。如果它指示失敗，則可以查詢失敗的原因，以便正確處理該情況：

• 警告。PDFlib在內部檢測到一些問題情況，但不能通過拋出異常來證明中斷程序流是合理的。不會引發異常，而是記錄條件的描述。對于警告，我們建議采用以下方法：
• 在開發階段啟用警告日志記錄，并仔細研究日志文件中的所有警告消息。 它們可能指出您的代碼或數據中的潛在問題，因此您應嘗試了解或消除這些警告的原因。
• 在生產階段禁用警告日志記錄，僅在出現問題時才重新啟用它。

關注慧聚IT微信公眾號 ???，了解產品的最新動態及最新資訊。