PHP主|使用DOMPDF將HTML轉換為PDF-php教程-PHP中文網

鑰匙要點

入門

高級用法

結論

如何使用Composer（用於PHP的依賴關係管理工具）安裝DOMPDF？您可以安裝作曲家，然後運行命令“ Composer需要DOMPDF/DOMPDF”。這將在您的項目中下載並安裝DOMPDF庫。

使用，是的，DOMPDF支持CSS。您可以在HTML中使用內聯CSS，也可以鏈接到外部CSS文件。生成PDF時，DOMPDF將應用樣式。但是，請注意，並非所有CSS屬性都得到支持。

>我可以生成具有多個頁面的PDF嗎？如果您的HTML內容足夠長以跨越多頁，則DOMPDF將自動將其分為頁面。您還可以使用CSS手動添加頁面斷路。

>如何將生成的PDF保存到文件中？使用“輸出”方法和“ file_put_contents”功能生成的PDF到文件。例如，您可以使用'file_put_contents（'mypdf.pdf'，$ dompdf-> output（））'將pdf保存到名為'mypdf.pdf'的文件。

> dompdf Secure嗎？

首頁

後端開發

php教程

PHP主|使用DOMPDF將HTML轉換為PDF

Lisa Kudrow

Feb 23, 2025 am 10:36 AM

PHP主|使用DOMPDF將HTML轉換為PDF

PDF是一種標準格式，最初是由Adobe創建的，用於在固定的layout文檔中表示文本和圖像。 Web應用程序以PDF格式支持下載數據（例如發票或報告）並不少見，因此在本文中，我們將如何輕鬆地使用PHP輕鬆生成PDF文檔。 DOMPDF是一個很棒的庫，能夠從HTML標記和CSS樣式中生成PDF（主要是CSS 2.1符合CSS 2.1，並支持某些CSS3屬性）。我們可以使用這些熟悉的技術來決定我們的內容應如何外觀，然後輕鬆將其轉換為固定的文檔。該圖書館還有許多其他有用且有趣的功能。

鑰匙要點

> DOMPDF是一個可以將HTML標記和CSS樣式轉換為PDF文檔的PHP庫，使其對需要以PDF格式支持下載數據的Web應用程序有用。
要使用DOMPDF，需要通過GitHub或Composer安裝它，並且需要PHP> = 5.0，並啟用MBSTRING和DOM擴展。 HTML標記可以作為字符串或從文件或URL加載，然後渲染到PDF中。 >
> DOMPDF是一種功能強大的工具，但它具有一些局限性，例如不耐受成型的HTML，並且僅對CSS3的支持有限。建議審查圖書館的文檔和源代碼，以充分了解其功能和潛在問題。

入門

DOMPDF可在GitHub上獲得，可以使用Composer安裝。誠然，基於作曲家的安裝並正確運行仍然有些棘手，因此我建議您只使用Git安裝DOMPDF。該庫需要PHP> = 5.0，並啟用了MBSTRING和DOM擴展。它還需要一些字體，這些字體通常在大多數機器上可用。導航到要放置庫並執行的任何地方：

git clone https://github.com/dompdf/dompdf.git
git submodule init
git submodule update

登入後複製

通過下載DOMPDF，讓我們寫一個簡短的示例，該示例將生成一個簡單的PDF。

<span><span><?php
</span></span><span><span>set_include_path(get_include_path() . PATH_SEPARATOR . "/path/to/dompdf");
</span></span><span>
</span><span><span>require_once "dompdf_config.inc.php";
</span></span><span>
</span><span><span>$dompdf = new DOMPDF();
</span></span><span>
</span><span><span>$html = <span><span><<<'ENDHTML'</span>
</span></span></span><span><span><html>
</span></span><span><span> <body>
</span></span><span><span>  <h1>Hello Dompdf</h1>
</span></span><span><span> </body>
</span></span><span><span></html>
</span></span><span><span><span>ENDHTML<span>;</span></span>
</span></span><span>
</span><span><span>$dompdf->load_html($html);
</span></span><span><span>$dompdf->render();
</span></span><span>
</span><span><span>$dompdf->stream("hello.pdf");</span></span>

登入後複製

要在項目中使用庫，我們首先在包含大部分DOMPDF配置的Dompdf_config.inc.php中拉動。它還加載一個自動加載器和自定義配置文件，在其中我們可以覆蓋默認配置參數。 HTML標記作為字符串作為load_html（）方法的字符串。另外，我們可以使用load_html_file（）方法從文件或URL加載標記。它接受文件網頁的文件名或URL作為參數。 Render（）方法將HTML渲染到PDF中，我們準備轉儲PDF文件。 Stream（）將結果PDF作為瀏覽器的附件發送。 Stream（）方法具有可選的第二個參數，一個選項數組：

>接受範圍 - 布爾值，發送“ Accept-Ranges”標頭（默認為FALSE）。
附件 - 布爾值，發送“ content-disposition：actactment”標頭強迫瀏覽器顯示保存提示符（默認情況下為true）。
>

