Отображаем PDF на Yii при помощи Zend

Интеграция Zend/Pdf в Yii Framework...

Введение

Yii является одним из распостраненных PHP фреймворков. В этой статье мы рассмотрим пример интеграции библиотеки для создания PDF файлов из ZendFramework.

Прим. переводчика: статья очень полезна в плане опыта интеграции классов из ZendFramework. При помощи полученного опыта вы можете связать практически любой класс с Yii без малейших проблем.

Программное обеспечение

Для выполнения всего этого я рекомендую закачать упрощенную версию Zend фреймворка (http://framework.zend.com/download/current/). При создании этого урока я использовал версию 1.9.5. Ekstrak ZendFramework-1.9.5-minimal.tar.gz и получил её следующим образом:

$ tar -xzvf ZendFramework-1.9.5-minimal.tar.gz

Прим. переводчика: Автор статьи использует консоль для закачки Zend Framework-а. Далее в уроке — он очень часто будет использовать её и читателям без опыта работы в Linux наверняка будет трудно понять происходящее. Если вы используете Windows — постарайтесь следователь комментариям между примерами кода и у вас всё получится.

Результат выглядел следующим образом:

[bpdp@bpdp-arch software]$ cd ZendFramework-1.9.5-minimal/
[bpdp@bpdp-arch ZendFramework-1.9.5-minimal]$ ls -la
total 32
drwxr-xr-x 4 bpdp users 4096 2009-10-27 00:19 .
drwxr-xr-x 7 bpdp users 4096 2009-10-30 11:19 ..
-rw-r--r-- 1 bpdp users 3438 2009-10-26 20:33 INSTALL.txt
-rw-r--r-- 1 bpdp users 1547 2009-10-26 20:33 LICENSE.txt
-rw-r--r-- 1 bpdp users 6496 2009-10-27 00:19 README.txt
drwxr-xr-x 2 bpdp users 4096 2009-10-26 20:39 bin
drwxr-xr-x 3 bpdp users 4096 2009-10-26 20:38 library
[bpdp@bpdp-arch ZendFramework-1.9.5-minimal]$

После этого я скопировал все содержимое Zend каталога в zax/protected/vendors. (я использую имя zax в качестве корневой папки приложения. У вас она может иметь другое имя или вовсе отсутствовать)

[bpdp@bpdp-arch vendors]$ ls -la
total 12
drwxr-xr-x  3 root root 4096 2009-10-30 09:56 .
drwxr-xr-x 12 root root 4096 2009-10-30 08:49 ..
drwxr-xr-x 59 root root 4096 2009-10-30 09:56 Zend
[bpdp@bpdp-arch vendors]$

Прим. переводчика: Как вы видите — в папку protected/vendors мы перемещаем папку Zend вместе со всем её содержимым.

Для того чтобы использовать PDF в качестве отображения — нам необходимо создать только контроллер. Вот пример создания контроллера PdfviewController:

[root@bpdp-arch zax]# protected/yiic shell
Yii Interactive Tool v1.0 (based on Yii v1.0.10)
Please type 'help' for help. Type 'exit' to quit.

>> controller pdfview
 generate PdfviewController.php
 mkdir /opt/web/httpd/htdocs/zax/protected/views/pdfview
 generate index.php

Controller 'pdfview' has been created in the following file:
 /opt/web/httpd/htdocs/zax/protected/controllers/PdfviewController.php

You may access it in the browser using the following URL:
 http://hostname/path/to/index.php?r=pdfview
>> [root@bpdp-arch zax]#

После этого немного изменим главный экшинс:

class PdfviewController extends CController
{
  public function actionIndex()
  {
    // подключаем Zend/Pdf
    Yii::import('application.vendors.*');
    require_once('Zend/Pdf.php');

    // создаем новый обьект PDF
    $pdf1 = new Zend_Pdf();

    // создаем страницу и определяем её размер
    $page = new Zend_Pdf_Page(Zend_Pdf_Page::SIZE_A4);

    // шрифт по умолчанию
    $font = Zend_Pdf_Font::fontWithName(Zend_Pdf_Font::FONT_HELVETICA);

    // применяем шрифт. указываем размер
    $page->setFont($font, 36);

    // вывод текста на странице
    $page->drawText('Hello from Yii', 72, 720);

    // добавляем странциу в pdf файл
    $pdf1->pages[] = $page;

    // получим результат всего pdf обьекта
    $pdfcontents = $pdf1->render();

    // показываем в браузере. п.с. незабудь указать тип содержимого в заголовке
    header('Content-Type: application/pdf');
    $this->layout = false;
    $this->renderText($pdfcontents);
  }

Результат (http://server/zax/index.php?r=pdfview) выглядит следующим образом:

Откуда это взялось?

Для того чтобы лучше понять описанный выше код и создавать более сложные PDF – я рекомендую прочитать обширную документацию разработчика по Zend классам. В первую очередь советую ознакомится с Zend_Pdf

Прим. переводчика: Статья является переводом с индонезийского. За что спасибо словарю и Google переводчику. Оригинал статьи - смотрим тут.