PHPTime

PHPOffice в PHP: Excel, Word и PowerPoint на практике

PHPOffice — семейство PHP-библиотек для чтения и генерации офисных файлов на сервере. С его помощью можно собрать отчёт Excel, заполнить договор по шаблону Word и сформировать презентацию из данных приложения. Для каждой задачи нужен свой Composer-пакет.

Какую библиотеку PHPOffice выбрать

У PHPOffice несколько самостоятельных пакетов. Формат файла определяет, какой пакет подключать, а конкретная операция — чтение, генерация или заполнение шаблона — определяет, какую часть его API использовать.

ЗадачаПакетФорматы и возможности
Таблицы Excel и обмен даннымиphpoffice/phpspreadsheetXLSX, XLS, ODS, CSV. Чтение таблиц, формулы, стили, несколько листов
Договоры, письма, актыphpoffice/phpwordDOCX и другие форматы, включая ODT и RTF. Набор операций зависит от формата. Для заполнения шаблонов используют DOCX
Презентацииphpoffice/phppresentationPPTX и ODP. Слайды, текст, изображения и другие объекты
Схемы Visiophpoffice/phpvisioРабота со схемами Visio. Поддержку VSDX и нужных объектов следует проверить на файле проекта
Планы и диаграммы Гантаphpoffice/phpprojectОбмен проектными данными через Microsoft Project XML и GanttProject в пределах возможностей пакета

Если задача сводится к выгрузке строк и столбцов в CSV, обычно достаточно fputcsv(). Для нескольких листов, дат в формате Excel, формул и оформления ячеек выбирайте XLSX. Если пользователю нужен PDF, запланируйте отдельную проверку разметки. Экспорт через офисную библиотеку и преобразование готового файла офисным движком могут давать разный результат.

Установка через Composer на PHP 8.3–8.5

Установите пакеты для нужных форматов. Ниже подключены три библиотеки для примеров. В каждом скрипте предполагается, что файл лежит в корне Composer-проекта.

Shell
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
<?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
<?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
<?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 с иерархией задач, зависимостями и календарями. Успешное открытие файла подтверждает, что редактор его прочитал. Сохранность нужных свойств проверяйте после открытия или повторного сохранения в приложении, которым будет пользоваться получатель.

Чек-лист перед выпуском

  1. Выберите формат по задаче получателя. XLSX подходит для расчётов, DOCX для редактируемых документов, PPTX для слайдов, CSV для обмена плоскими данными.
  2. Зафиксируйте зависимости в composer.lock и проверьте их на версии PHP и расширениях рабочего окружения.
  3. Разведите типы данных. Коды, телефоны и идентификаторы сохраняйте строками, суммы и количества — числами. Задавайте формат отображения дат и валют отдельно.
  4. Проверьте пустые поля, длинный текст, кириллицу, специальные символы, формулы и верхнюю границу размера файла.
  5. Откройте готовые документы в целевом редакторе. Проверьте расчёты, переносы страниц и слайды. Для фоновой генерации измерьте время выполнения и пиковое потребление памяти на типовом большом файле.

Частые вопросы

Нужен ли Microsoft Office на сервере для PHPOffice?

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

Чем заменить PHPExcel в современном PHP-проекте?

Используйте PhpSpreadsheet. Обновите пространства имён и вызовы методов, затем сравните результаты импорта и экспорта на рабочих файлах, особенно если они содержат даты, формулы и текстовые идентификаторы.

Можно ли защитить ячейки Excel через PhpSpreadsheet?

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

Справка по теме

Ещё в разделе «Инструменты и библиотеки»

Push-уведомления в Chrome и Safari: настройка Web Push на PHP

Как настроить Web Push в Chrome и Safari на PHP 8.3–8.5: запросить разрешение, сохранить подписку, отправить уведомление и обработать ошибки доставки.

8 мин

Не работает GitHub: как настроить прокси для Git и Composer

Что делать, если GitHub не открывается, git clone зависает, а Composer не скачивает пакеты. Настройка HTTP-прокси, SSH ProxyCommand и зеркала Packagist.

7 мин

Какой PHP-фреймворк выбрать для среднего проекта в 2026 году

Сравниваем Laravel, Symfony, Yii 2, Yii 3 и Slim для среднего PHP-проекта: база данных, очереди, тесты, обновления и выбор под задачи команды.

6 мин

Jeapie и массовые мобильные push-уведомления в PHP

Как устроены рассылки Jeapie и как реализовать мобильные push-уведомления в PHP и Yii: подписки, выбор аудитории, очередь, повторы и отчёт по отправке.

6 мин