Phpword как сделать таблицу

Библиотека PHPWord: основные возможности

Библиотека PHPWord, находящаяся уже почти год в стадии бета-тестирования 1) , предоставляет возможность создания сложных документов формата OOXML ( *.docx ). Рассмотрим основные возможности этой библиотеки. Для начала работы достаточно распаковать архив с библиотекой в каталог с создаваемым вами документом PHP и подгрузить основной класс библиотеки, расположенный в файле PHPWord.php :

Свойства документа и шрифт по-умолчанию

Создание документа начинается с объявления экземпляра класса PHPWord. Конструктор не требует передачи аргументов:

Далее следует задать название и размер шрифта по-умолчанию:

В рассматриваемой версии до применения указанных выше функций шрифтом по-умолчанию является Arial размером 20 пунктов . Теперь можно задать время создания документа, имя автора и так далее:

По-умолчанию в качестве даты создания и изменения документа указывается текущее время, а остальные свойства заполняются пустыми значениями. Если требуется указать конкретную дату создания или изменения, используйте функцию mktime или любую другую функцию, возвращающую время в стиле Unix.

Создание разделов

Основным элементом документа Word является Раздел . Раздел представляет собой прямоугольную область, внутри которой помещаются остальные элементы страницы: текст, изображения, таблицы и т.д.

Раздел может иметь книжную или альбомную ориентацию, настраиваемые поля (margins), настраиваемые цвета границ раздела и их толщину (на рисунке показана пунктиром):

Параметр Описание
orientation Ориентация страницы:
null — книжная ориентация,
landscape — альбомная
marginTop Размер верхнего поля во внутренних единицах
marginRight Размер правого поля во внутренних единицах
marginBottom Размер нижнего поля во внутренних единицах
marginLeft Размер левого поля во внутренних единицах
borderTopSize Толщина верхнего края рамки во внутренних единицах
borderRightSize Толщина правого края рамки во внутренних единицах
borderBottomSize Толщина нижнего края рамки во внутренних единицах
borderLeftSize Толщина левого края рамки во внутренних единицах
borderTopColor Цвет верхнего края рамки в шестнадцатеричном формате
borderRightColor Цвет правого края рамки в шестнадцатеричном формате
borderBottomColor Цвет нижнего края рамки в шестнадцатеричном формате
borderLeftColor Цвет левого края рамки в шестнадцатеричном формате

Для создания раздела существует функция createSection . В качестве внутренних единиц используются типографские твипы. Если вам непривычно указывать размеры в твипах, можно написать простую функцию, преобразующую миллиметры в твипы:

Указанные в таблице параметры могут быть переданы в виде массива при создании раздела.

. или могут быть установлены по-отдельности после создания раздела:

Добавление текста

Добавление блока текста

Под блоком текста понимается отрывок текста, имеющий одинаковое форматирование (цвет, размер шрифта и т.п.). Для создания блока текста в выбранном разделе используйте функцию addText :

Здесь $text — добавляемый текст, необязательный параметр $fontStyle — имя определенного ранее текстового стиля, необязательный параметр $paragraphStyle — имя определенного ранее стиля абзаца.

Изменение форматирования текста

Форматирование текста, как и форматирование раздела, может осуществляться при его создании.

. или устанавливается после создания предназначенными для этого методами:

Ниже приведен полный список доступных параметров форматирования текста:

Параметр Описание
size Размер шрифта в типографских пунктах
name Название шрифта (кегль)
bold Является ли текст полужирным (true\false)
italic Выделен ли текст курсивом (true\false)
superScript Является ли текст надстрочным (true\false)
subScript Является ли текст подстрочным (true\false)
underline Вид подчеркивания 2) из набора констант PHPWord_Style_Font:
UNDERLINE_NONE — нет подчеркивания,
UNDERLINE_DASHHEAVY — жирная штриховая линия,
UNDERLINE_DASHLONG — удлиненная штриховая линия,
UNDERLINE_DASHLONGHEAVY — удлиненная жирная штриховая линия,
UNDERLINE_DOUBLE — двойная линия,
UNDERLINE_DOTHASH 3) — штрих-пунктир,
UNDERLINE_DOTHASHHEAVY — жирный штрих-пунктир,
UNDERLINE_DOTDOTDASH — две точки + тире,
UNDERLINE_DOTDOTDASHHEAVY — жирные две точки + тире,
UNDERLINE_DOTTED — пунктир,
UNDERLINE_DOTTEDHEAVY — жирный пунктир,
UNDERLINE_SINGLE — одинарная линия,
UNDERLINE_WAVY — волнистая линия,
UNDERLINE_WAVYDOUBLE — двойная волнистая линия,
UNDERLINE_WAVYHEAVY — тройная волнистая линия,
UNDERLINE_WORDS — подчеркивать только слова (не подчеркивать пробелы)
Color Цвет шрифта в шестнадцатеричном формате
fgColor Цвет выделения маркером из набора констант PHPWord_Style_Font:
FGCOLOR_YELLOW — желтый,
FGCOLOR_LIGHTGREEN — ярко-зеленый,
FGCOLOR_CYAN — бирюзовый,
FGCOLOR_MAGENTA — лиловый,
FGCOLOR_BLUE — синий,
FGCOLOR_RED — красный,
FGCOLOR_DARKBLUE — темно-синий,
FGCOLOR_DARKCYAN — сине-зеленый,
FGCOLOR_DARKGREEN — темно-зеленый,
FGCOLOR_DARKMAGENTA — фиолетовый,
FGCOLOR_DARKRED — темно-красный,
FGCOLOR_DARKYELLOW — коричнево-зеленый,
FGCOLOR_DARKGRAY — серый 50%,
FGCOLOR_LIGHTGRAY — серый 25%,
FGCOLOR_BLACK — черный

