PHPWord

Другой исходный код

1.3.0

Скачать

Мастер филиала: PHPWord

PHPWord — это библиотека, написанная на чистом PHP, которая предоставляет набор классов для записи и чтения файлов документов различных форматов. Текущая версия PHPWord поддерживает Microsoft Office Open XML (OOXML или OpenXML), формат открытых документов OASIS для приложений Office (OpenDocument или ODF), форматированный текстовый формат (RTF), HTML и PDF.

PHPWord — это проект с открытым исходным кодом, лицензированный на условиях LGPL версии 3. PHPWord призван стать высококачественным программным продуктом, включающим непрерывную интеграцию и модульное тестирование. Вы можете узнать больше о PHPWord, прочитав документацию разработчика.

Если у вас есть вопросы, задавайте их на StackOverFlow.

Узнайте больше о PHPWord:

Функции
Требования
Установка
Начиная
Содействие
Документация разработчиков

Функции

С помощью PHPWord вы можете динамически создавать документы OOXML, ODF или RTF, используя сценарии PHP. Ниже приведены некоторые вещи, которые вы можете делать с библиотекой PHPWord:

Установите свойства документа, например название, тему и автора.
Создавайте разделы документа с различными настройками, например книжной/альбомной ориентацией, размером страницы и нумерацией страниц.
Создайте верхний и нижний колонтитулы для каждого раздела.
Установите тип шрифта по умолчанию, размер шрифта и стиль абзаца.
Используйте шрифты/символы UTF-8 и восточноазиатские шрифты.
Определите пользовательские стили шрифта (например, полужирный, курсив, цветной) и стили абзацев (например, центрированный, многоколоночный, интервал) либо как именованный стиль, либо как встроенный в текст.
Вставляйте абзацы в виде простого текста или сложного текста (текстового фрагмента), содержащего другие элементы.
Вставьте заголовки (заголовки) и оглавление.
Вставка разрывов текста и разрывов страниц
Вставляйте и форматируйте изображения локально, удаленно или в виде водяных знаков на странице.
Вставьте двоичные объекты OLE, такие как Excel или Visio.
Вставка и форматирование таблицы с настраиваемыми свойствами для каждой строки (например, повторение в качестве строки заголовка) и ячеек (например, цвет фона, диапазон строк, диапазон столбцов).
Вставка элементов списка как маркированных, нумерованных или многоуровневых.
Вставка гиперссылок
Вставка сносок и концевых сносок
Вставка фигур чертежа (дуга, кривая, линия, полилиния, прямоугольник, овал)
Вставка диаграмм (круговая, кольцевая, гистограмма, линейная, площадная, точечная, радарная)
Вставка полей формы (текстовый ввод, флажок и раскрывающийся список)
Создать документ из шаблонов
Используйте таблицы стилей XSL 1.0 для преобразования заголовков, основной части документа и нижних колонтитулов шаблона OOXML.
... и многие другие функции в процессе разработки

Требования

PHPWord требует следующего:

PHP 7.1+
Расширение XML-парсера
Компонент Laminas Escaper
Расширение Zip (необязательно, используется для записи OOXML и ODF)
Расширение GD (необязательно, используется для добавления изображений)
Расширение XMLWriter (необязательно, используется для записи OOXML и ODF)
Расширение XSL (необязательно, используется для применения таблицы стилей XSL к шаблону)
библиотека dompdf (необязательно, используется для записи PDF)

Установка

PHPWord устанавливается через Composer. Чтобы добавить зависимость от PHPWord в свой проект, либо

Запустите следующее, чтобы использовать последнюю стабильную версию

composer require phpoffice/phpword

или если вам нужна последняя неизданная версия

composer require phpoffice/phpword:dev-master

Начиная

Ниже приведен базовый пример использования библиотеки PHPWord.

