docxmustache

docxmustache для Laravel 10.x.

Класс манипуляции шаблонами Docx для Laravel 10.x, основанный на языке шаблонов усов. Этот класс все еще находится в стадии активной разработки и на данный момент работает скорее как доказательство концепции. Все быстро изменится и может что-то сломать.

Этот пакет поможет вам использовать файлы docx с синтаксисом усов в качестве шаблонов для объединения документов с богатым стилем с информацией из любого источника данных. Он может заменять текст и изображения и поддерживает основные стили HTML (жирный, курсив, подчеркивание).

Установка

composer require wrklst/ docxmustache

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

HTML-преобразование

Текущее преобразование HTML является базовым и поддерживает только отдельные фрагменты жирного, курсива и подчеркнутого текста, но не их комбинацию. Требуется, чтобы все значения, отличные от html, были экранированы с помощью htmlspecialchars($value, ENT_COMPAT, 'UTF-8'); и префикс *[[DONOTESCAPE]]* , чтобы класс знал, что не следует экранировать HTML-код до его преобразования в openXML.

Замена изображений

Изображение должно представлять собой доступный URL-адрес с изображением в поддерживаемом формате. Значение URL необходимо поместить в поле описания альтернативного текста изображения. Изображения будут преобразованы в соответствии с ограничениями изображения-заполнителя. Значение изображения необходимо форматировать с помощью псевдотегов, например: [IMG-REPLACE]http://placehold.it/350x150[/IMG-REPLACE]

Пример

Пожалуйста, также ознакомьтесь с примером в папке примеров, чтобы получить общее представление о том, как использовать этот класс.

Преобразование DOCX в PDF

Для преобразования в PDF требуется установка libreoffice-common на сервере (используется для преобразования). Используйте sudo apt install libreoffice-common на вашем сервере на базе Ubuntu/Debian. Также установите ttf-mscorefonts, если вам нужна поддержка шрифта Arial при преобразовании документов docx в PDF sudo apt-get install ttf-mscorefonts-installer

Другие зависимости

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

• усы/усы
• вмешательство/изображение (требуется добавление поставщика и псевдонима в конфигурацию вашего приложения, а также gd или imagick; подробности см. на веб-странице вмешательства изображения)

Специфические зависимости Laravel (актуально только в том случае, если они перенесены в среду, отличную от Laravel):

• Класс Storage и File, основанный на Flysystem (для локального доступа к файлам также можно заменить собственными методами php fopen и т. д.)
• SymfonyComponentProcessProcess (только для преобразования PDF)

Взносы

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

Зачем еще одно решение для шаблонов openXML/docx?

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

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

Другие классы PHP для управления текстовыми документами openXML:

• openTBS – маленький, но сильный
• PHPWord
• docxtemplater pro (базовая версия с открытым исходным кодом/бесплатная версия/лицензия MIT доступна на момент написания; замена изображений — это коммерческий плагин)
• docxpresso (коммерческий)
• phpdocx (коммерческий)