FPDI - Free PDF Document Importer ================================= [![Latest Stable Version](https://poser.pugx.org/setasign/fpdi/v/stable.svg)](https://packagist.org/packages/setasign/fpdi) [![Total Downloads](https://poser.pugx.org/setasign/fpdi/downloads.svg)](https://packagist.org/packages/setasign/fpdi) [![Latest Unstable Version](https://poser.pugx.org/setasign/fpdi/v/unstable.svg)](https://packagist.org/packages/setasign/fpdi) [![License](https://poser.pugx.org/setasign/fpdi/license.svg)](https://packagist.org/packages/setasign/fpdi) :heavy_exclamation_mark: This document refers to FPDI 2. Version 1 is deprecated and development is discontinued. :heavy_exclamation_mark: FPDI is a collection of PHP classes facilitating developers to read pages from existing PDF documents and use them as templates in [FPDF](http://www.fpdf.org), which was developed by Olivier Plathey. Apart from a copy of [FPDF](http://www.fpdf.org), FPDI does not require any special PHP extensions. FPDI can also be used as an extension for [TCPDF](https://github.com/tecnickcom/TCPDF) or [tFPDF](http://fpdf.org/en/script/script92.php), too. ## Installation with [Composer](https://packagist.org/packages/setasign/fpdi) Because FPDI can be used with FPDF, TCPDF or tFPDF we haven't added a fixed dependency in the main composer.json file. You need to add the dependency to the PDF generation library of your choice yourself. To use FPDI with FPDF include following in your composer.json file: ```json { "require": { "setasign/fpdf": "1.8.*", "setasign/fpdi": "^2.0" } } ``` If you want to use TCPDF, you have to update your composer.json to: ```json { "require": { "tecnickcom/tcpdf": "6.3.*", "setasign/fpdi": "^2.0" } } ``` If you want to use tFPDF, you have to update your composer.json to: ```json { "require": { "setasign/tfpdf": "1.31.*", "setasign/fpdi": "^2.3" } } ``` ## Manual Installation If you do not use composer, just require the autoload.php in the /src folder: ```php require_once('src/autoload.php'); ``` If you have a PSR-4 autoloader implemented, just register the src path as follows: ```php $loader = new \Example\Psr4AutoloaderClass; $loader->register(); $loader->addNamespace('setasign\Fpdi', 'path/to/src/'); ``` ## Changes to Version 1 Version 2 is a complete rewrite from scratch of FPDI which comes with: - Namespaced code - Clean and up-to-date code base and style - PSR-4 compatible autoloading - Performance improvements by up to 100% - Less memory consumption - Native support for reading PDFs from strings or stream-resources - Support for documents with "invalid" data before their file-header - Optimized page tree resolving - Usage of individual exceptions - Several test types (unit, functional and visual tests) We tried to keep the main methods and logical workflow the same as in version 1 but please notice that there were incompatible changes which you should consider when updating to version 2: - You need to load the code using the `src/autoload.php` file instead of `classes/FPDI.php`. - The classes and traits are namespaced now: `setasign\Fpdi` - Page boundaries beginning with a slash, such as `/MediaBox`, are not supported anymore. Remove the slash or use a constant of `PdfReader\PageBoundaries`. - The parameters $x, $y, $width and $height of the `useTemplate()` or `getTemplateSize()` method have more logical correct default values now. Passing `0` as width or height will result in an `InvalidArgumentException` now. - The return value of `getTemplateSize()` had changed to an array with more speaking keys and reusability: Use `width` instead of `w` and `height` instead of `h`. - If you want to use **FPDI with TCPDF** you need to refactor your code to use the class `Tcpdf\Fpdi` (since 2.1; before it was `TcpdfFpdi`) instead of `FPDI`. ## Example and Documentation A simple example, that imports a single page and places this onto a new created page: ```php <?php use setasign\Fpdi\Fpdi; // or for usage with TCPDF: // use setasign\Fpdi\Tcpdf\Fpdi; // or for usage with tFPDF: // use setasign\Fpdi\Tfpdf\Fpdi; // setup the autoload function require_once('vendor/autoload.php'); // initiate FPDI $pdf = new Fpdi(); // add a page $pdf->AddPage(); // set the source file $pdf->setSourceFile("Fantastic-Speaker.pdf"); // import page 1 $tplId = $pdf->importPage(1); // use the imported page and place it at point 10,10 with a width of 100 mm $pdf->useTemplate($tplId, 10, 10, 100); $pdf->Output(); ``` A full end-user documentation and API reference is available [here](https://manuals.setasign.com/fpdi-manual/).

عن المجلة

في زمنٍ لم تعد فيه الأزرار تُضغط
فقط بالأصابع، بل بالأفكار والبيانات، وُلدت تحكم.

لسنا مجرد مجلة تقنية… نحن مرآة لعصر تغيّرت فيه موازين السيطرة.
نرصد كيف أصبحت التكنولوجيا شريكًا في القرار، لاعبًا في الاقتصاد، ومرشدًا للإنسان — وأحيانًا سيدًا عليه.

“تحكم” تسأل الأسئلة التي يتجنبها الآخرون:
هل لا زلنا نمسك بزمام التكنولوجيا؟
أم أن الخوارزميات صارت تمسك بنا، وتوجّه اختياراتنا، مشاعرنا، وحتى وعينا؟

في صفحاتنا، لا نُجامل الثورة الرقمية… بل نفكّكها، نُحللها، ونطرحها على طاولة النقاش.
من الذكاء الاصطناعي إلى السيادة الرقمية، من الخصوصية إلى تحوّل الإنسان نفسه…
“تحكم” تقف على الخط الفاصل بين الإنسان والآلة، وتُنيره.

نحن لا نُخبرك فقط بما يحدث، بل لماذا يحدث، ولمن، وعلى حساب من.

تحكم… لأنّ من يملك المعلومة، يملك السيطرة.

رسالة المجلة:
نسعى في تحكم إلى تقديم محتوى تقني معمّق، تحليلي ونقدي، يُعنى بكشف الأبعاد الخفية للثورة الرقمية وتأثيراتها على الإنسان والمجتمع. نرصد تحوّلات السيطرة في عصر البيانات، ونُسلّط الضوء على تداخل التكنولوجيا بالقرار والسيادة والمعرفة، من دون تزييف أو انبهار أعمى. هدفنا هو تمكين القارئ من الفهم الواعي، والاختيار المستقل، في زمن أصبحت فيه الخوارزميات طرفًا خفيًا في المعادلة.

رؤية المجلة:
أن تكون تحكم المرجع العربي الأول في تحليل وتفكيك العلاقة بين الإنسان والتكنولوجيا، والمنصة التي تصنع الوعي الرقمي الحر، وتقود النقاشات الجريئة حول مستقبلنا المشترك مع الذكاء الاصطناعي والتحوّلات الرقمية. نطمح إلى بناء جيل يُمسك بزمام التقنية… لا العكس.

الأقسام:
قسم تفاعل..يركز على تأثير التكنولوجيا على الحياة الاجتماعية و التقنيات الحديثة.
يهتم بدراسة كيف غيرت التقنيات الحديثة أساليب التواصل، وأنماط العمل، و اشكال المدن ، وحتى في ميادين القتال.
قسم خدمة..في مجال التكنولوجيا يركز على تطوير البرمجيات والخدمات الرقمية التي تُستخدم لتسهيل حياة الأفراد وتحسين أداء الأعمال.
قسم معرفة..تركز في مجال التكنولوجيا لتحسين الخدمات الصحية وتطوير العملية التعليمية. في الصحة، يشمل ذلك تطبيقات التشخيص عن بُعد، والذكاء الاصطناعي في التشخيص والعلاج. أما في التعليم، فيركز على التعلم الإلكتروني، الواقع الافتراضي، وأنظمة إدارة التعلم التي تسهم في تحسين تجربة الطالب والمعلم على حد سواء.
قسم خطوة..في مجال التكنولوجيا يهتم بدراسة تأثير التكنولوجيا على الاقتصاد، وتوظيفها في إنشاء وتطوير المشاريع الناشئة والصغيرة. يُركز هذا القسم على استخدام الأدوات الرقمية لتحسين العمليات الاقتصادية، مثل التجارة الإلكترونية، والتحول الرقمي في الأعمال.
قسم الميديا..خاص بعرض التقارير المصورة و الحوارات الخاصة بالتكنولوجيا.

نحن فريق من طلاب كلية الإعلام، نكتب ونصمّم ونحلّل لنقدّم محتوى أصيلًا، ذكيًا، وواقعيًا. نختار موضوعاتنا بعناية، ونحرص على أن يكون كل ملف نطرحه مساحة للفهم والتساؤل، لا التكرار والإبهار الزائف.

فريق التحرير:
د.أمل منير رئيس التحرير
د.أمنية خالد نائب رئيس التحرير
المحررين:
إيريني أنطون
شروق عارف
مريم سمير
ميرنا اشرف
فرح سمير