تكامل NextPDF Artisan

لمحة سريعة

nextpdf/artisan مكتبة، وليست مكوّنًا إضافيًا لإطار عمل. لدمجها، ثبّتها وأرفق ChromeRendererConfig بمستند ⁨NextPDF⁩، ثم استدعِ writeHtmlChrome(). استخدم هذه الصفحة للوصول إلى بقية وثائق ⁨Artisan.⁩

التثبيت

composer require nextpdf/artisan

للاطلاع على مصفوفة المتطلبات الكاملة واعتماد ⁨Chrome⁩ الخارجي، راجع /⁨integrations/artisan/install/.⁩

الإقلاع والاكتشاف

لا تتضمّن ⁨Artisan⁩ أي مزوّد خدمة أو حزمة أو بيان اكتشاف تلقائي خاص بإطار عمل. إنها مكتبة ⁨PHP⁩ بسيطة متوافقة مع توصية ⁨PHP⁩ المعيارية 4 (⁨PSR-4⁩) (NextPDF\Artisan\، NextPDF\Parser\) وتستهلكها مباشرةً. لا يوجد ما يلزم اكتشافه. نقطة الدخول هي طريقة writeHtmlChrome() التي يكشفها nextpdf/core على Document بعد أن تصبح فئات الجسر قابلة للتحميل التلقائي. للاطلاع على نموذج الاكتشاف والإقلاع، راجع /⁨integrations/artisan/boot-and-discovery/.⁩

روابط الحاوية

لا يوجد تكامل حاوية مخصّص للنشر. في البيئات التي لا تحتوي على حاوية حقن اعتماديات، يوفّر EInvoiceServiceFactory طرق مصنع ثابتة (makeEmbedder، makeValidator، makeDefaultProfile، makeSchematronRunner). تُرجع هذه الطرق تطبيقات عقود الفوترة الإلكترونية في ⁨Premium⁩، أو null عندما لا تكون فئة ⁨Premium⁩ مثبّتة. يحاكي هذا سلوك إرجاع ⁨null⁩ في حزم التغليف الخاصة بأطر العمل، بحيث تستخدم الشيفرة غير المعتمدة على حاوية الواجهة نفسها. للاطلاع على التفاصيل والمبررات، راجع /⁨integrations/artisan/boot-and-discovery/.⁩

نقاط دخول ⁨API⁩ العامة

نقطة الدخول	الموقع	موثَّقة في
Document::writeHtmlChrome() (طريقة في ⁨core⁩)	nextpdf/core	/⁨integrations/artisan/quickstart/⁩
Document::setChromeRendererConfig() (طريقة في ⁨core⁩)	nextpdf/core	/⁨integrations/artisan/quickstart/⁩
ChromeHtmlRenderer::render()	nextpdf/artisan	/⁨integrations/artisan/production-usage/⁩
ChromeRendererConfig / ::fromArray()	nextpdf/artisan	/⁨integrations/artisan/configuration/⁩
EInvoiceServiceFactory::make*()	nextpdf/artisan	/⁨integrations/artisan/boot-and-discovery/⁩

توقيع writeHtmlChrome() هو (string $html, ?float $width = null, ?float $height = null): static، وقد تم التحقق منه مقابل nextpdf/coresrc/Core/Concerns/HasTextOutput.php.

اختبار التحقق السريع

<?php

declare(strict_types=1);

use NextPDF\Artisan\ChromeHtmlRenderer;
use NextPDF\Artisan\ChromeRendererConfig;

require __DIR__ . '/vendor/autoload.php';

$renderer = new ChromeHtmlRenderer(new ChromeRendererConfig());
assert($renderer->getHtmlSecurityPolicy()->getName() === 'default');
echo "ARTISAN_WIRED\n";

يثبت هذا أن التحميل التلقائي وروابط عقود nextpdf/core تُحَلّ دون تشغيل ⁨Chrome⁩ (سلوك مؤكَّد بواسطة tests/Unit/Artisan/ChromeHtmlRendererTest.php::usesDefaultHtmlSecurityPolicyWhenNoneInjected). للاطلاع على اختبار تحقق سريع شامل للعرض يشغّل ⁨Chrome⁩، راجع /⁨integrations/artisan/chrome-renderer-setup/.⁩

إلى أين تتجه بعد ذلك

• اعرض مستندك الأول: /⁨integrations/artisan/quickstart/⁩
• كل خيارات الإعداد: /⁨integrations/artisan/configuration/⁩
• توفير ⁨Chrome⁩ / الحاويات: /⁨integrations/artisan/chrome-renderer-setup/⁩
• نموذج النقل والعزل: /⁨integrations/artisan/security-and-operations/⁩
• ربط بيئة الإنتاج وعمّال الدفعات: /⁨integrations/artisan/production-usage/⁩
• تشخيص عطل: /⁨integrations/artisan/troubleshooting/⁩
• كيف تُقلِع الحزمة: /⁨integrations/artisan/boot-and-discovery/⁩

السياق التجاري

الجسر برنامج مفتوح المصدر يعمل بكامل وظائفه. تضيف فئات ⁨Premium⁩ تضمين الفوترة الإلكترونية (⁨Pro⁩) والتحقق منها (⁨Enterprise⁩) فوق ملف ⁨Portable Document Format⁩ (⁨PDF⁩) الناتج. عند غيابها، يتراجع EInvoiceServiceFactory إلى null، بحيث يمكنك كتابة شيفرة التكامل مرة واحدة وتشغيلها مع ⁨Premium⁩ أو من دونها.

انظر أيضًا

• /integrations/artisan/overview/
• /integrations/artisan/install/
• /integrations/artisan/boot-and-discovery/
• /integrations/artisan/quickstart/