В этом разделе описаны подготовительные операции, необходимые для нормальной установки phpstamp. Это нужно проделать всего один раз и только на одной машине! После этого можно просто копировать сформированную папку на другую машину и работать.

Это касается только пакета phpstamp, используемых им библиотек и подготовленных шрифтов. Установка php, прописывание папок в системной переменной PATH надо делать на каждой машине, на которой планируется использовать phpstamp.

Сразу поясню, почему я не собрал все это сам и не включил в дистрибутив, а вместо этого написал запутанную инструкцию (см. ниже) о том, что и откуда надо скачать, как распаковать, куда положить и т. д. Дело в том, что все используемые программы и библиотеки хоть и являются открытыми и бесплатными, но распространяются под разными лицензиями, при этом их лицензии отличаются от public domain, то есть от "лицензии" самого phpstamp. Поскольку я не силен в такого рода вопросах, да и пока не особо есть необходимость и возможность в них разбираться, то принял такое решение: никакие используемые в процессе работы библиотеки и программы НЕ являются частью phpstamp и соответственно не входят в дистрибутив.

Загрузка необходимых файлов

Для того, чтобы все заработало неообходимо сначала скачать требуемые файлы.

php

Phpstamp является скриптом, написанным на языке php. Это означает, что для его выполнения нужен интерпретатор вышеуказанного языка.

php - мощный современный язык программирования. И, хотя, его использование часто связывают именно с web-программированием, он позволяет писать серьезные программы и без использования web-технологий. phpstamp - как раз тот самый случай, когда для работы программы совершенно не нужен web-сервер.

Если в вашей системе php не установлен, то необходимо его скачать и установить. В большинстве linux-дистрибутивов php включен. Пользователям windows потребуется скачать его с http://php.net.

Авторы библиотеки Zend Framework, используемой при работе phpstamp, рекомендуют использовать версии не ниже 5.2.3, хотя и говорят, что будет работать с версиями от 5.1.4.

phpstamp

Теперь пора закачать сам phpstamp. Сделать это можно здесь.

Zend Framework

Zend Framework можно скачать отсюда. Полный пакет не требуется. Достаточно скачать минимальный, то есть саму библиотеку.

FPDF

FPDF можно скачать отсюда.

ttf2pt1

Для преобразования шрифтов из одного формата в другой потребуется утилита ttf2pt1. Ее можно найти по адресу http://ttf2pt1.sourceforge.net/.

Версия для windows доступна по адресу http://gnuwin32.sourceforge.net/packages/ttf2pt1.htm.

Достаточно будет скачать 'Complete package, except sources'.

Если вы не планируете использовать шрифты TrueType, то этот шаг можно пропустить.

Установка и настройка

Далее я буду рассматривать установку именно для windows по нескольким причинам. Во-первых, программа изначально писалась именно для использования под windows. Во-вторых, установка и настройка под linux отличается, в основном, расположением системных файлов. В-третьих, пользователям linux, как правило, знакомым с командной строкой, текстовыми файлами конфигурации программ и т. п. многие вещи и объяснять-то не надо.

php

После скачивания и установки дистрибутива необходимо его настроить. Для этого требуется отредактировать файл php.ini, который находится в папке, куда был установлен php (для windows-систем). В интернете есть куча описаний различных опций этого файла и того, что с ними делать. Поэтому отмечу лишь ряд моментов. Почему-то после установки дистрибутива php 5.2.5, он совершенно отказывается нормально работать с "умолчальным" файлом php.ini. Все дело в подключнных по умолчанию модулях. Большинство из них для работы phpstamp совершенно не нужны, например, на данный момент phpstamp не использует базы данных. Используются только те модули, которые требуются pdf-подсистеме библиотеки Zend Framework.

Подсистеме Zend_pdf набора библиотек Zend Framework нужны следующие модули-расширения php (extensions):

ctype
gd
iconv
zlib

phpstamp

После закачки архив надо распаковать в какую-нибудь папку, например, c:\phpstamp. Для всех дальнейших примеров я буду использовать именно эту папку.

В папке c:\phpstamp есть две подпапки: library и makefont. Туда надо скопировать части пакетов Zend Framework и FPDF. Более подробно об этом см. ниже.

Zend Framework

Сначала надо распаковать архив c Zend Framework в какую-нибудь папку, например, c:\zend. В этой папке будет подпапка c:\zend\library, а в ней, соответственно, папка Zend. Теперь надо скопировать содержимое папки c:\zend\library в папку c:\phpstamp\library. В итоге, в папке c:\phpstamp\library должна быть папка Zend из пакета Zend Framework, то есть из папки c:\zend\library. После копирования, папку c:\zend можно удалять.

FPDF

Аналогичную процедуру надо проделать и с пакетом FPDF. Для начала надо распаковать архив с FPDF в какую-нибудь папку, например, c:\fpdf. В этой папке будет подпапка c:\fpdf\makefont. Ее содержимое надо скопировать в папку c:\phpstamp\makefont. После копирования, папку c:\fpdf можно удалять.

ttf2pt1

Надо установить скачанную программу ttf2pt1. По умолчанию эта программа устанавливается в c:\program files\gnuwin32. Для удобства работы неплохо бы прописать этот путь в системной переменной PATH. Если вы не знаете как это сделать, то см. ниже раздел "Подготовка к работе". Если этого не сделать, то в файле create_font.bat в папке makefont придется прописать полный путь до файла ttf2pt1.

Подготовка к работе

Подготовка шрифта

На данный момент программа использует преобразованый шрифт arial из стандартной установки windows (это, кстати, несложно поменять, но придется исправлять файл pdfdraw.php).

Для того, чтобы подготовить шрифт к использованию надо проделать:

скопировать файл arial.ttf в папку c:\phpstamp\makefont. (обычно arial.ttf находится в c:\windows\fonts\).
зайти в папку c:\phpstamp\makefont
запустить там файл create_font.bat.

Если вы планируете использовать другой шрифт, то необходимо изменить строку

set FNT=arial

в файле create_font.bat на

set FNT=имя вашего шрифта без расширения.

Если тип используемого шрифта не TrueType, то есть файл шрифта это не один файл с расширением .ttf, пара файлов (.afm + .pfb), то в файле create_font.bat надо удалить строку

ttf2pt1 -L cp1251.map -b %FNT%.ttf

Установка PATH

Теперь самое время прописать папку c:\phpstamp в системной переменной PATH. Это можно сделать следующим образом:
Кнопка ПУСК / Настройка / Панель управления / Система / вкладка Дополнительно / кнопка Переменные среды

Внизу в окне системные переменные выбрать переменную Path и нажать кнопку "Изменить". Дописать в конец строки:
c:\phpstamp;

На этом программу можно считать установленной и готовой к работе.

Последние изменения были внесены 05.11.2008.