PHPWord

Создаем списки

2010-06-09T12:32:00.000-07:00

Сегодня учимся создавать списки, в этом нам будет помогать функция addListItem.

$section->addListItem( $text, [$depth], [$styleText], [$styleList] );

Итак, начинаю вещать) :

Функция addListItem()
Параметр	Тип данных	Описание
$text	String	Текст который передаем
$depth	Integer	Уровень списка, далее приведу пример не переживайте.
$styleText	String / Array	Стиль текста в текущей строке, примеры ниже
$styleList	Array	Стиль самого списка

Теперь разберем подробнее, много чего не сразу понятно.
Простой список создается так:

$section->addListItem('Строка 1', 0); //первая строка(элемент списка)
$section->addListItem('Строка 2', 0); //....
$section->addListItem('Строка 3', 0); //....

Результат будет таким:

Строка 1
Строка 2
Строка 3

Список с тремя уровнями

$section->addListItem('Строка 1', 0);    //первая строка(элемент списка), уровень 0
$section->addListItem('Строка 1.1', 1); // уровень 1
$section->addListItem('Строка 1.2', 1); // уровень 1
$section->addListItem('Строка 1.3 (styled)', 1, array('bold'=>true)); //тут мы уже задали стиль текста
$section->addListItem('Строка 1.3.1', 2);   // уровень 2
$section->addListItem('Строка 1.3.2', 2);   // уровень 2

Результат будет таким:

Строка 1

Строка1.1
Строка1.2
Строка 1.3 (styled)

Строка1.3.1
Строка1.3.2

Теперь перейдем в нумерованому списку:

$listStyle = array('listType'=>PHPWord_Style_ListItem::TYPE_NUMBER); // создали стиль списка
$section->addListItem('Строка 1', 0, null, $listStyle); // первая строка
$section->addListItem('Строка 2', 0, null, $listStyle);
$section->addListItem('Строка 3', 0, null, $listStyle);

Разберем. В первой строке создаем стиль для списка, возможные варианты разберу ниже(TYPE_NUMBER - нумерованный). NULL во второй строке и следеющих означет, что текст со стилем по умолчанию. А в результате получим такое:

Строка 1
Строка 2
Строка 3

Вот и подходим к самому интересному, список нумерованный с уровнями.

$PHPWord->addFontStyle('myOwnStyle', array('color'=>'FF0000')); //создали стиль для текста$listStyle = array('listType'=>PHPWord_Style_ListItem::TYPE_NUMBER_NESTED); //стиль списка
$section->addListItem('List Item 1', 0, 'myOwnStyle', $listStyle); // уровень 0
$section->addListItem('List Item 2', 0, 'myOwnStyle', $listStyle);
$section->addListItem('List Item 3', 1, 'myOwnStyle', $listStyle); // уровень 1
$section->addListItem('List Item 4', 1, 'myOwnStyle', $listStyle);
$section->addListItem('List Item 5', 2, 'myOwnStyle', $listStyle); // уровень 2
$section->addListItem('List Item 6', 1, 'myOwnStyle', $listStyle); // уровень 1
$section->addListItem('List Item 7', 0, 'myOwnStyle', $listStyle);

Разбираем писанину. В первой строке создали стиль для текста, который потом и будем применять. Вторая строка, создали стиль для списка.

1. List Item 1

2. List Item 2

o List Item 3

o List Item 4

List Item 5

o List Item 6

3. List Item 7

Как и обещал, привожу список констант для PHPWord_Style_ListItem, в последнем примере вторая строка:
TYPE_NUMBER - нумерованый список;
TYPE_NUMBER_NESTED - нумерованый-вложенный список;
TYPE_BULLET_FILLED - маркированый список, маркер ввиде заполненной окружности;
TYPE_BULLET_EMPTY - маркированый список, маркер ввиде незаполненной окружности;
TYPE_SQUARE_FILLED - маркированый список, маркер ввиде заполненного квадрата.

Вставляем изображение

2010-06-06T04:27:00.000-07:00

Всем привет, как и обещел, сегодня будем добавлять изображения в док.
Итак, открываем мануал, видим всякие... странности и разности, пардоньте, не тот мануал). Скажу сразу, использовать можно только изображения типа GIF, JPEG(JPG), BMP,TIFF, PNG. Для добавления изображения используется функция addImage:

$section->addImage( $src, [$style] );

где:

Функция addImage()
Параметры	Тип данных	Описание
$src	String	Путь к изображению на вашем web-сервере. Может быть абсолютным и относительным
$style	Array	Стиль отображения изображения

