کتابخانه رایگان PHP برای ایجاد فایل‌های PDF از HTML
API منبع باز PHP برای ایجاد اسناد PDF از محتوای HTML. این API از رندرینگ HTML و CSS به PDF از طریق کد PHP پشتیبانی می‌کند.
در عصر دیجیتال امروز، توانایی تولید اسناد PDF به‌صورت پویا تبدیل به یک نیاز حیاتی برای بسیاری از برنامه‌های وب شده است. چه تولید فاکتور، گزارش یا محتوای قابل چاپ باشد، داشتن یک کتابخانه قابل اعتماد و کارآمد برای تولید PDF ضروری است. یکی از این کتابخانه‌ها که در میان حرفه‌ای‌های نرم‌افزار و برنامه‌نویسان محبوبیت یافته است، Dompdf می‌باشد. این کتابخانه پشتیبانی داخلی از یونیکد دارد و امکان تولید PDF در زبان‌ها و مجموعه‌های کاراکتری مختلف را فراهم می‌کند. می‌تواند اسکریپت‌های پیچیده‌ای مانند عربی، چینی و سیریلیک را پردازش کند و رندر دقیق محتوای چندزبانه را تضمین می‌نماید.
Dompdf یک ابزار بسیار آسان برای استفاده است و فرآیند تولید اسناد PDF از محتوای HTML را ساده می‌کند. این کتابخانه ویژگی‌های پیشرفته بسیاری را برای سفارشی‌سازی و بهبود فرآیند تولید PDF شما فراهم کرده است. چندین ویژگی مهم در این کتابخانه وجود دارد، از جمله پشتیبانی از اکثر ویژگی‌های CSS 2.1 و برخی ویژگی‌های CSS3، افزودن تصاویر به PDF، پشتیبانی از ویژگی‌های ارائه‌ای HTML 4.0، افزودن سرصفحه و پاورقی به فایل‌های PDF، کنترل شکست صفحه با استفاده از CSS، درج فهرست مطالب، استفاده از نشانک‌ها در PDFها، پشتیبانی از PHP درون‌خطی و موارد دیگر.
Dompdf یک کتابخانه PHP است که به توسعه‌دهندگان نرم‌افزار امکان تولید اسناد PDF از محتوای HTML را می‌دهد. این کتابخانه از قدرت افزونه PHP DOM و سلکتورهای CSS2.1 برای رندر دقیق HTML و CSS به فرمت PDF استفاده می‌کند. این یک پروژه متن‌باز است و به‌صورت فعال در GitHub نگهداری می‌شود، که آن را به گزینه‌ای قابل اعتماد برای تولید PDF در برنامه‌های PHP تبدیل می‌کند. این کتابخانه گزینه‌های پیکربندی متنوعی برای تنظیم دقیق فرآیند تولید PDF ارائه می‌دهد، مانند تنظیمات اندازه صفحه، حاشیه‌ها، محتوای سرصفحه و پاورقی، فشرده‌سازی و موارد دیگر، بر اساس نیازهای خاص کاربران. مجموعه ویژگی‌های قدرتمند آن، شامل پشتیبانی از رندر HTML و CSS، تولید محتوای پویا، پشتیبانی چندزبانه و گزینه‌های سفارشی‌سازی، باعث شده است که در میان توسعه‌دهندگان نرم‌افزار و مهندسان محبوب باشد.
شروع کار با Dompdf
روش پیشنهادی و ساده‌ترین برای نصب Dompdf استفاده از Composer، ابزار مدیریت وابستگی‌ها برای PHP است. لطفاً برای نصب روان، از فرمان زیر استفاده کنید.
نصب Dompdf از طریق Composer
composer require dompdf/dompdf همچنین می‌توانید آن را به‌صورت دستی نصب کنید؛ فایل‌های آخرین نسخه را مستقیماً از مخزن GitHub دانلود کنید.
رندر HTML و CSS از طریق API PHP
کتابخانه منبع باز Dompdf کار را برای توسعه‌دهندگان نرم‌افزار آسان می‌کند تا فایل‌های HTML و CSS را بدون هیچ وابستگی خارجی بارگذاری و رندر کنند. این کتابخانه از طیف گسترده‌ای از ویژگی‌های HTML و CSS پشتیبانی می‌کند و قادر به رندر کردن طرح‌ها و استایل‌های پیچیده است. اکثر سلکتورهای CSS2.1 را پشتیبانی می‌کند، از جمله ویژگی‌های پیشرفته‌ای مانند پرس‌وجوهای رسانه‌ای CSS، inline‑block، رندر جدول و موارد دیگر. همچنین جداول پیچیده را پشتیبانی می‌کند، از جمله ادغام سطر و ستون، مدل‌های حاشیه جداگانه و جمع‌شده، استایل‌گذاری سلول‌های منفرد و غیره. مثال زیر نشان می‌دهد چگونه محتوای HTML را بارگذاری کرده و به فایل PDF تبدیل کنید و آن را در مکان دلخواه خود ذخیره کنید.
چگونه محتوای HTML را بارگذاری کرده و به PDF تبدیل کنیم با کد PHP؟
require_once 'vendor/autoload.php';
use Dompdf\Dompdf;
$dompdf = new Dompdf();
// Load the HTML content you wish to convert to a PDF
$html = 'سلام، dompdf!
';
$dompdf->loadHtml($html);
// Customize the PDF generation settings:
$dompdf->setPaper('A4', 'portrait');
// Render the PDF
$dompdf->render();
// Save the PDF to a file
$dompdf->stream('document.pdf');
// Output the PDF directly to the browser
$dompdf->stream();
افزودن سرصفحه و پاورقی به PDF از طریق PHP
سرصفحه‌ها و پاورقی‌ها بخش بسیار مهمی از اسناد PDF هستند که به توسعه‌دهندگان نرم‌افزار امکان می‌دهند متن، تصویر و سایر فایل‌های PDF را در یک یا چند صفحه از یک سند PDF وارد کنند. معمولاً از سرصفحه و پاورقی برای اعلام مالکیت سند استفاده می‌شود. کتابخانه منبع باز Dompdf این کار را برای توسعه‌دهندگان نرم‌افزار آسان می‌کند تا سرصفحه‌ها و پاورقی‌ها را در برنامه‌های PHP خود تنها با چند خط کد وارد کنند. توسعه‌دهندگان می‌توانند با استفاده از متدهای setHtmlHeader() و setHtmlFooter() سرصفحه و پاورقی را به اسناد PDF خود اضافه کنند. این بخش‌ها می‌توانند محتوای HTML داشته باشند و می‌توانید با استفاده از استایل‌گذاری CSS ظاهر آن‌ها را سفارشی کنید.
سفارشی‌سازی PDF، پشتیبانی از فهرست مطالب و نشانک‌ها
کتابخانه Dompdf چندین ویژگی پیشرفته ارائه می‌دهد که به توسعه‌دهندگان نرم‌افزار امکان می‌دهد فرآیند تولید PDF را سفارشی و بهبود بخشند. این کتابخانه پشتیبانی از افزودن تصویرها و قلم‌ها به PDF را فراهم می‌کند؛ می‌توانید از URLهای مطلق استفاده کنید یا مسیر فایل محلی را ارائه دهید. اطمینان حاصل کنید که تصویرها برای سرور قابل دسترسی هستند. برای قلم‌های سفارشی، dompdf از جاسازی فایل‌های قلم TrueType (.ttf) و OpenType (.otf) پشتیبانی می‌کند. همچنین ایجاد فهرست مطالب یا افزودن نشانک‌ها به اسناد PDF شما بسیار آسان است.
