کتابخانه منبع باز PHP برای پردازش فایلهای PDF
خواندن، نوشتن، بارگذاری و تبدیل متن HTML و CSS به فایلهای PDF با استفاده از کتابخانه منبع باز PHP.
PDFMerger Dompdf چیست؟
ایجاد و دستکاری اسناد PDF بهصورت پویا یک نیاز معمول در توسعه وب است. چه کاربران نیاز به ایجاد فاکتور، گزارش یا سایر اسناد قابل چاپ داشته باشند، داشتن یک ابزار قابل اعتماد برای تولید PDF حیاتی است. یکی از ابزارهایی که برجسته میشود Dompdf است، یک چارچوب پیشرفته PHP که تبدیل HTML و CSS به فایلهای PDF را آسان میکند. این کتابخانه به توسعهدهندگان اجازه میدهد محتوای وب خود را به PDFهای بصری جذاب و آماده چاپ تبدیل کنند، که آن را گزینهای عالی برای کاربردهای متنوعی مانند فاکتوردهی، گزارشگیری و تولید اسناد میسازد. ویژگیهای مهمی در این کتابخانه وجود دارد، مانند استفاده از تصاویر و گرافیکهای برداری در PDFها، پشتیبانی از زبانها و مجموعههای کاراکتری مختلف در PDFها، تعریف اندازهها و جهتگیریهای سفارشی صفحه، پشتیبانی قوی از یونیکد و فونتها، پشتیبانی از استانداردهای HTML و CSS و موارد دیگر.
Dompdf یک ماژول متنباز PHP است که به توسعهدهندگان نرمافزار امکان تبدیل اطلاعات HTML به فایلهای PDF را بدون نیاز به وابستگیهای دیگر میدهد. این ماژول بر پایه افزونه DOM PHP و کتابخانه TCPDF ساخته شده است و راهحلی قدرتمند برای ایجاد اسناد PDF از محتوای HTML فراهم میکند. هدف اصلی این کتابخانه ارائه رویکردی ساده اما مؤثر برای تولید PDFهایی است که بهدقت متن اصلی HTML را بازتاب میدهند. مجموعه ویژگیهای جامع آن، همراه با سهولت استفاده و انعطافپذیری، آن را گزینهای مناسب برای انواع برنامهها میسازد. مستندات را بررسی کنید، با کتابخانه بازی کنید و پتانسیل کامل Dompdf را برای پروژههای PHP خود کشف کنید.
.
شروع کار با Dompdf
برای اجرای Dompdf ابتدا باید نسخه PHP 7.1 یا بالاتر و افزونه DOM را نصب کنید. سادهترین روش نصب Dompdf از طریق Composer است. لطفاً برای نصب روان از دستور زیر استفاده کنید.
نصب Dompdf از طریق فرمان Git
composer require dompdf/dompdf
همچنین میتوانید آن را بهصورت دستی نصب کنید؛ فایلهای آخرین نسخه را مستقیماً از مخزن GitHub دانلود کنید.
نصب Dompdf از طریق Composer
git clone https://github.com/dompdf/dompdf.git
cd dompdf/lib
ایجاد فایلهای PDF از HTML با رمزگذاری UTF-8
کتابخانه Dompdf عملکردی برای ایجاد اسناد PDF از HTML با رمزگذاری UTF-8 در داخل برنامه PHP فراهم میکند. HTML با رمزگذاری UTF-8 به عنوان ورودی استاندارد پذیرفته میشود. پس از ایجاد فایل PDF، میتوانید بر اساس نیازهای خود تغییراتی در آن اعمال کنید. این کتابخانه به شما امکان میدهد صفحات جدید اضافه کنید، محتوای جدید وارد کنید، تصاویر را درج کنید، از نشانکها استفاده کنید، سرصفحهها و پاورقیها را به صفحه موجود اضافه کنید و موارد بیشتری.
چگونه تولید پایه PDF با UTF-8 را از طریق API PHP انجام دهیم؟
require 'vendor/autoload.php';
use Dompdf\Dompdf;
$dompdf = new Dompdf();
// HTML with UTF-8 characters (e.g., Arabic, Chinese)
$html = '
مثال PDF UTF-8
انگلیسی: سلام دنیا!
عربی: مرحبا بالعالم
چینی: 你好世界
هندی: नमस्ते दुनिया
';
$dompdf->loadHtml($html);
$dompdf->setPaper('A4', 'portrait');
$dompdf->render();
// Output to browser
$dompdf->stream("utf8_document.pdf", ["Attachment" => false]);
تبدیل HTML به PDF از طریق API PHP
کتابخانه منبع باز Dompdf عملکرد کامل برای بارگذاری و تبدیل محتوای HTML و وب به فایل PDF در داخل برنامههای PHP را فراهم کرده است. این کتابخانه بخش قابل توجهی از CSS2.1 را پشتیبانی میکند، که به کاربران اجازه میدهد با استفاده از قوانین آشنای CSS، PDFهای خود را استایل دهند. API سادهای ارائه میدهد که به شما امکان میدهد محتویات HTML را بارگذاری کنید، گزینههای پیکربندی را تنظیم کنید و با چند خط کد PDFها را رندر کنید. این کتابخانه از تنظیم اندازه صفحه، انتخاب فونتهای دلخواه، اعمال قالببندی و غیره پشتیبانی میکند. مثال زیر نشان میدهد که چگونه توسعهدهندگان نرمافزار میتوانند به راحتی محتوای HTML موجود را بارگذاری کرده و با استفاده از کد PHP به اسناد PDF تبدیل کنند.
چگونه محتوای HTML را بارگذاری کرده و به PDF تبدیل کنیم با PHP؟
use Dompdf\Dompdf;
use Dompdf\Options;
// Include the autoloader
require 'vendor/autoload.php';
// Initialize Dompdf
$options = new Options();
$options->set('isHtml5ParserEnabled', true);
$options->set('isPhpEnabled', true);
$dompdf = new Dompdf($options;
// Load HTML content
$html = 'سلام، Dompdf!
';
$dompdf->loadHtml($html);
// Set paper size
$dompdf->setPaper('A4', 'portrait');
// Render PDF (output to browser or save to file)
$dompdf->render();
$dompdf->stream('output.pdf', array('Attachment' => 0));
پشتیبانی از یونیکد و فونتها
دومپیدیاف یک راهحل چندمنظوره و قابل اعتماد برای توسعهدهندگان PHP است که نیاز به تولید PDF از محتوای HTML و CSS دارند. مدیریت بینالمللیسازی با این کتابخانه به سادگی انجام میشود، بهدلیل پشتیبانی قوی از یونیکد و فونتها. این اطمینان میدهد که PDFهای شما میتوانند زبانها و مجموعههای کاراکتری مختلف را پشتیبانی کنند و بهعنوان یک راهحل چندمنظوره برای برنامههای جهانی عمل کنند.
چگونه فونتهای سفارشی را به PDF اضافه کنیم با PHP؟
require 'vendor/autoload.php';
use Dompdf\Dompdf;
use Dompdf\Options;
$options = new Options();
$options->set('isRemoteEnabled', true);
$options->set('defaultFont', 'Courier');
$dompdf = new Dompdf($options);
$html = '
مثال فونت سفارشی
این متن از فونت Open Sans استفاده میکند.
';
$dompdf->loadHtml($html);
$dompdf->render();
$dompdf->stream("custom_font.pdf");
پشتیبانی از تصاویر و گرافیکهای برداری
گنجاندن تصاویر و گرافیکهای برداری در PDFهای شما با Dompdf بهسادگی انجام میشود. این کتابخانه از فرمتهای مختلف تصویر پشتیبانی میکند، که افزودن تصاویر به اسناد PDF در برنامههای PHP را آسان میسازد. چه نمودارها، لوگوها یا سایر عناصر بصری باشند، توسعهدهندگان نرمافزار میتوانند بهراحتی آنها را در اسناد PDF خود برای ظاهری صیقلی و حرفهای ادغام کنند. میتوانید با تنها چند خط کد PHP، سرصفحهها و پاورقیها را به صفحات PDF خود اضافه کنید تا لمس حرفهای داشته باشید.