Как и в случае с текстом в предыдущем посте, существует не один способ применить стиль к изображению: создать стиль по ходу добавления изображения, выглядит так:

$section->addImage('Example.jpg', array('width'=>100, 'height'=>100, 'align'=>'right'));

а можно создать стиль и потом его просто применять к изображению:

$imageStyle = array('width'=>350, 'height'=>350, 'align'=>'center'); // создали стиль
$section->addImage('Example.jpg', $imageStyle); //применили по назначению

Рассмотри свойства которые можно задать в стиле.

Название	Описание
Width (ширина)	Ширина изображения в пикселях
Height (высота)	Высота изображения в пикселях
Align (выравнивание)	Выравнивание изображения на странице дока, возможны три значения left (по левому краю) right (по правому краю) center (по центру)

Думаю понятно, что если вставить просто строку:

$section->addImage('Example.jpg'); // без указания настроек отображения

то изображение вставиться в своём изначальном размере.

Кстати, уж чего не ожидал от бэта версии нашей горячо любимой библиотеки PHPWord, так это возможности вставлять в док изображение созданное с помощью GD (если вы не в курсе что это, настоятельно! советую нажать на ссылочку и почитать).

Вставить GD изображение можно с помощью функции addMemoryImage:

$section->addMemoryImage( $link, [$style] );

Все как всегда, ничего сложного, поэтому разбираем:

Функция addMemoryImage()
Параметр	Тип данных	Описание
$link	String	Путь к PHP файлу-источнику. Путь может быть только абсолютным (например “http://localhost/image.php”)
$style	Array	Стиль изображения

Настройки стиля теже, что и при работе с обычным изображением.

Использовать можно только GIF, JPEG(JPG), PNG.

THE END ;)

Начинаем писать)

2010-06-05T01:42:00.000-07:00

Здравствуйте, извините за перерыв, занимаюсь ргр-ом, чужим, причем тоже 4х курсника-дуба, только другого).Итак, пора нам уже научиться "писать"), чем сейчас и займемся.
Чтобы добавить текст, используем функцию, тоже фантастическую), addText. Само добавление выглядит так (как всегда, типичное "Hello World!", не хочу выделяться ;) ):

$section->addText( 'Hello World!'); //в док записали Hello World!

Ведь ничего сложного, совсем. Теперь попробуем отформатировать текст. Реализация возможна двумя путями. Первый , задать текст, затем задать формат; либо, создать стиль и просто применить его к тексту. Первый способ, поехали:

$section->addText('Hello World!', array('name'=>'Verdana', 'color'=>'006699','size'=>18,'bold'=>'true'));

Разбираем эту муть. Создаем текст 'Hello World!'; создаем стиль в виде массива ( array () ); 'name' - это название шрифта, в данном случае Verdana; 'color' - не трудно догадаться, цвет шрифта; 'size' - размер шрифта; 'bold'=>'true' - это как бы мы говорим "жирный шрифт включить".

Второй способ, думаю не будем пока пробираться через тернии к звездам, используем стиль форматирования из первого способа:

$PHPWord->addFontStyle('myFontStyle', array('name'=>'Verdana', 'color'=>'006699','size'=>18,'bold'=>'true'));
$section->addText('Hello World!', 'myFontStyle');

Разбираем, тут тоже просто. Создаем стиль шрифта (функцией addFontStyle) с именем 'myFontStyle', а дальше все как в предыдущем примере. В следующей строке просто добавляем текст, а затем прописываем стиль для него. Второй способ конечно удобнее, создал стиль и не парься - не забывай только применять.

Есть еще два способа форматировать текст, правда они являются производными от двух предыдущих. Наверно, я их опущу).

Попробуем вставить в текст новый обзац, альтернатива нажатия "Enter" на клаве.

$section->addTextBreak(); // вставка одного абзаца

Если вам захотелось вставить 5 абзацев, нет необходимости мыкать 5 раз addTextBreak, достаточно сделать так:

$section->addTextBreak(5); //вставка 5 абзацев

Допустим нам надо начать следующую страницу (разрыв страницы сделать), "траблы" нет никакой:

$section->addPageBreak(); //вставка разрыва страницы (новая страница)

Пока все, следующий пост будет посвящен вставке изображения в док.

Разделы и их свойства

2010-05-31T01:25:00.000-07:00

Доброго времени суток).
В этом посте разберем: что такое раздел в WORDe, как создать раздел из PHP, как изменить стиль раздела.
Раздел (section) - "это часть документа, форматирование которой никак не связано с форматированием остального документа". Приведу стандартный пример:

На изображении видим страницу, хотя больше похоже на альтернативу туалетной бумаги в школе, последний тетрадный листок исписанный бреднями измученного школьника, но, судя по "Lorem Ipsum" это бывший конспект по филосфии. Почитайте тут. Так, ладно, вернемся к разделам. На одной странице созданы два раздела, под пунктом "один" обозначен раздел с одной колонкой, под "два" - раздел с двумя колонками. Вроде и задроту-линейщику ясно.

Чтобы создать раздел по умолчанию используется следующий код:

$section = $PHPWord->createSection();

Предыдущая строка создаст раздел ~~порно~~... эээ...портретной ориентации, со стандартными полями (оступами).

Разберем свойства раздела, которые можно задать из PHP:

orientation - ориентация страницы, может принимать два значения: null - по умолчанию, портретная; landscape - альбомная, ~~и гетеро~~, пардоньте, не удержался...

marginTop - отступ сверху, измеряется в твипах (twips).

marginLeft - отступ слева, измеряется в твипах (twips).

marginRight - отступ справа, измеряется в твипах (twips).

marginBottom - отступ сниза, измеряется в твипах (twips).

Возможны два способа задать стиль раздела. Из массива, перед создание самого раздела:

$sectionStyle = array('orientation' => null, //задали портретную ориентацию

'marginLeft' => 900, //отступ слева на 900 твипов

'marginRight' => 900, //отступ справа

'marginTop' => 900, //отступ сверху

'marginBottom' => 900); //отступ снизу

$section = $PHPWord->createSection(sectionStyle); // создали раздел

Теперь создаем раздел и потом задаем свойства:

$section = $PHPWord->createSection(); // создали раздел

$sectionStyle = $section->getSettings(); // получаем свойства

$sectionStyle->setLandscape(); // задаем ориентацию , альбомная

$sectionStyle->setMarginLeft(900); //отступ слева на 900 твипов

$sectionStyle->setMarginRight(900); //отступ справа

$sectionStyle->setMarginTop(900); //отступ сверху

$sectionStyle->setMarginBottom(900); //отступ снизу

Совсем забыл, есть еще два свойства для разделов, но разработчики не рекомендуют их изменять (а чтобы подкрепить свои ремендации, решили вообще не приводить пример реализации в мануале):
pageSizeW - ширина страницы в твипах.
pageSizeH - высота страницы в твипах.

Начало

2010-05-30T07:22:00.000-07:00

Ну вот и я, вернемся к нашим баранам. предположительно вы уже выполнили действия описанные в предыдущем посте. Скачали, скопировали содержимое на web-сервер. Кстати, документация на англ. языке, поэтому я буду вставлять "литературный" перевод, свои коменты по-поводу и без повода, и не нормативную лексику (последнее - шутка).

Чтобы библиотека PHPWord фурычила на нашем DENWERe, нам потребуется расширить PHP модуль. Сказано - сделано. Идем на оф.сайт, качаем расширение тут. Скачали, запустили, процесс установки аналогичен установке самого сервера, прочитали инструкцию на этой странице. На крайняк процитирую, проще чем там , я объяснить не могу:
"После успешной установки вам необходимо открыть файл /usr/local/php5/php.ini в любом текстовом редакторе и раскомментировать директивы подключения тех или иных модулей".
Перед этими строками:

extension=php_gd2.dll
extension=php_mbstring.dll
extension=php_mysql.dll
extension=php_mysqli.dll
extension=php_pdo_mysql.dll
extension=php_pdo_mysql.dll

удаляем точку с запятой - ";". Сохраняем файл. Теперь запустим файл /usr/local/php5/go-pear.bat на исполнение. Готово.

Пойдем типичным путем - теория, затем практика.

Заглянем в манула, скаченый ранее. В мануале сказано, что нам часто будет попадаться понятие "twip", twip - это базовая еденица для Open Office.Я, честно говоря, первый раз сталкиваюсь с twip, могу только добавить, что twip также используется в VB. 1 twip = 1/1440 дюйма.

По умолчанию текст в Word документ экспортируется шрифтом Arial с размером 10. Вы можете изменить шрифт по умолчанию, используя следующие две функции:

$PHPWord->setDefaultFontName('Tahoma'); // шрифт "Tahoma"

$PHPWord->setDefaultFontSize(12); // размер шрифта 12

Т.е. открыв документ, увидим текст напечатанный 12 шрифтом "Tahoma".