Названия параметров должны употребляться с соблюдением регистра. В случае параметров underline и fgColor применение значений, не указанных в таблице, не допускается.

Cписок доступных параметров форматирования абзаца:

Параметр Описание
align Выравнивание текста в абзаце:
left — по левому краю,
right — по правому краю,
center — по центру,
both или justify — по ширине
spaceBefore Отступ абзаца сверху в твипсах
spaceAfter Отступ абзаца снизу в твипсах
spacing Интервал между строк в твипсах

Определение стилей текста и абзаца

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

Здесь $styleName — заданное вами имя стиля, $fontStyle — массив, содержащий определение стиля. После создания стиля его имя можно использовать при создании блоков текста, например:

Аналогичным образом осуществляется создание стиля абзаца:

Группировка блоков текста в абзац

Блоки текста с различным форматированием могут быть объединены в абзац заданного вида. Для этого применяется команда createTextRun :

Необязательный параметр $paragraphStyle — массив со стилем абзаца или название созданного ранее именованного стиля.

Добавление заголовков

В библиотеке имеются отдельные функции для добавления заголовков ( addTitle ) и задания их стилей ( addTitleStyle ). Применение заголовков вместо форматированных блоков текста необходимо в том случае, если вы хотите добавить в документ автоматически создаваемое оглавление, поскольку в оглавление включаются только заголовки, а не обычные блоки текста. При добавлении заголовков создание стилей заголовков обязательно:

Здесь $titleLevel — уровень заголовка, для которого задается стиль (обычно от 1 до 6), $fontStyle — массив со стилем форматирования заголовка, $paragraphStyle — массив со стилем форматирования абзаца. Как видите, форматирование можно не трогать, но сам стиль заголовка требуемого уровня должен быть обязательно создан. Добавление заголовка делается так:

По-умолчанию создается заголовок 1 уровня.

Добавление ссылок

Добавление ссылок мало чем отличается от добавления обычного текста. Для добавления ссылки используется команда:

Разрыв строки и страницы

Для принудительного переноса строки используйте синтаксис:

Необязательный параметр $num, по-умолчанию равный 1, указывает сколько переносов строки необходимо сделать. Для принудительной вставки разрыва страницы выполните:

Добавление оглавления

Для добавления оглавления используется функция addTOC :

Здесь $fontStyle — форматирование текста, определенное одним из ранее указанных способов, $tocStyle — массив со стилем оформления оглавления, возможные параметры которого приведены в таблице: ^ Параметр ^ Описание ^

tabLeader Заполнитель между заголовком и номером страницы из набора констант PHPWord_Style_TOC :
TABLEADER_DOT — точки,
TABLEADER_UNDERSCORE — символ подчеркивания,
TABLEADER_LINE — линия,
TABLEADER_NONE — нет заполнителя
tabPos Положение номера страницы в твипсах
Indent Отступ заголовков в твипсах

Добавление списков

Присутствует возможность добавления нумерованных и ненумерованных списков в документ. Для добавления элемента списка используйте код:

Здесь $text — текст добавляемого элемента списка, $depth — глубина вложенности элемента в списке (от 1 до 9, по-умолчанию равна 1), $textStyle — форматирование текста списка одним из предложенных ранее способов, $listStyle — форматирование самого списка при помощи массива параметров, $paragraphStyle — форматирование абзаца. На данный момент не существует функции addListStyle , поскольку у списков пока может изменяться только один параметр:

Параметр Описание
listType Вид списка из набора констант PHPWord_Style_ListItem:
TYPE_NUMBER — одноуровневый нумерованный список,
TYPE_NUMBER_NESTED — многоуровневый нумерованный список,
TYPE_BULLET_FILLED — ненумерованный список с маркерами в виде закрашенных кругов,
TYPE_BULLET_EMPTY — ненумерованный список с маркерами в виде незакрашенных кругов,
TYPE_SQUARE_FILLED — ненумерованный список с маркерами в виде закрашенных квадратов

Добавление таблиц

Важной частью документа Word являются таблицы. Для создания таблицы в PHPWord выполните:

Необязательный аргумент $tableStyle — массив с описанием стиля таблицы или название такового, определенного методом addTableStyle :

Аргументы: $styleName — название стиля, $tableStyle — массив с определением стиля, $firstRowStyle — массив с определением стиля ячеек 1 строки (шапки) таблицы. Ниже приведена таблица возможных стилевых параметров таблицы в целом: ^ Параметр ^ Описание ^

