Generating PDF files with PHP and FPDF
Большинство web-сервисов экспортируют данные в разных форматах для дальнейшего использования. Данная статья о том, как экспортировать данные в pdf-формате.
Хотя многие знают как это делать, я опишу кратко для тех кто не знает.
PHP позволяет нам генерировать файлы в формате pdf налету. FPDF — это бесплатный код на языке php, позволяющий создавать документы в формате pdf и производить с ними различные манипуляции.
PDFlib
PHP API содержит большое количество функций для работы с PDF, реализованных на базе PDFlib. Несмотря на это, данная библиотека не является бесплатной для коммерческого использования. Бесплатная версия называется PDFlib Lite и бесплатная для персонального использования, однако она ограничена в функциональности. Для того чтобы использовать полную библиотеку PDFlib необходимо купить лицензию.
Почему FPDF?
Альтернатива — это использование FPDF, бесплатный класс содержащий большое количество функций для создания и манипулирования PDF-документами. Ключевое слово для данного момента — это ее бесплатность. Вы можете скачать, использовать и модифицировать данный класс как вам заблагорассудится. В дополнение к бесплатности, эта библиотека намного проще, чем PDFlib. Для использования PDFlib необходимо установить ее как расширение к PHP, в то время как FPDF может быть подключена в программу напрямую.
Создание документов PDF
Для того чтобы начать, необходимо скачать код FPDF с сайта FPDF Web site и включить в программу. Например, вот так
- Ориентация страницы (P or L) книжная или альбомная
- Размерность (pt,mm,cm или in)
- Размер документа (A3, A4, A5, Letter and Legal)
Так как в данном примере мы используем одинаковый шрифт для всего документа, мы устанавливаем его до создания страницы
У функции SetFont 3 параметра; название шрифта, стиль и размер. Мы используем Helvetica, жирный и 20 пунктов, мы будем использовать его для заголовка документа.
Вы можете использовать любой другой шрифт, используя функцию AddFont.
Используя функцию SetTextColor, мы устанавливаем цвет шрифта для всего документа. Цвет может быть представлен в RGB или grey scale. В данном примере мы используем RGB-значения.
Теперь когда главное сделано, приступим к созданию страниц.
В функцию AddPage () можно передать параметры «P» или «L» для указания ориентации страницы. Функция SetDisplayMode определяет как будет отображена страница. Вы можете определить параметры увеличения и разметки. В примере мы используем 100% увеличение и разметку по умолчанию, определенную в программе, используемой для просмотра.
Сейчас, когда у нас есть страница, давайте вставим в нее изображение для того чтобы сделать страницу приятней, также мы добавим ссылку. Мы отобразим логотип FPDF используя функцию Image и передадим в нее следующие параметры — название файла, размерность и адрес.
Функция SetXY устанавливает x и y координаты точки, в которой мы хотим вывести заголовок. SetDrawColor устанавливает цвет границы, используя значения RGB. После этого мы вызываем функцию Cell для вывода прямоугольника с текстом нашего заголовка. Мы передаем в функцию следующие параметры: ширина, высота, текст, граница, ln, выравнивание и заполнение. Значение границы 0 — отсутствие границы или 1 для наличия границы. Для ln мы используем значение по умолчанию 0, «C» — выравнивание текста по цуентру и 0 для параметра заполнение. Если мы бы установили последний паараметр в 1 наш прямоугольник был бы закрашен, значение 0 оставит его прозрачным.
Теперь мы хотим написать маленький текст в наш документ
$pdf->SetXY(10,50);
$pdf->SetFontSize(10);
$pdf->Write(5,’Congratulations! You have generated a PDF. ‘);
Итак снова мы устанавливаем координаты вывода текста x и y, но теперь мы уменьшим размер шрифта, используя SetFontSize. Функция Write напечатает текст в наш документ. Параметр 5 устанавливает высоту, он имеет смысл только тогда когда у нас есть много строк в нашем тексте.
В конце мы выведен наш результат, используя функцию Output.
Здесь мы указали имя файла и параметры вывода, в данном случае «I». «I»-параметр выведет результат в браузер.
require(‘fpdf.php’);
//create a FPDF object
$pdf=new FPDF();
//set document properties
$pdf->SetAuthor(‘Lana Kovacevic’);
$pdf->SetTitle(‘FPDF tutorial’);
//set font for the entire document
$pdf->SetFont(‘Helvetica’,’B’,20);
$pdf->SetTextColor(50,60,100);
//set up a page
$pdf->AddPage(‘P’);
$pdf->SetDisplayMode(real,’default’);
//insert an image and make it a link
$pdf->Image(‘logo.png’,10,20,33,0,’ ‘,’http://www.fpdf.org/’);
//display the title with a border around it
$pdf->SetXY(50,20);
$pdf->SetDrawColor(50,60,100);
$pdf->Cell(100,10,’FPDF Tutorial’,1,0,’C’,0);
//Set x and y position for the main text, reduce font size and write content
$pdf->SetXY (10,50);
$pdf->SetFontSize(10);
$pdf->Write(5,’Congratulations! You have generated a PDF.’);
//Output the document
$pdf->Output(‘example1.pdf’,’I’);
Сейчас когда мы научились создавать документы, посмотрим что еще можно сделать, используя FPDF. Пример ниже показывает нам как создать верх и низ (хедер и футер 🙂 ) нашего документа.
require(‘fpdf.php’);
class PDF extends FPDF
function Header()
$this->Image(‘logo.png’,10,8,33);
$this->SetFont(‘Helvetica’,’B’,15);
$this->SetXY(50, 10);
$this->Cell(0,10,’This is a header’,1,0,’C’);
>
function Footer()
$this->SetXY(100,-15);
$this->SetFont(‘Helvetica’,’I’,10);
$this->Write (5, ‘This is a footer’);
>
>
$pdf=new PDF();
$pdf->AddPage();
$pdf->Output(‘example2.pdf’,’D’);
Как вы видите мы создали дочерний класс, используя наследование и создания функций Header и Footer. Затем мы создали новый объект и добавили страницу в документ. Функция AddPage автоматически вызовет функции Header и Footer. В конце мы вывели полученную информацию в файл с названием example2.pdf, используя значение «D». В этом случае браузер предложит сохранить данный файл.
Итак, мы изучили основы создания PDF-документов, для более подробной информации используйте FPDF Web site.
Русская версия документации ZIP и TGZ
How to Generate a PDF File in PHP
Sajal Soni Last updated Mar 23, 2021
In this article, we’re going to discuss how you can generate PDF files in PHP. We’ll use the TCPDF library to create PDF documents programmatically.
If you’re working on a website which allows users to download or print documents like order receipts, bills, or invoices, you have a couple of options. You can either display the document inline in the browser or provide a download. When it comes to downloading documents, PDF is one of the best formats and is excellent at preserving text formatting.
So if you want to learn how to generate PDF files on your PHP website, you’re in the right place!
How to Install the TCPDF Library
In this section, we’ll see how to install the TCPDF library.
There are different ways to install the TCPDF library on your server. The TCPDF library is available at Packagist and GitHub, so you could either use Composer or clone it from GitHub. In our case, we’re going to install it with Composer.
Go ahead and run the following command to install the TCPDF library with Composer.
$composer require tecnickcom/tcpdf
Using version ^6.3 for tecnickcom/tcpdf
./composer.json has been created
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
- Installing tecnickcom/tcpdf (6.3.5): Downloading (100%)
Generating autoload files
Once it’s installed successfully, you need to include the autoload.php file in your PHP script, as shown in the following snippet.
require "./vendor/autoload.php";
And with that, you’re ready to use all the utility methods provided by the TCPDF library.
How to Use the TCPDF Library
In this section, we’ll build a real-world example, which demonstrates how to generate a PDF invoice. The TCPDF library provides a lot of ready-made templates that you could use as a reference to generate PDF documents. However, we’re going to generate an invoice from scratch.
As I’ve already mentioned in the previous section, the TCPDF library provides a lot of ready-made templates that allow you to generate generic PDF files with headers and footers. And that’s really useful if you’re happy with the default formatting and settings. But if you want to customize the header and footer along with the content, you would have to extend the TCPDF class and override the corresponding methods.
In our example, we’ll create two files: customPdfGenerator.php and example.php. In the customPdfGenerator.php file, we’ll create the CustomPdfGenerator class, which will extend the core TCPDF class and override a couple of methods. In the example.php file, we’ll see how to use the CustomPdfGenerator class.
The CustomPdfGenerator Class
Go ahead and create the customPdfGenerator.php file with the following contents.
class CustomPdfGenerator extends TCPDF