Создание сайтов с возможностью печати PDF на примере PDF::AP

Хотелось бы рассмотреть преимущества формата PDF (Portable Document Format), разработанного компанией Sun Microsystems, а также где и почему стоит использовать формат PDF при создании сайтов.
Пожалуй, вам несколько раз встречалась необходимость печати документов прямо из Интернета. Это могут быть счета, квитанции, данные для печати на шаблоне.
Возможно, вам также приходилось встречаться с особенностями печати подобных документов, оформленных в виде HTML кода напрямую из Internet Explorer. Если всё же не приходилось - обязательно придётся в ближайшем будущем. Суть этих особенностей заключается в том, что этот броузер, несмотря на то, что является самым распространенным на момент написания статьи, не умеет корректно печатать web-страницы. Информация на распечатанной странице начинает странным образом съезжать, фон и другое оформление куда-то изчезает, а часть страницы может быть вообще обрезана. Как вы понимаете, подобные вещи непозволительны, когда необходимо предоставить пользователю возможность распечатать документ, с которым он пойдет в банк.
Ситуация осложняется еще больше, когда необходимо распечатать некий документ на заранее подготовленном шаблоне. Конечно, заранее подготовленные шаблоны редко используются на классических веб-сайтах, однако создание сайтов не ограничивается созданием HTML-страниц. Сайтом может быть внутрикорпоративный портал, B2B-система, рабочее место оператора в конце концов.
Поскольку практически у каждого рядового пользователя на компьютере установлен Adobe Acrobat Reader или подобный, можно с уверенностью заявить, что документы, оформленные в формате PDF, прочитать не составит возможности.
Так в чём же преимущества формата PDF? Перечислить все их мне, например, не представляется возможным, поэтому постараюсь упомянуть об основных. Прежде всего, как уже говорилось выше, формат PDF гарантирует, что документ будет распечатан в точности так, как он выглядит на экране пользователя. Во-вторых, любой, абсолютно любой принтер распечатает документ с теми отступами и позиционированием, какое вы зададите в сгенерированном файле PDF, а не в соответствии с зашитыми в принтер настройками. Помимо этого, некоторые действия над PDF (например, изменение) могут быть защищены паролем. Ко всему прочему, существенно упрощается генерация многостраничных документов. Те, кто занимался этим и использовал HTML понимают, что не так уж просто заставить разрываться страницы имеено там, где вам нужно. Как видите, преимуществ использования PDF перед обычным HTML более, чем достаточно.

Как вас зовут:
Напишите свои комментарии к статье:

Теперь, когда разобраны основные преимущества создания сайтов с использованием системы печати документов в формате PDF, попробуем разобрать пример с использованием Perl и PDF::API2.
Будем считать, что установленный и сконфигурированный web-сервер, например, Apache, а также Perl вы под рукой уже имеете.
Первым делом, нужно установить модуль PDF::API2 для Perl, если вы еще не сделали этого. Сделать это необычайно просто. Просто выполните следующую команду из под пользователя Root:

1. perl -e shell -MCPAN


Возможно, если вы раньше не пользовались CPAN, необходимо будет ответить на несколько вопросов, чтобы инициализировать интсаллятор. В большинстве случаев достаточно ответить «no» на первый же вопрос «Are you ready for manual configuration?»
После того, как настроите CPAN, вы попадёте в оболочку CPAN, перед вами будет примерно следующее:


cpan shell -- CPAN exploration and modules installation (v1.7602)
ReadLine support available (try install Bundle::CPAN)

cpan>


Наберите команду install PDF::API2 и подождите, пока всё установится. Если возникнут проблемы, можно воспользоваться исходным кодом PDF::API2, расположенным на search.cpan.org.
После установки PDF::API2, выйдите из устанощика CPAN, набрав
exit
Проверить, всё ли установилось так, как надо, можно набрав в консоли:
perl -e use PDF::API2
Если после ввода указанной команды не последовало никакого вывода, значит всё хорошо.
Я бы также посоветовал установить модуль XML::Simple. Сделать это можно аналогично установке PDF::API2. Этот модуль позволит нам создавать XML файлы с конфигурацией печати документов в PDF.
Итак, мы имеем установленный PDF::API2 и можем начинать заниматься созданием сайтов с использованием указанного модуля и генерировать PDF файлы налету.
Создайте файл PrintPDF.pm и запишите в него следующее:

package PrintPDF;

use strict;
use XML::Simple;
use PDF::API2;

sub PrintPDF {
my $blobref = shift;
my $configref = shift;
my $hashref = shift;
}

1;

Мы создали новый модуль Perl, который имеет одну единственную функцию PrintPDF и принимает параметры: ссылку на переменную, содержащую бинарный код шаблона PDF, на котором будем печатать, ссылку на переменную содержащую XML код конфигурационного файла и ссылку на хэш, значения которого будут использоваться при печати на шаблоне.
Дополним функцию PrintPDF:

sub PrintPDF {
my $blobref = shift;
my $configref = shift;
my $hashref = shift;

my $pdf;
if (scalar $blobref=~m!^PDF::API2=HASH!) {
$pdf = $blobref;
} else {
$pdf = PDF::API2->openScalar($$blobref) or die $!;
}

my $fnt_orig = $pdf->corefont(Verdana, -encode=>windows-1251);
my $size_orig = 7;
my ($fnt, $size, $color, $align);
my $xml = XMLin($$configref, ForceArray=>1);
return $pdf;
}

Теперь наша функция, помимо того, что принимает параметры, делает еще и следующие вещи:

1. инициализирует объект PDF::API2, записывая копию объекта в $pdf
2. может получать в качестве входного параметра не только ссылку на бинарный код шаблона, но и уже готовый, созданный объект PDF::API2
3. задаёт значения по умолчанию: шрифт, размер, кодировку, цвет и выравнивание
4. считывает в память конфигурационный XML файл