addText( '"Great achievement is usually born of great sacrifice, ' . 'and is never the result of selfishness." ' . '(Napoleon Hill)', array('name' => 'Tahoma', 'size' => 10) ); // Adding Text element with font customized using named font style... $fontStyleName = 'oneUserDefinedStyle'; $phpWord->addFontStyle( $fontStyleName, array('name' => 'Tahoma', 'size' => 10, 'color' => '1B2232', 'bold' => true) ); $section->addText( '"The greatest accomplishment is not in never falling, ' . 'but in rising again after you fall." ' . '(Vince Lombardi)', $fontStyleName ); // Adding Text element with font customized using explicitly created font style object... $fontStyle = new PhpOfficePhpWordStyleFont(); $fontStyle->setBold(true); $fontStyle->setName('Tahoma'); $fontStyle->setSize(13); $myTextElement = $section->addText('"Believe you can and you're halfway there." (Theodor Roosevelt)'); $myTextElement->setFontStyle($fontStyle); // Saving the document as OOXML file... $objWriter = PhpOfficePhpWordIOFactory::createWriter($phpWord, 'Word2007'); $objWriter->save('helloWorld.docx'); // Saving the document as ODF file... $objWriter = PhpOfficePhpWordIOFactory::createWriter($phpWord, 'ODText'); $objWriter->save('helloWorld.odt'); // Saving the document as HTML file... $objWriter = PhpOfficePhpWordIOFactory::createWriter($phpWord, 'HTML'); $objWriter->save('helloWorld.html'); /* Note: we skip RTF, because it's not XML-based and requires a different example. */ /* Note: we skip PDF, because "HTML-to-PDF" approach is used to create PDF documents. */">

 
require_once ' bootstrap.php ' ;

// Creating the new document...
$ phpWord = new  PhpOffice  PhpWord  PhpWord ();

/* Note: any element you append to a document must reside inside of a Section. */

// Adding an empty Section to the document...
$ section = $ phpWord -> addSection ();
// Adding Text element to the Section having font styled by default...
$ section -> addText (
    ' "Learn from yesterday, live for today, hope for tomorrow. '
        . ' The important thing is not to stop questioning." '
        . ' (Albert Einstein) '
);

/*
 * Note: it's possible to customize font style of the Text element you add in three ways:
 * - inline;
 * - using named font style (new font style object will be implicitly created);
 * - using explicitly created font style object.
 */

// Adding Text element with font customized inline...
$ section -> addText (
    ' "Great achievement is usually born of great sacrifice, '
        . ' and is never the result of selfishness." '
        . ' (Napoleon Hill) ' ,
    array ( ' name ' => ' Tahoma ' , ' size ' => 10 )
);

// Adding Text element with font customized using named font style...
$ fontStyleName = ' oneUserDefinedStyle ' ;
$ phpWord -> addFontStyle (
    $ fontStyleName ,
    array ( ' name ' => ' Tahoma ' , ' size ' => 10 , ' color ' => ' 1B2232 ' , ' bold ' => true )
);
$ section -> addText (
    ' "The greatest accomplishment is not in never falling, '
        . ' but in rising again after you fall." '
        . ' (Vince Lombardi) ' ,
    $ fontStyleName
);

// Adding Text element with font customized using explicitly created font style object...
$ fontStyle = new  PhpOffice  PhpWord  Style  Font ();
$ fontStyle -> setBold ( true );
$ fontStyle -> setName ( ' Tahoma ' );
$ fontStyle -> setSize ( 13 );
$ myTextElement = $ section -> addText ( ' "Believe you can and you ' re halfway there." (Theodor Roosevelt) ' );
$ myTextElement -> setFontStyle ( $ fontStyle );

// Saving the document as OOXML file...
$ objWriter =  PhpOffice  PhpWord  IOFactory :: createWriter ( $ phpWord , ' Word2007 ' );
$ objWriter -> save ( ' helloWorld.docx ' );

// Saving the document as ODF file...
$ objWriter =  PhpOffice  PhpWord  IOFactory :: createWriter ( $ phpWord , ' ODText ' );
$ objWriter -> save ( ' helloWorld.odt ' );

// Saving the document as HTML file...
$ objWriter =  PhpOffice  PhpWord  IOFactory :: createWriter ( $ phpWord , ' HTML ' );
$ objWriter -> save ( ' helloWorld.html ' );

/* Note: we skip RTF, because it's not XML-based and requires a different example. */
/* Note: we skip PDF, because "HTML-to-PDF" approach is used to create PDF documents. */

Дополнительные примеры представлены в папке с образцами. Для быстрого доступа к этим примерам запустите php -S localhost:8000 в каталоге примеров, затем перейдите по адресу http://localhost:8000, чтобы просмотреть образцы. Вы также можете прочитать документацию разработчика для более подробной информации.