گەشەپێدانی وێب

ڕێبەری گشتگیر بۆ دروستکردنی فایلی PDF لە PHP: کام کتێبخانە هەڵبژێرم؟

نوسین و ئامادەکردنی

262 بینین
لەیرە ڕیکلام بکە

پێشەکی

یەکێک لەو پێداویستییە باوانەی کە لە زۆربەی پڕۆژەکانی وێب لەگەڵ PHP ڕووبەڕووی دەبینەوە، دروستکردنی فایلی PDF-ە. لە فاکتەری پارەدان (Invoices)ەوە تا ڕاپۆرتی ئاماری و بڕوانامەکان، پێویستیمان بە ئامرازێکە کە بە ئاسانی HTML و CSS بگۆڕێت بۆ فایلی PDF. لەم وتارەدا، باشترین کتێبخانەکانی PHP بۆ ئەم مەبەستە بەراورد دەکەین.

١. Dompdf

کتێبخانەی Dompdf یەکێکە لە بەناوبانگترین و کۆنترین کتێبخانەکان. ئەم کتێبخانەیە ڕاستەوخۆ CSS-ی ستاندارد دەخوێنێتەوە، بۆیە ئەگەر دیزاینەکەت بە HTML و CSS ئامادە کردووە، Dompdf باشترین بژاردەیە.

نموونەی کۆد:

require 'vendor/autoload.php';
use Dompdf\Dompdf;

$dompdf = new Dompdf();
$dompdf->loadHtml('<h1>سڵاو لە فێرکار</h1>');
$dompdf->setPaper('A4', 'portrait');
$dompdf->render();
$dompdf->stream();

٢. TCPDF

ئەگەر پڕۆژەکەت پێویستی بە کۆنتڕۆڵێکی زۆر ورد هەیە لەسەر هەر سانتیمەترێکی پەڕەکە، TCPDF بژاردەیەکی بەهێزە. ئەم کتێبخانەیە زۆر خێرایە و پشتگیری تەواوی لە فۆنتە جیاوازەکان و تەنانەت زمانی عەرەبی و کوردی (RTL) دەکات.

٣. Snappy (Wrapper بۆ wkhtmltopdf)

Snappy لە ڕاستیدا کتێبخانەیەکی ڕاستەوخۆ نییە، بەڵکو وێب-سێرڤەرێکە کە بەکاردێت بۆ کارکردن لەگەڵ wkhtmltopdf. ئەمە بەهێزترین ئامرازە بۆ ئەو دیزاینانەی کە JavaScript-ی زۆریان تێدایە، چونکە پشتی بە مۆتۆری WebKit بەستووە.

چۆنیەتی دامەزراندن لە ڕێگەی Composer:

composer require knplabs/knp-snappy

٤. Browsershot (نوێترین و بەهێزترین بۆ لاراڤێل)

ئەم پاكێجە کە لەلایەن Spatie پەرەی پێدراوە، شۆڕشێکی نوێیە بۆ دروستکردنی PDF لە لاراڤێل و PHPدا. لێرەدا هیچ مۆتۆرێکی کۆن بەکار نایەت، بەڵکو پاكێجەکە لە پشتەوە برۆوسەری Chromium (وەک گووگڵ کرۆم) بە شێوازی Headless و لە ڕێگەی Puppeteerـەوە بەکاردەهێنێت. وێنەی ڕوونمای ماڵپەڕەکە دەگرێت و دەیکاتە PDF، ئەمەش واتا هەر دیزاینێکی قورسی CSS3، Flexbox، Grid یان Tailwind بتەوێت، ڕێک وەک برۆوسەرەکە و بێ کێشە لە PDFەکەدا دەردەکەوێت.

نموونەی کۆد:

use Spatie\Browsershot\Browsershot;

Browsershot::url('https://ferkar.org')
    ->savePdf('ferkar-homepage.pdf');

بەراوردکاری و خشتەی بڕیاردان

  • Dompdf: بۆ پڕۆژە بچووک و مامناوەندەکان کە دیزاینی سادەیان هەیە.

  • TCPDF: بۆ ئەو کاتانەی کە کارایی (Performance) زۆر گرنگە و دیزاینەکان زۆر ئاڵۆزن.

  • Snappy: کاتێک دەتەوێت دیزاینەکەت بە وردی وەک ئەوەی لە Browser دەردەکەوێت، لە PDF-یشدا دەربکەوێت.

  • Browsershot: باشترین و مۆدێرنترین بژاردە بۆ دیزاینە ئاڵۆزەکانی ئەمرۆ (Tailwind, Flexbox) و کاتێک پڕۆژەکەت لەسەر لاراڤێلە.

ئامۆژگاری بۆ ئەنجامی باشتر

کاتێک فایلی PDF دروست دەکەیت، هەمیشە هەوڵ بدە CSS-ی تایبەت بۆ PDF دابنێیت. بەکارهێنانی @media print لە CSS-دا یارمەتیت دەدات کە دیزاینەکان بۆ چاپکردن یان گۆڕین بۆ PDF ئامادە بکەیت. هەروەها، هەمیشە فۆنتەکانت بە شێوەی UTF-8 دیاری بکە بۆ ئەوەی پیتە کوردییەکان بە دروستی دەربکەون.

کۆتایی

بۆ پڕۆژە مۆدێرنەکانی Laravel، پێشنیار دەکەین بەکاریبهێنن barryvdh/laravel-dompdf بۆ کارە سادەکان، بەڵام ئەگەر کێشەی فۆنتی کوردی و تێکچوونی دیزاینت هەیە و دەتەوێت کارەکەت پڕۆفیشناڵ بێت، بێ دوودڵی بەرەو Browsershot بڕۆ. هیوادارین ئەم ڕێبەرە یارمەتیت بدات لە هەڵبژاردنی گونجاوترین ئامراز بۆ پڕۆژەکەت.

ئەم بابەتە سوودی هەبوو؟ بیری مەکە بڵاوی بکەیتەوە