# dev.avadim.ru

> Блог и документация библиотек FastExcelPHP для работы с Excel в PHP: чтение файлов, создание XLSX, генерация по шаблонам и интеграция с Laravel.

Русская витрина: https://dev.avadim.ru. Разделы ниже относятся к указанным версиям каждой библиотеки. Проверяйте версию установленного пакета перед использованием примеров API: статьи блога могут описывать другие выпуски.

Ссылки на руководства и справочники ведут на исходный Markdown, зафиксированный по полному SHA коммита. Материалы без русского перевода помечены «EN».

## Навигация

- [Документация всех библиотек](https://dev.avadim.ru/docs): Каталог библиотек и актуальных версий.
- [Статьи блога](https://dev.avadim.ru/): Практические примеры и разборы задач.

## FastExcelReader 4.5.0

- [Документация на сайте](https://dev.avadim.ru/docs/reader/4.5.0): Чтение XLSX, XLS и CSV. Импорт данных, стили и метаданные.
- [FastExcelReader](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/README.ru.md): FastExcelReader — часть проекта FastExcelPhp, в который входят
- [Начало работы](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/ru/10-getting-started.md): Начиная с 4.5, используйте явную фабрику, если формат или уровень API известен:
- [Чтение данных](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/ru/11-reading-data.md): ПРИМЕЧАНИЕ: каждый раз, когда вы запускаете цикл foreach ($sheet->nextRow() as $rowIndex => $row), чтение данных начинается с первой строки.
- [Продвинутое чтение](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/ru/12-advanced-reading.md): Область чтения можно задать по именованным диапазонам в файле. Например, если в файле есть именованный диапазон Headers со ссылкой Demo1!$B$4:$D$4, то можно читать ячейки по этому имени
- [Типы значений ячеек и форматирование дат](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/ru/13-dates-and-types.md): По умолчанию все значения даты-времени возвращаются как timestamp. Но это поведение можно изменить с помощью dateFormatter()
- [Стили ячеек](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/ru/14-cell-styles.md): Обычно функции чтения возвращают только значения ячеек, но можно читать значения вместе со стилями. В этом случае для каждой ячейки будет возвращено не скалярное значение, а массив вида ['v'
- [Изображения](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/ru/15-images.md): Библиотека умеет находить и извлекать изображения из XLSX-файлов.
- [Метаданные листа](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/ru/16-sheet-metadata.md): Каждый лист в вашем XLSX-файле может содержать набор правил проверки данных (data validation). Чтобы получить их, достаточно вызвать getDataValidations у листа
- [Разбор CSV в FastExcelReader](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/ru/20-csv.md): Быстрый и эффективный CSV-ридер для PHP, встроенный в пакет fast-excel-reader. Он поддерживает различные кодировки, автоопределение разделителя и обработку больших файлов.
- [Чтение XLS (Excel 97-2003) в FastExcelReader](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/ru/21-xls.md): FastExcelReader читает устаревшие файлы .xls (BIFF8, формат Excel 97-2003) тем же API, что и XLSX. Значения, даты, стили ячеек, текст формул и изображения возвращаются в точно такой же форме
- [FastExcelReader - API Reference (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/90-api-reference.md)
- [Class \\avadim\\FastExcelReader\\Excel (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/91-api-class-excel.md): Converts an alphabetic column index to a numeric
- [Class \\avadim\\FastExcelReader\\Sheet (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/92-api-class-sheet.md): Get the actual dimension range (e.g. "A1:C10")
- [Class \\avadim\\FastExcelReader\\Csv\\CsvReader (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/94-api-class-csv-reader.md): Get line from CSV file as array of fields (null - empty field, false - EOF)
- [Class \\avadim\\FastExcelReader\\Csv\\CsvOptions (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-reader/dd0d48d35e0fb41983043ed0ccfffa6de5ddfa07/docs/95-api-class-csv-options.md): Allow binary input instead of rejecting it

## FastExcelWriter 6.19.2

- [Документация на сайте](https://dev.avadim.ru/docs/writer/6.19.2): Создание XLSX: данные, оформление, формулы и диаграммы.
- [FastExcelWriter](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/index.md): Лёгкая, мощная и очень быстрая библиотека для создания XLSX-таблиц на чистом PHP. Библиотека спроектирована так, чтобы работать максимально быстро и потреблять минимум памяти.
- [FastExcelWriter – Книга (Workbook)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/01-workbook.md): Вместо массива опций в Excel::create() можно передать экземпляр класса Options — у него есть fluent-интерфейс
- [FastExcelWriter – Листы (Sheets)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/02-sheets.md): Параметры строки (стили и высоту) можно задать вторым аргументом функции writeRow(). Обратите внимание, что в этом случае стили будут применены только к тем ячейкам строки, в которые записан
- [FastExcelWriter – Запись данных](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/03-writing.md): writeIterable(iterable $rows, ?array $rowStyle = null) принимает массивы, генераторы и объекты Traversable. Строки обрабатываются один раз в порядке обхода; ключи итератора игнорируются. Мет
- [FastExcelWriter – Стили](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/04-styles.md): Стили можно задавать для всей книги, для листов, для отдельных ячеек, а также для строк и колонок. Итоговый стиль каждой ячейки определяется комбинацией всех этих стилей.
- [FastExcelWriter – Диаграммы (с v.5.0)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/05-charts.md): В генерируемые таблицы можно вставлять диаграммы (примеры использования ниже и в папке /demo)
- [FastExcelWriter – Защита](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/06-protection.md): В таблицах Excel есть три уровня защиты данных:
- [FastExcelWriter – Проверка данных (с v.6.0)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/07-validation.md): Проверка данных (data validation) позволяет установить входной фильтр на данные, которые можно ввести в конкретную ячейку. Библиотека позволяет задать следующие типы фильтров:
- [FastExcelWriter – Условное форматирование (с v.6.4)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/08-conditional.md): Условное форматирование позволяет задавать параметры форматирования в зависимости от значения ячейки. Его можно применять как к отдельным ячейкам, так и к диапазонам ячеек.
- [FastExcelWriter – Руководство по обновлению](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/09-upgrade.md): На этой странице описаны важные изменения между основными версиями, которые могут потребовать обновления вашего кода.
- [FastExcelWriter - Справочник API](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/ru/90-api-reference.md): Страницы справочника API генерируются автоматически и доступны только на английском языке.
- [Class \\avadim\\FastExcelWriter\\Excel (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/91-api-class-excel.md): Create cell address by row and col numbers
- [Class \\avadim\\FastExcelWriter\\Options (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/91-api-class-options.md)
- [Class \\avadim\\FastExcelWriter\\Sheet (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/92-api-class-sheet.md): Add a chart object to the specified range of cells
- [Class \\avadim\\FastExcelWriter\\RichText\\RichText (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/93-api-class-rich-text.md): Set bold font for the last added fragment
- [Class \\avadim\\FastExcelWriter\\RichText\\RichTextFragment (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/93-api-class-rich-text-fragment.md)
- [Class \\avadim\\FastExcelWriter\\Charts\\Chart (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/94-api-class-chart.md): Add data series of specific type (used for combo charts)
- [Class \\avadim\\FastExcelWriter\\DataValidation\\DataValidation (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/95-api-class-data-validation.md): Make data validation as an expression (alias of self::custom())
- [Class \\avadim\\FastExcelWriter\\Conditional\\Conditional (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/96-api-class-conditional.md): Applies a style if the cell value starts with the specified text
- [Class \\avadim\\FastExcelWriter\\Style\\ImageStyle (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/97-api-class-image-style.md): Set offset in pixels relative to the left and top borders of the cell
- [Class \\avadim\\FastExcelWriter\\Style\\Style (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-writer/060868443b47f979a9f16564849eed0fcba2d7ef/docs/97-api-class-style.md): Center content by horizontal and vertical

## FastExcelTemplator 3.4.0

- [Документация на сайте](https://dev.avadim.ru/docs/templator/3.4.0): Генерация документов по готовым XLSX-шаблонам.
- [FastExcelTemplator](https://raw.githubusercontent.com/aVadim483/fast-excel-templator/4de0b134d9bd479eac7a7c0d7a17b113ba5c2cc2/README.ru.md): FastExcelTemplator — часть проекта FastExcelPhp, в который входят
- [Перенос возможностей XLSX](https://raw.githubusercontent.com/aVadim483/fast-excel-templator/4de0b134d9bd479eac7a7c0d7a17b113ba5c2cc2/XLSX_SUPPORT.ru.md): Поддерживается XLSX с пространством имён SpreadsheetML Transitional. Библиотека копирует архив шаблона, генерирует данные листов и переносит метаданные отдельным потоковым проходом. В памяти
- [FastExcelTemplator - API Reference (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-templator/4de0b134d9bd479eac7a7c0d7a17b113ba5c2cc2/docs/90-api-reference.md)
- [Class \\avadim\\FastExcelTemplator\\Excel (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-templator/4de0b134d9bd479eac7a7c0d7a17b113ba5c2cc2/docs/91-api-class-excel.md): Converts an alphabetic column index to a numeric
- [Class \\avadim\\FastExcelTemplator\\SheetTemplate (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-templator/4de0b134d9bd479eac7a7c0d7a17b113ba5c2cc2/docs/92-api-class-sheet-template.md): Get the actual dimension range (e.g. "A1:C10")Note: scans every cell of the sheet (see countActualDimension()); expensive on wide sheets.
- [Class \\avadim\\FastExcelTemplator\\RowTemplate (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-templator/4de0b134d9bd479eac7a7c0d7a17b113ba5c2cc2/docs/93-api-class-row-template.md): Append a source cell to the end of the row
- [Class \\avadim\\FastExcelTemplator\\RowTemplateCollection (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-templator/4de0b134d9bd479eac7a7c0d7a17b113ba5c2cc2/docs/94-api-class-row-template-collection.md): Clone cell in all row templates of the collection

## FastExcelLaravel 4.3.0

- [Документация на сайте](https://dev.avadim.ru/docs/laravel/4.3.0): Импорт и экспорт Excel в приложениях Laravel.
- [FastExcelLaravel](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/README.ru.md): Лёгкая и очень быстрая библиотека чтения/записи XLSX-файлов Excel для Laravel на чистом PHP (обёртка над FastExcelWriter и FastExcelReader)
- [Reading legacy XLS files (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/docs/80-reading-xls.md): Since the reader dependency avadim/fast-excel-reader ^4.0, this package reads the legacy binary XLS format (Excel 97-2003, BIFF8) in addition to XLSX.
- [Reading CSV files (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/docs/81-reading-csv.md): Since the reader dependency avadim/fast-excel-reader ^4.3, this package reads CSV files in addition to XLSX and legacy XLS.
- [Reading from a string or a stream (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/docs/82-reading-from-memory.md): A workbook does not have to be a file on the local disk. Besides \Excel::open() the package provides two more entry points for import:
- [FastExcelLaravel - API Reference (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/docs/90-api-reference.md): These API pages are maintained by hand. There is no doc generator in the project — when a public method of a class changes, update the corresponding page manually. (The reader wrapper classe
- [Class \\avadim\\FastExcelLaravel\\Excel (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/docs/91-api-class-excel.md): Open an existing workbook (XLSX or legacy XLS) for import. The format is detected automatically from the file signature, so the file extension does not matter.
- [Class \\avadim\\FastExcelLaravel\\ExcelWriter (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/docs/92-api-class-excelwriter.md): Create cell address by row and col numbers
- [Class \\avadim\\FastExcelLaravel\\SheetWriter (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/docs/93-api-class-sheetwriter.md): Add a chart object to the specified range of cells
- [Class \\avadim\\FastExcelLaravel\\ExcelReader (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/docs/94-api-class-excelreader.md): ExcelReader is a thin Laravel wrapper around a FastExcelReader book. It does not extend a concrete reader; instead it composes an avadim\FastExcelReader\AbstractBook and adds the Eloquent-aw
- [Class \\avadim\\FastExcelLaravel\\SheetReader (EN)](https://raw.githubusercontent.com/aVadim483/fast-excel-laravel/2d73434bbea3cbb6c6195bc3c704a768964b239e/docs/95-api-class-sheetreader.md): SheetReader is a thin Laravel wrapper around a FastExcelReader sheet. It does not extend a concrete sheet; instead it composes an avadim\FastExcelReader\AbstractSheet and adds the Eloquent-a

## Optional

- [Публичный API статей](https://dev.avadim.ru/api/posts): JSON, только опубликованные и доступные по времени статьи, с пагинацией.
- [RSS](https://dev.avadim.ru/feed): Последние опубликованные статьи.
- [Карта сайта](https://dev.avadim.ru/sitemap.xml): Публичные страницы сайта.
- [English](https://fast-excel-php.com/llms.txt): Английская витрина документации и блога.