من فضلك تسجيل الدخول أو تسجيل لتفعل ذلك.

يقدم المطور Steve Bauman حزمة Laravel جديدة ومفيدة تُدعى «Screenshot»، والتي تتيح للمطورين التقاط صور لصفحات HTML وعروض Blade وصفحات الويب الكاملة وتحويلها إلى ملفات PNG أو JPEG أو PDF مباشرةً من داخل تطبيقات PHP الخاصة بهم. ما يميز هذه الحزمة هو أنها تستخدم متصفح Chrome مباشرة من PHP، دون الحاجة إلى تثبيت Node.js أو Puppeteer، مما يبسط عملية الإعداد والاستخدام بشكل كبير.

كيف تعمل حزمة Screenshot؟

يمكنك تمرير المحتوى الخاص بك إلى الحزمة باستخدام وظائف `html()` أو `view()` أو `url()` لالتقاط المطلوب. على سبيل المثال، يمكن لمنصة تعليمية توليد صورة لشهادة إتمام دورة تدريبية لمشاركتها مع المتعلم. الحزمة تدعم حفظ اللقطات محليًا أو تخزينها على أي قرص ملفات Laravel مُكوّن، مثل S3. التنسيق الافتراضي للالتقاط هو PNG، ولكن يمكن تغييره بسهولة إلى JPEG أو PDF باستخدام وظيفتي `jpeg()` أو `pdf()`.

بشكل افتراضي، يكون JavaScript معطلاً عند التقاط صفحات الويب. لتفعيله، خاصة للصفحات العامة التي تعتمد عليه للعرض الديناميكي، يمكن استخدام وظيفة `javascript()` قبل الالتقاط. تنتظر الحزمة حدث تحميل الصفحة بالكامل، وإذا كانت صفحتك تجلب بيانات أو تعرض رسومًا بيانية بعد هذا الحدث، قد تحتاج إلى مراعاة ذلك لضمان التقاط المحتوى كاملاً. يمكن تحديد أبعاد شاشة العرض التي يستخدمها Chrome لتخطيط الصفحة عبر `size()`، بينما تلتقط `viewport()` الجزء المرئي فقط.

التقاط عناصر محددة وإنشاء ملفات PDF

تتيح حزمة «Screenshot» إمكانية التقاط عناصر محددة داخل الصفحة باستخدام مُحددات CSS. على سبيل المثال، إذا كانت صفحة الشهادة تحتوي على أزرار تنقل، يمكنك تحديد العنصر الخاص بالشهادة فقط، مثل `#certificate`، لتصدير هذا الجزء بالذات. في حالة التقاط الصور، يتم قص الصورة لتناسب حدود العنصر المحدد. أما بالنسبة لملفات PDF، فإن Chrome ينقل العنصر إلى جسم المستند ويطبعه مع أنماط CSS الخاصة بالمستند.

تُصدر ملفات PDF افتراضيًا بحجم A4 في الوضع الرأسي وبهوامش 10 مم، مع طباعة الخلفيات. يمكن تهيئة أبعاد الورق والهوامش بسهولة. إذا كانت ورقة الأنماط الخاصة بك تحدد حجم صفحة عبر `@page size`، يمكن إعطائها الأسبقية باستخدام `preferCssPageSize()`.

التثبيت والمتطلبات

تدعم حزمة «Screenshot» إصدار Laravel 12 مع PHP 8.2 أو أحدث، وإصدار Laravel 13 مع PHP 8.3 أو أحدث. يتم التثبيت عبر Composer ثم تشغيل أمر `php artisan screenshot:install` الذي يقوم بتنزيل Chrome for Testing إذا لم يكن مثبتًا بالفعل. يمكن أيضًا استخدام تثبيت Chrome أو Chromium موجود مسبقًا بتحديد مساره.

ماذا يعني هذا للمطورين؟

بالنسبة لمطوري Laravel، تقدم حزمة «Screenshot» حلًا مباشرًا وفعالًا لمهام شائعة مثل توليد شهادات إلكترونية، فواتير، أو صور مصغرة للمشاركة على وسائل التواصل الاجتماعي، مباشرة من بيئة PHP. يقلل هذا من الحاجة إلى الاعتماد على خدمات خارجية أو إعدادات معقدة تتطلب Node.js، مما يبسط سير عمل التطوير ويوفر الوقت والجهد. برأينا، هذه الإضافة تُعزز من قدرات تطبيقات Laravel في التعامل مع المحتوى المرئي بشكل أكثر تكاملاً وسلاسة.

المصدر: laravel-news.com

Cloudflare: شهادة ISMS-P الكورية تعني خصوصية أقوى
ثغرة GitLab حرجة تسمح بتنفيذ تعليمات برمجية عن بُعد

Reactions

0
0
0
0
0
0
بالفعل كان رد فعل لهذا المنصب.

ردود الفعل