Также можно установить свойства для всего документа:

Name (свойство)	Type (тип данных)
Creator (автор)	String (строковый)
Company (компания)	String
Title (название)	String
Description (комментарии)	String
Category (категория)	String
Last modified by (редакция)	String
Created (дата создания)	Datetime (дата)
Modified (изменен)	Datetime
Subject (тема)	String
Keywords (ключевые слова)	String

Чтобы установить эти свойства используйте следующий код (пример):

$properties = $PHPWord->getProperties(); //получеам свойства из след строк

$properties->setCreator('My name'); //задаем автора документа

$properties->setCompany('My factory'); //задаем компанию

$properties->setTitle('My title'); //задаем название документа

$properties->setDescription('My description'); //задаем комменты к док-у

$properties->setCategory('My category'); //задаем категорию док-а

$properties->setLastModifiedBy('My name'); //задаем последнего кто изменил док

$properties->setCreated( mktime(0, 0, 0, 3, 12, 2010) ); // время и дата создания

$properties->setModified( mktime(0, 0, 0, 3, 14, 2010) );//время и дата последнего редактирования

$properties->setSubject('My subject'); // задаем тему дока

$properties->setKeywords('my, key, word');// задаем ключевые слова док-а

P.S.: Ну вот пока и все, ссори, но времени не много, посты будут небольшие.

What the hell ?

2010-05-30T03:01:00.000-07:00

Начнем с домашней страницы этого чуда, призванного облегчить нашу жизнь. Итак, PHPWord это библиотека написанная на PHP для создания Word документов. Как утверждают разработчики, PHPWord базируется на, просто таки, фантастических библиотеках: PHPExcel и PHPPowerPoint. поверим на слово... пока.

PHPWord позволяет нам: создавать docx документ; вставлять и форматировать текст, изображения, OLE-объекты, таблицы, ссылки и прочее (прочего, кстати, не так уж и много). В общем круче Notepad, и даже WordPad, но все же, если вздумаете форматировать ваш документ таким способом, тогда как можно воспользоваться WORDом, то вы, наверно, проктолог, а может просто не ищите легких путей.
Требования PHPWord таковы: PHP 5.2.x (и выше); PHP расширение ZipArchive (для работы с Zip-архивами); PHP расширение XML (для работы с XML); и конечно потребуется Microsoft Office Compatibility Pack, вытянуть можно отсюда (оф. сайт мелкософта).
Можете тут посмотреть базовый пример, хотя разработчики предлагают скачать нам саму библиотеку и примеры одним архивом, и конечно не забудем про документацию, качаем тут.
После того как вытянули архив с библиотекой и примерами, разъархивируйте его и скопируйте содержимое на ваш web-сервер. Насчет web-сервера...
Так как задача состоит разобраться в том как создать Word документ посредством PHP, я не заморачивался и поставил Denwer. Итак, копируем библиотеку в директорию "Ваш web-сервер\home\localhost\www\....".
Следующий пост будет посвящен разбору полетов в документации, так как она на родном языке Обамы, хотя не факт), ну уж точно на родном для королевы Великобритании.

Привет мир!

2010-05-29T15:48:00.000-07:00

Hello world!

Скажу сразу, я студент 2 курса, судите как хотите: строго, с юмором, можно и как Эрнст в КВНе.
Попросили меня как-то сделать дипломную работу (было это неделю назад), ну, знаете как бывает, заканчивает человек 4 курс, а сам дуб-дерево (конечно, не буду называть вуз, где этот дуб растет), получит он димплом и будет искать работу..., как сам он выразился, работу "говноляпа". Хотя, кому нужны "говноляпы", которые не знают даже как абревиатура HTML переводится. Ну да ладно, речь пойдет в дальнейших постах не о "калловых массах" и лопатах, а о PHP. Задача дипломной работы заключалась в создании ведомости успеваемости студентов в WEB-виде, если можно так выразится. Я бы вам и подробнее рассказал, но сам этот "заказчик" даже еще толком не знает, что от него хотят преподы. Естественно, чем дальше в лес, тем толще партизаны. Но, пока задание ограничено экспортом из PHP в Word, а точнее того, что отображается в браузере. Заметим, что еще даже не ясно, будут ли данные черпаться из какой-либо БД. Какой путь самурая в решении этой траблы я избрал узнаете завтра, точнее сегодня, но уже днем, а сейчас у меня в трее 1:47, так что извиняйте.

P.S.: Блог ориентирован на начинающих, чайников и точно не на гуру, профи, ботанов и еже с ними.