cellMarginTop Отступ от ячейки сверху в твипсах
cellMarginRight Отступ от ячейки справа в твипсах
cellMarginBottom Отступ от ячейки снизу в твипсах
cellMarginLeft Отступ от ячейки слева в твипсах

Теперь в созданную таблицу можно добавить ячейки. Как и в XHTML, вначале нужно создать строку.

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

. или сделать то же самое одной командой.

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

Команда Действие
addText Добавить форматированный текст
addTextBreak Добавить перенос строки
addLink Добавить ссылку
addListItem Добавить элемент списка
addImage Добавить изображение из файла
addMemoryImage Добавить динамически сгенерированное изображение
addObject Добавить объект OLE
addPreserveText Добавить поле (например, нумерацию страниц)

Как вы уже, наверное, догадались, параметр $rowHeight — позволяет задать высоту в твипсах создаваемой строки, $cellWidth — ширину ячейки (столбца), а $cellStyle — изменить форматирование ячейки. При форматировании ячейки поддерживаются следующие параметры:

Параметр Описание
valign Выравнивание в ячейке по-вертикали: both — по-вертикали по ширине,
top — по верхнему краю,
bottom — по нижнему краю,
center — по-центру
textDirection Направление текста из набора констант PHPWord_Style_Cell:
TEXT_DIR_BTLR — развернут на 90 градусов против часовой стрелки,
TEXT_DIR_TBRL — развернут на 90 градусов по часовой стрелке
bgColor Цвет фона ячейки в шестнадцатеричном формате
borderTopSize Толщина верхней границы ячейки в твипсах
borderRightSize Толщина правой границы ячейки в твипсах
borderBottomSize Толщина нижней границы ячейки в твипсах
borderLeftSize Толщина левой границы ячейки в твипсах
borderTopColor Цвет верхней границы ячейки в шестнадцатеричном формате
borderRightColor Цвет правой границы ячейки в шестнадцатеричном формате
borderBottomColor Цвет нижней границы ячейки в шестнадцатеричном формате
borderLeftColor Цвет левой границы ячейки в шестнадцатеричном формате

Добавление изображений

PHPWord позволяет добавлять в создаваемый документ изображения 2 типов: из файла (метод addImage ) и динамически сгенерированное сценарием изображение (метод addMemoryImage ). Поддерживаются файлы форматов jpg, png, gif, tiff, bmp. Примеры применения методов:

Здесь $src и $url — соответственно путь к файлу и абсолютный путь к сценарию (с адресом сайта и промежуточных каталогов), $imageStyle — массив с форматированием изображения. Поддерживаемые параметры форматирования:

Параметр Описание
width Требуемая ширина изображения в пикселях
height Требуемая высота изображения в пикселях
align Горизонтальное выравнивание изображения:
left — по левому краю,
right — по правому краю,
center — по центру

Если требуемые размеры изображения не указаны — библиотека пытается определить фактические размеры изображения при помощи функции [php>getimagesize|getimagesize]].

Добавление объектов OLE

С помощью метода addObject вы можете внедрить в создаваемый документ фрагмент другого документа (*.docx, *.xlsx, *.pptx) при помощи технологии OLE:

Массив $objectStyle может содержать только один параметр:

Параметр Описание
align Выравнивание объекта по-горизонтали:
left — по левому краю,
right — по правому краю,
center — по центру

Колонтитулы

Каждый раздел документа может иметь свой верхний ( header ) и нижний ( footer ) колонтитул, отображаемый на всех принадлежащих ему страницах. С точки зрения Word колонтитул является особым видом раздела, поэтому к колонтитулу применимо большинство описанных выше методов: addText, createTextRun, addTextBreak, addImage, addMemoryImage, addListItem, addTable. Кроме этого колонтитул имеет собственный метод addPreserveText, позволяющий создавать нумерацию страниц. Пример создания верхнего ( createHeader ) и нижнего ( createFooter ) колонтитула:

Как и всегда форматирование текста колонтитула и абзаца являются необязательными параметрами.

Использование шаблонов

Библиотека PHPWord поддерживает еще один интересный метод создания документов Word — использование шаблонов. Подробный принцип работы при генерировании документов из шаблонов описан в статье docx-templates. В качестве метки в PHPWord используется комбинация $ , где NAME — имя метки. Пример генерирования с использованием меток:

Сохранение файла

Для сохранения файла на жесткий диск или вывода его для скачивания пользователю используется метод save класса PHPWord_Writer_Word2007. В качестве единственного аргумента метода указывается строка ‘php://output’ , если требуется вывести документ для скачивания пользователем или имя файла , если документ нужно сохранить на жесткий диск. При выводе файла для скачивания не забудьте отправить браузеру пользователя соответствующие заголовки:

Сохранение файла на жесткий диск:

Пример

Подытоживая все вышесказанное хочется привести пример, в котором проиллюстрировано применение большинства возможностей библиотеки PHPWord:

Источник

Читайте также:  Как сделать букву цветами
Поделиться с друзьями
Ответ и точка