高級用法

現在，讓我們談談DOMPDF的一些高級用途。也許我們希望將生成的PDF文檔保存到磁盤上，而不是將其發送到瀏覽器。以下是：

git clone https://github.com/dompdf/dompdf.git
git submodule init
git submodule update

登入後複製

我們不像上一個示例中調用stream（），而是使用output（）將pdf返回為字符串。它也接受了可選的選項數組，但是唯一可用的選項是壓縮（默認值為true）。 DOMPDF還允許我們通過將PHP腳本嵌入其呈現的HTML中，將標題或頁腳添加到生成的PDF中。但是，由於處理任意代碼如果您不小心，則可能會構成安全風險，因此默認情況下，控制此功能的配置值將關閉。我們需要首先設置dompdf_enable_php選項true。啟用了Inline PHP執行後，將在腳本中提供PDF對象，我們可以使用該對象來操縱頁面。我們可以在頁面內的任何地方添加文本，行，圖像，矩形等。

<span><span><?php
</span></span><span><span>set_include_path(get_include_path() . PATH_SEPARATOR . "/path/to/dompdf");
</span></span><span>
</span><span><span>require_once "dompdf_config.inc.php";
</span></span><span>
</span><span><span>$dompdf = new DOMPDF();
</span></span><span>
</span><span><span>$html = <span><span><<<'ENDHTML'</span>
</span></span></span><span><span><html>
</span></span><span><span> <body>
</span></span><span><span>  <h1>Hello Dompdf</h1>
</span></span><span><span> </body>
</span></span><span><span></html>
</span></span><span><span><span>ENDHTML<span>;</span></span>
</span></span><span>
</span><span><span>$dompdf->load_html($html);
</span></span><span><span>$dompdf->render();
</span></span><span>
</span><span><span>$dompdf->stream("hello.pdf");</span></span>

登入後複製

該腳本直接嵌入到HTML標記中，並首先打開一個對象，以便我們可以影響渲染。所有圖形將記錄到該對像中，我們可以將此對象添加到所有或選定的頁面（儘管有限制）。接下來，我們獲取頁面的實際寬度和高度，以計算要添加的頁腳的坐標。另外，在添加文本內容時，我們需要提供字體對象。 font_metrics :: get_font（）允許我們創建所需的對象。我們還使用get_font_height（）將給定字體的高度以其字體尺寸為單位，以計算頁腳內容的定位。方法get_font_width（）返回給定字體和字體大小的文本寬度，該字體大小也用於我們的計算中。線（）方法從點（x1，y1）到（x2，x2）繪製一條線。請注意，我們提供的顏色值不是實際的RGB值。基礎PDF類需要0到1之間的值，因此我們將RGB值轉換為這些新值。為了獲得更好的近似，您可以將其除以255。我們使用page_text（）方法添加每個頁面的頁碼，該方法接受x和y位置，要添加的文本，字體對象，字體大小和顏色。 DOMPDF自動替換{page_num}的值和{page_count}在每個頁面中，並使我們可以使用$ PDF。當PDF渲染時，頁腳部分將看起來像這樣：

PHP主|使用DOMPDF將HTML轉換為PDF

有可能避免使用內聯PHP並直接從PHP中實現相同的效果，例如：

git clone https://github.com/dompdf/dompdf.git
git submodule init
git submodule update

登入後複製

請注意，我們在調用$ DOMPDF-> RENDER（）之後放置代碼，因為我們基本上正在修改渲染的PDF。

結論

在本文中，我們討論瞭如何使用DOMPDF輕鬆將HTML轉換為PDF。儘管DOMPDF是一個很棒的庫，但它不是生成PDF文檔的防彈解決方案。它確實有一些局限性和問題。 DOMPDF並不是真正耐受型HTML的耐受性，並且大桌子很容易使您無法記憶。一些基本的CSS功能（例如Float）並不完全支持，並且對CSS3的支持只有有限的支持。如果您需要DOMPDF不支持的功能，那麼WKHTMLTOPDF之類的功能可能是您更好的解決方案。儘管如此，DOMPDF非常簡單，適合大多數PDF出口需求。很難解釋庫中圖書館提供的所有功能，因此請務必查看文檔和源代碼，以了解添加回調，使用自定義字體等的酷功能。很高興為您提供我有限的專業知識。隨時留下您的問題，並在評論部分分享您的經驗。通過fotolia 圖像 >如果您喜歡閱讀這篇文章，您會喜歡學習的；從大師那裡學習新鮮技能和技術的地方。成員可以立即訪問SitePoint的所有電子書和交互式在線課程，例如Jump Start Php。 >對本文的評論已關閉。對PHP有疑問嗎？為什麼不在我們的論壇上詢問？ >常見問題（常見問題解答）關於使用DOMPDF 將HTML轉換為PDF