PHPOffice в PHP: Excel, Word и PowerPoint на практике
PHPOffice — семейство PHP-библиотек для чтения и генерации офисных файлов на сервере. С его помощью можно собрать отчёт Excel, заполнить договор по шаблону Word и сформировать презентацию из данных приложения. Для каждой задачи нужен свой Composer-пакет.
Какую библиотеку PHPOffice выбрать
У PHPOffice несколько самостоятельных пакетов. Формат файла определяет, какой пакет подключать, а конкретная операция — чтение, генерация или заполнение шаблона — определяет, какую часть его API использовать.
| Задача | Пакет | Форматы и возможности |
|---|---|---|
| Таблицы Excel и обмен данными | phpoffice/phpspreadsheet | XLSX, XLS, ODS, CSV. Чтение таблиц, формулы, стили, несколько листов |
| Договоры, письма, акты | phpoffice/phpword | DOCX и другие форматы, включая ODT и RTF. Набор операций зависит от формата. Для заполнения шаблонов используют DOCX |
| Презентации | phpoffice/phppresentation | PPTX и ODP. Слайды, текст, изображения и другие объекты |
| Схемы Visio | phpoffice/phpvisio | Работа со схемами Visio. Поддержку VSDX и нужных объектов следует проверить на файле проекта |
| Планы и диаграммы Ганта | phpoffice/phpproject | Обмен проектными данными через Microsoft Project XML и GanttProject в пределах возможностей пакета |
Если задача сводится к выгрузке строк и столбцов в CSV, обычно достаточно fputcsv(). Для нескольких листов, дат в формате Excel, формул и оформления ячеек выбирайте XLSX. Если пользователю нужен PDF, запланируйте отдельную проверку разметки. Экспорт через офисную библиотеку и преобразование готового файла офисным движком могут давать разный результат.
Установка через Composer на PHP 8.3–8.5
Установите пакеты для нужных форматов. Ниже подключены три библиотеки для примеров. В каждом скрипте предполагается, что файл лежит в корне Composer-проекта.
composer require phpoffice/phpspreadsheet phpoffice/phpword phpoffice/phppresentation
composer check-platform-reqsСовместимость определяется версиями в composer.lock и расширениями PHP в окружении, где выполняется код. Проверьте требования платформы в контейнере приложения и отдельно в воркере, если документы собирает очередь. Для проекта, который поддерживает PHP 8.3–8.5, прогоняйте тесты на каждой поддерживаемой версии.
В старых проектах для Excel встречается PHPExcel. При переходе на PhpSpreadsheet обновите пространства имён и вызовы API, затем сравните результаты на реальных файлах. В первую очередь проверьте даты, формулы, объединённые ячейки и идентификаторы с ведущими нулями.
PhpSpreadsheet: создать отчёт XLSX
Строки можно записать через fromArray(), а отдельные ячейки — через setCellValue() или setCellValueExplicit(). Явный тип нужен там, где Excel должен сохранить исходное представление значения. В примере артикул остаётся строкой 00042, количество и цена записываются числами, а итог считается по формуле.
<?php
declare(strict_types=1);
use PhpOffice\PhpSpreadsheet\Cell\DataType;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
require __DIR__ . '/vendor/autoload.php';
$book = new Spreadsheet();
$sheet = $book->getActiveSheet();
$sheet->setTitle('Продажи');
$sheet->fromArray([['Артикул', 'Количество', 'Цена', 'Сумма']], null, 'A1');
$sheet->getStyle('A1:D1')->getFont()->setBold(true);
$sheet->freezePane('A2');
// Храним артикул как текст, чтобы сохранить ведущие нули.
$sheet->setCellValueExplicit('A2', '00042', DataType::TYPE_STRING);
$sheet->setCellValue('B2', 3);
$sheet->setCellValue('C2', 1290.50);
$sheet->setCellValue('D2', '=B2*C2');
$sheet->getStyle('C2:D2')->getNumberFormat()->setFormatCode('#,##0.00');
(new Xlsx($book))->save(__DIR__ . '/sales.xlsx');Формат числа задаёт отображение. В ячейке с ценой остаётся число, поэтому по столбцу можно считать суммы и строить сводные таблицы. Даты Excel хранятся как числовые значения. Для записи объекта DateTimeInterface используйте Shared\Date::PHPToExcel() и назначьте ячейке формат даты.
Тип строки также важен для текста, который поступает извне. В XLSX задавайте DataType::TYPE_STRING для полей вроде имени, комментария и номера заказа. Так значение, начинающееся с =, останется текстом. В CSV типов ячеек нет, поэтому при открытии файла тип определяет табличный редактор. Для CSV с пользовательским текстом отдельно проверьте, как целевой редактор обрабатывает значения, похожие на формулы.
Как читать Excel и ограничить расход памяти
Если форма принимает только XLSX, используйте Reader\Xlsx. Для нескольких разрешённых форматов подбирайте reader через IOFactory с ограниченным списком типов. Задайте лимит на размер загрузки и обрабатывайте ошибки чтения. XLSX содержит сжатые данные, поэтому размер загруженного файла даёт лишь приблизительное представление об объёме работы.
<?php
declare(strict_types=1);
use PhpOffice\PhpSpreadsheet\Reader\Xlsx;
require __DIR__ . '/vendor/autoload.php';
$reader = new Xlsx();
$reader->setLoadSheetsOnly('Продажи');
$book = $reader->load(__DIR__ . '/sales.xlsx');
$sheet = $book->getActiveSheet();
// Число берём из ячейки, а формулу читаем как выражение.
$quantity = $sheet->getCell('B2')->getValue();
$formula = $sheet->getCell('D2')->getValue();
printf("Количество: %s, формула: %s\n", $quantity, $formula);
$book->disconnectWorksheets();getValue()возвращает исходное значение, в том числе текст формулы.getCalculatedValue()запрашивает результат вычисления. Проверьте нужные функции и внешние ссылки на типовой книге, если от результата зависит импорт.setReadDataOnly(true)подходит для импорта, которому не нужны стили. Если нужно отличить дату Excel от обычного числа по формату ячейки, сохраните чтение форматирования.- Для крупных книг ограничивайте загрузку нужными листами и диапазонами через фильтр чтения.
toArray()для всего листа создаёт дополнительный массив в памяти. Если нужны только конкретные строки, обрабатывайте их по мере обхода. - Для очень больших плоских таблиц рассмотрите потоковое чтение, если импорт обходится без форматирования и вычисления формул. CSV можно обрабатывать построчно через
fgetcsv().
PHPWord: заполнить договор по шаблону DOCX
Для документов с утверждённой вёрсткой подготовьте DOCX с полями ${client} и ${total}. Тогда текст и оформление можно обновлять в шаблоне, а PHP-код будет передавать данные. Если состав документа зависит от данных, используйте возможности PHPWord для генерации разделов, абзацев и таблиц.
<?php
declare(strict_types=1);
use PhpOffice\PhpWord\Settings;
use PhpOffice\PhpWord\TemplateProcessor;
require __DIR__ . '/vendor/autoload.php';
// Включаем экранирование символов, значимых для XML внутри DOCX.
Settings::setOutputEscapingEnabled(true);
$template = new TemplateProcessor(__DIR__ . '/contract-template.docx');
$template->setValue('client', 'ООО «Альфа & Партнёры»');
$template->setValue('total', number_format(3871.50, 2, ',', ' ') . ' руб.');
$template->saveAs(__DIR__ . '/contract.docx');Для переменного количества позиций создайте строку таблицы с полями и размножайте её через cloneRowAndSetValues(). Оставляйте одинаковое форматирование внутри каждого поля шаблона. Обычные подстановки через setValue() используйте для однострочных значений. Для длинного текста, изображений и форматированных фрагментов подберите соответствующие методы и проверьте переносы страниц в целевом редакторе.
PowerPoint, Visio и Microsoft Project
PHPPresentation подходит для презентаций с повторяемой структурой. Создайте объект PhpPresentation, возьмите начальный слайд через getActiveSlide() и добавьте текстовую область через createRichTextShape(). Для записи PPTX используйте IOFactory::createWriter($presentation, 'PowerPoint2007'). Укажите координаты и размеры объектов и проверьте, как в эти области помещаются длинные заголовки и подписи.
Для Visio сначала соберите небольшой файл с нужными фигурами, соединителями и подписями. Для Project проверьте импорт XML с иерархией задач, зависимостями и календарями. Успешное открытие файла подтверждает, что редактор его прочитал. Сохранность нужных свойств проверяйте после открытия или повторного сохранения в приложении, которым будет пользоваться получатель.
Чек-лист перед выпуском
- Выберите формат по задаче получателя. XLSX подходит для расчётов, DOCX для редактируемых документов, PPTX для слайдов, CSV для обмена плоскими данными.
- Зафиксируйте зависимости в
composer.lockи проверьте их на версии PHP и расширениях рабочего окружения. - Разведите типы данных. Коды, телефоны и идентификаторы сохраняйте строками, суммы и количества — числами. Задавайте формат отображения дат и валют отдельно.
- Проверьте пустые поля, длинный текст, кириллицу, специальные символы, формулы и верхнюю границу размера файла.
- Откройте готовые документы в целевом редакторе. Проверьте расчёты, переносы страниц и слайды. Для фоновой генерации измерьте время выполнения и пиковое потребление памяти на типовом большом файле.
Частые вопросы
Нужен ли Microsoft Office на сервере для PHPOffice?
Для чтения и генерации поддерживаемых форматов средствами PHPOffice достаточно PHP, Composer-зависимостей и нужных расширений. Если для преобразования готового документа в PDF выбран внешний офисный движок, его устанавливают отдельно.
Чем заменить PHPExcel в современном PHP-проекте?
Используйте PhpSpreadsheet. Обновите пространства имён и вызовы методов, затем сравните результаты импорта и экспорта на рабочих файлах, особенно если они содержат даты, формулы и текстовые идентификаторы.
Можно ли защитить ячейки Excel через PhpSpreadsheet?
Да. Можно задать, какие ячейки разрешено редактировать при включённой защите листа. Для конфиденциальных данных нужен отдельный механизм шифрования файла или контроля доступа.