Yii2 выгрузка в excel

Yii2 PHP Excel ¶

1. Property
2. Installation
3. Usage
4. TODO

Exporting PHP to Excel or Importing Excel to PHP.
Excel Widget for generate Excel File or for load Excel File.

Property ¶

string $mode is an export mode or import mode. valid value are ‘export’ and ‘import’

boolean $isMultipleSheet for set the export excel with multiple sheet.

array $properties for set property on the excel object.

array $models Model object or DataProvider object with much data.

array $columns to get the attributes from the model, this valid value only the exist attribute on the model. If this is not set, then all attribute of the model will be set as columns.

array $headers to set the header column on first line. Set this if want to custom header. If not set, the header will get attributes label of model attributes.

string|array $fileName is a name for file name to export or import. Multiple file name only use for import mode, not work if you use the export mode.

string $savePath is a directory to save the file or you can blank this to set the file as attachment.

string $format for excel to export. Valid value are ‘Excel5’, ‘Excel2007’, ‘Excel2003XML’, ’00Calc’, ‘Gnumeric’.

boolean $setFirstTitle to set the title column on the first line. The columns will have a header on the first line.

boolean $asAttachment to set the file excel to download mode.

boolean $setFirstRecordAsKeys to set the first record on excel file to a keys of array per line. If you want to set the keys of record column with first record, if it not set, the header with use the alphabet column on excel.

boolean $setIndexSheetByName to set the sheet index by sheet name or array result if the sheet not only one

string $getOnlySheet is a sheet name to getting the data. This is only get the sheet with same name.

array|Formatter $formatter the formatter used to format model attribute values into displayable texts. This can be either an instance of Formatter or an configuration array for creating the Formatter instance. If this property is not set, the «formatter» application component will be used.

Installation ¶

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist moonlandsoft/yii2-phpexcel "*"

or add

"moonlandsoft/yii2-phpexcel": "*"

to the require section of your composer.json file.

Usage ¶

Exporting Data ¶

Exporting data into an excel file.

<?php

// export data only one worksheet.

moonlandphpexcelExcel::widget([
	'models' => $allModels,
	'mode' => 'export', //default value as 'export'
	'columns' => ['column1','column2','column3'], //without header working, because the header will be get label from attribute label. 
	'header' => ['column1' => 'Header Column 1','column2' => 'Header Column 2', 'column3' => 'Header Column 3'], 
]);

moonlandphpexcelExcel::export([
	'models' => $allModels, 
	'columns' => ['column1','column2','column3'], //without header working, because the header will be get label from attribute label. 
	'header' => ['column1' => 'Header Column 1','column2' => 'Header Column 2', 'column3' => 'Header Column 3'],
]);

// export data with multiple worksheet.

moonlandphpexcelExcel::widget([
	'isMultipleSheet' => true, 
	'models' => [
		'sheet1' => $allModels1, 
		'sheet2' => $allModels2, 
		'sheet3' => $allModels3
	], 
	'mode' => 'export', //default value as 'export' 
	'columns' => [
		'sheet1' => ['column1','column2','column3'], 
		'sheet2' => ['column1','column2','column3'], 
		'sheet3' => ['column1','column2','column3']
	],
	//without header working, because the header will be get label from attribute label. 
	'header' => [
		'sheet1' => ['column1' => 'Header Column 1','column2' => 'Header Column 2', 'column3' => 'Header Column 3'], 
		'sheet2' => ['column1' => 'Header Column 1','column2' => 'Header Column 2', 'column3' => 'Header Column 3'], 
		'sheet3' => ['column1' => 'Header Column 1','column2' => 'Header Column 2', 'column3' => 'Header Column 3']
	],
]);

moonlandphpexcelExcel::export([
	'isMultipleSheet' => true, 
	'models' => [
		'sheet1' => $allModels1, 
		'sheet2' => $allModels2, 
		'sheet3' => $allModels3
	], 'columns' => [
		'sheet1' => ['column1','column2','column3'], 
		'sheet2' => ['column1','column2','column3'], 
		'sheet3' => ['column1','column2','column3']
	], 
	//without header working, because the header will be get label from attribute label. 
	'header' => [
		'sheet1' => ['column1' => 'Header Column 1','column2' => 'Header Column 2', 'column3' => 'Header Column 3'],
		'sheet2' => ['column1' => 'Header Column 1','column2' => 'Header Column 2', 'column3' => 'Header Column 3'],
		'sheet3' => ['column1' => 'Header Column 1','column2' => 'Header Column 2', 'column3' => 'Header Column 3']
	],
]);

New Feature for exporting data, you can use this if you familiar yii gridview.
That is same with gridview data column.
Columns in array mode valid params are ‘attribute’, ‘header’, ‘format’, ‘value’, and footer (TODO).
Columns in string mode valid layout are ‘attribute:format:header:footer(TODO)’.

<?php
  
moonlandphpexcelExcel::export([
   	'models' => Post::find()->all(),
      	'columns' => [
      		'author.name:text:Author Name',
      		[
      				'attribute' => 'content',
      				'header' => 'Content Post',
      				'format' => 'text',
      				'value' => function($model) {
      					return ExampleClass::removeText('example', $model->content);
      				},
      		],
      		'like_it:text:Reader like this content',
      		'created_at:datetime',
      		[
      				'attribute' => 'updated_at',
      				'format' => 'date',
      		],
      	],
      	'headers' => [
     		'created_at' => 'Date Created Content',
		],
]);

Importing Data ¶

Import file excel and return into an array.

<?php

$data = moonlandphpexcelExcel::import($fileName, $config); // $config is an optional

$data = moonlandphpexcelExcel::widget([
		'mode' => 'import', 
		'fileName' => $fileName, 
		'setFirstRecordAsKeys' => true, // if you want to set the keys of record column with first record, if it not set, the header with use the alphabet column on excel. 
		'setIndexSheetByName' => true, // set this if your excel data with multiple worksheet, the index of array will be set with the sheet name. If this not set, the index will use numeric. 
		'getOnlySheet' => 'sheet1', // you can set this property if you want to get the specified sheet from the excel data with multiple worksheet.
	]);

$data = moonlandphpexcelExcel::import($fileName, [
		'setFirstRecordAsKeys' => true, // if you want to set the keys of record column with first record, if it not set, the header with use the alphabet column on excel. 
		'setIndexSheetByName' => true, // set this if your excel data with multiple worksheet, the index of array will be set with the sheet name. If this not set, the index will use numeric. 
		'getOnlySheet' => 'sheet1', // you can set this property if you want to get the specified sheet from the excel data with multiple worksheet.
	]);

// import data with multiple file.

$data = moonlandphpexcelExcel::widget([
	'mode' => 'import', 
	'fileName' => [
		'file1' => $fileName1, 
		'file2' => $fileName2, 
		'file3' => $fileName3,
	], 
		'setFirstRecordAsKeys' => true, // if you want to set the keys of record column with first record, if it not set, the header with use the alphabet column on excel. 
		'setIndexSheetByName' => true, // set this if your excel data with multiple worksheet, the index of array will be set with the sheet name. If this not set, the index will use numeric. 
		'getOnlySheet' => 'sheet1', // you can set this property if you want to get the specified sheet from the excel data with multiple worksheet.
	]);

$data = moonlandphpexcelExcel::import([
	'file1' => $fileName1, 
	'file2' => $fileName2, 
	'file3' => $fileName3,
	], [
		'setFirstRecordAsKeys' => true, // if you want to set the keys of record column with first record, if it not set, the header with use the alphabet column on excel. 
		'setIndexSheetByName' => true, // set this if your excel data with multiple worksheet, the index of array will be set with the sheet name. If this not set, the index will use numeric. 
		'getOnlySheet' => 'sheet1', // you can set this property if you want to get the specified sheet from the excel data with multiple worksheet.
	]);

Result example from the code on the top :

// only one sheet or specified sheet.
Array([0] => Array([name] => Anam, [email] => moh.khoirul.anaam@gmail.com, [framework interest] => Yii2), [1] => Array([name] => Example, [email] => example@moonlandsoft.com, [framework interest] => Yii2));

// data with multiple worksheet
Array([Sheet1] => Array([0] => Array([name] => Anam, [email] => moh.khoirul.anaam@gmail.com, [framework interest] => Yii2), [1] => Array([name] => Example, [email] => example@moonlandsoft.com, [framework interest] => Yii2)), [Sheet2] => Array([0] => Array([name] => Anam, [email] => moh.khoirul.anaam@gmail.com, [framework interest] => Yii2), [1] => Array([name] => Example, [email] => example@moonlandsoft.com, [framework interest] => Yii2)));

// data with multiple file and specified sheet or only one worksheet
Array([file1] => Array([0] => Array([name] => Anam, [email] => moh.khoirul.anaam@gmail.com, [framework interest] => Yii2), [1] => Array([name] => Example, [email] => example@moonlandsoft.com, [framework interest] => Yii2)), [file2] => Array([0] => Array([name] => Anam, [email] => moh.khoirul.anaam@gmail.com, [framework interest] => Yii2), [1] => Array([name] => Example, [email] => example@moonlandsoft.com, [framework interest] => Yii2)));

// data with multiple file and multiple worksheet
Array([file1] => Array([Sheet1] => Array([0] => Array([name] => Anam, [email] => moh.khoirul.anaam@gmail.com, [framework interest] => Yii2), [1] => Array([name] => Example, [email] => example@moonlandsoft.com, [framework interest] => Yii2)), [Sheet2] => Array([0] => Array([name] => Anam, [email] => moh.khoirul.anaam@gmail.com, [framework interest] => Yii2), [1] => Array([name] => Example, [email] => example@moonlandsoft.com, [framework interest] => Yii2))), [file2] => Array([Sheet1] => Array([0] => Array([name] => Anam, [email] => moh.khoirul.anaam@gmail.com, [framework interest] => Yii2), [1] => Array([name] => Example, [email] => example@moonlandsoft.com, [framework interest] => Yii2)), [Sheet2] => Array([0] => Array([name] => Anam, [email] => moh.khoirul.anaam@gmail.com, [framework interest] => Yii2), [1] => Array([name] => Example, [email] => example@moonlandsoft.com, [framework interest] => Yii2))));

TODO ¶

• Adding footer params for columns in exporting data.

$title = 'Consumers Report';
$model = new Review();

$objPHPExcel = new PhpOfficePhpSpreadsheetSpreadsheet();
$sheet=0;

$objPHPExcel->setActiveSheetIndex($sheet);

$objPHPExcel->getActiveSheet()->getColumnDimension('A')->setWidth(20);
$objPHPExcel->getActiveSheet()->getColumnDimension('B')->setWidth(20);
$objPHPExcel->getActiveSheet()->setTitle($title);

$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(0, 1, $model->getAttributeLabel('name'));
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(1, 1, $model->getAttributeLabel('mobile'));
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(2, 1, $model->getAttributeLabel('email'));
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(3, 1, $model->getAttributeLabel('email_verified'));
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(4, 1, $model->getAttributeLabel('status'));
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(5, 1, $model->getAttributeLabel('previously_ordered'));
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(6, 1, $model->getAttributeLabel('created_at'));

foreach ($data->getModels() as $dk => $dv){
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(0, $dk+2, $dv->name);
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(1, $dk+2, $dv->mobile);
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(2, $dk+2, $dv->email);
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(3, $dk+2, $dv->email_verified?"Yes":"No");
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(4, $dk+2, Consumer::$statuses[$dv->status]);
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(5, $dk+2, $dv->getPreviouslyOrdered()?"Yes":"No");
$objPHPExcel->getActiveSheet()->setCellValueByColumnAndRow(5, $dk+2, date(Yii::$app->params['dateFormat'].' '.Yii::$app->params['timeFormat'], $dv->created_at));
}

header('Content-Type: application/vnd.ms-excel');
$filename = $title.".xls";
header('Content-Disposition: attachment;filename='.$filename .' ');
header('Cache-Control: max-age=0');
$objWriter = PhpOfficePhpSpreadsheetIOFactory::createWriter($objPHPExcel, 'Xls');
$objWriter->save('php://output');
die();

Время на прочтение
3 мин

Количество просмотров 13K

Начало

Одна поддерживаемая нашей компанией учетно-отчетная система начала очень быстро разрастаться в количестве хранимых данных. Система написана на PHP с использованием фреймворка Yii2. Изначально отчеты строились через библиотеку PhpSpreadsheet, которая пришла на смену, уже давно ставшему deprecated, PhpExcel.

Среди разного вида отчетности был один очень крупный – фактически полный набор всех хранящихся в БД данных должен выгружаться в одну excel-таблицу. На начальном этапе проблем не возникало, но когда объем стал превышать многие сотни тысяч записей, то скрипт формирования выгрузки стал отваливаться в timeout limit. Для начала повысили этот самый лимит и начали искать пути решения проблемы. Но врЕменного решения хватило ненадолго – проблема с лимитом времени превратилась в проблему с лимитом памяти. Серверу накинули «оперативки» и вообще сняли memory_limit для данной отдельно взятой операции. Очень скоро пользователи снова начали жаловаться на ошибки по времени выполнения. Пришлось убрать и временной лимит для полного отчета. Но сидеть и смотреть десяток минут на экран с индикатором загрузки – мало удовольствия. К тому же иногда отчет нужен был «здесь и сейчас», и каждая потраченная минута на его формирование оказывалась критичной. Эксперименты с настройками окружения прекратили, почесали затылок и приступили к оптимизации кода.

Поиск решения

Первое, что было сделано – скрипт отчетности вынесен в фоновый процесс, а пользователь наблюдает за ходом через «прогрессбар». Фоновое выполнение заданий реализовали через механизм очередей с использованием Redis для хранения. Работа в системе не останавливается, можно заниматься другими задачами и периодически возвращаться на страницу с отчетом – посмотреть, а не готов ли файл. Как только файл формируется, пользователю предлагается ссылка на скачивание. Но, как уже упоминалось выше, иногда файл требовался «немедленно», а повышение юзабилити никак не решало эту проблему. Тем временем количество данных продолжало расти и время построения файла дошло до 79 минут! Это совершенно не приемлемо, особенно учитывая, что отчетность — одна из основ функционала данной системы. Нет, все остальные части работали как часы, но эта ложка дегтя портила общее впечатление.

Первые результаты

Снова сели за анализ кода. Первое, что было протестировано – процесс выбора данных из БД. Но запросы уже были оптимизированы максимально возможным способом. Хоть самый долгий запрос и представлял собой страшную выборку с пятью-шестью обращениями к монструозному ФИАСу, но отрабатывал за 2-5 секунд. Слабым местом был не он, а формирование файла-«эксельника». Начались попытки оптимизации этого процесса. Начиная от кеширования в redis, до извращений вроде формирования отдельных небольших «эксельников» в параллельных потоках с последующим склеиванием в один файл. Но результат был всегда один: проблема со временем превращалась в проблему с памятью и наоборот. Золотой середины не было, только перетекание из крайности в крайность. После определенного количества данных потребление ресурсов библиотекой начинало расти экспоненциально и победить это не представлялось возможным. PhpSpreadsheet – не подходит для больших файлов. В итоге было принято решение сменить библиотеку. Как вариант – написание своего аналога для формирования эксель-файлов.

Анализ и выбор инструмента

Спешить с написанием велосипедов не стали, а для начала провели аналитику существующих решений. Из возможных вариантов заинтересовал только box/spout. Быстро переписали модуль с использованием этой библиотеки. В итоге, полный отчет получился за 145 секунд. Напомню, что последние тесты с PhpSpreadsheet — 79 минут, а тут 2,5 минуты! Провели тестирование: увеличили объем данных в 2 раза. Отчет сформировался за 172 секунды. Разница потрясающая. Конечно, библиотека не обладает всеми теми же функциями, что и PhpSpreadsheet, но в данном случае хватает и минимального набора инструментов, так как критичным является скорость работы.

Расширение для Yii2

Итоговое решение оформили в виде расширения для Yii2. Может быть, кому-то пригодится. Расширение позволяет выгрузить любой набор данных из GridView в excel с сохранением фильтрации и сортировки. В качестве зависимостей использует yii/queue и box/spout. Применять расширение имеет смысл для формирования действительно больших файлов, ну, хотя бы 50 000 строк =) В данный момент модуль, ставший основой для расширения, лихо справляется с нагрузкой почти в 600 000 строк.

Ссылка на github: Yii2 ExcelReport Extension

Спасибо за внимание!

spreadsheet’s People

// ...
$tmpResourceMetaData = stream_get_meta_data($tmpResource);
$tmpFileName = $tmpResourceMetaData['uri'];

$tmpFileStatistics = fstat($tmpResource);
if ($tmpFileStatistics['size'] > 0) {
    return Yii::$app->getResponse()->sendStreamAsFile($tmpResource, $attachmentName, $options);
}

fclose($tmpResource);
$writer = IOFactory::createWriter($this->getDocument(), $writerType);
$writer->save($tmpFileName);
unset($writer);
// ...

$orders = [...] // Array of 8000+ items

// item example
// 0 => [
//    "id" => "146472", "created" => "2021-06-01 17:01:28", "site", => "1", "status" => "Отменён", 
//    "address_to_delivery" => "Кропивницкий - 1", "price" => "956", "restaurant"=> "0", "delivery_datetime" => "14:33", 
//    "first_name" => "Дмитрий", "phone" => "0662784754", "start_delivery" => "Не передано курьеру" , 
//   "complited_draw_order" => "2021-06-01 17:02:30", "items_num" => "0", "pizzeria" => "К1", "marketing" => "Нет",
//    "promo" => "", "timeDelivery" => "Да"]

var_dump($orders); // This work

$dataProvider = new ArrayDataProvider([
            'allModels' => $orders,
            'pagination' => [
                'pageSize' => 100,
            ],
        ]);

$exporter = new Spreadsheet([
            'dataProvider' => $dataProvider,
            'title' => 'Orders',
            'columns' => [...],
            'batchSize' => 200,]);

return $exporter->send('Заказы с ' . $date_from . ' по '.$date_to . '.xls');

 $file = base64_decode($this->actiongetPdfFile($postData['billing_profile']));

$message->attachContent($file, ['fileName' => 'file.pdf', 'contentType' => 'data:application/pdf']);

for($i = 0; i < 4; i++ ) {
$exporter = new Spreadsheet([
    'dataProvider' => new ArrayDataProvider([
        'allModels' => [
            [
                'id' => 1,
                'name' => 'first',
            ],
            [
                'id' => 2,
                'name' => 'second',
            ],
        ],
    ]),
    'columns' => [
        [
            'class' => SerialColumn::class,
        ],
        [
            'attribute' => 'id',
        ],
        [
            'attribute' => 'name',
        ],
    ],
])->render();
//Neds some break rows here...
}

$writer = IOFactory::createWriter($this->getDocument(), $writerType);
if ($writerType=='Csv') {$writer->useBOM=true;}
$writer->save($filename);

$writer = IOFactory::createWriter($this->getDocument(), $writerType);
if ($writerType=='Csv') {$writer->excelCompatibility=true;}
$writer->save($filename);

publick function createWriter($writerType){
      return IOFactory::createWriter($this->getDocument(), $writerType);
}

attributes' => [
    [
        'label' => "One",
        'value' => 1,
    ]
]

 ['attribute' => 'released_time', 'format' => 'datetime'],

$model = [
    'data' => [
        '0.0.0' => [
            'reference_number' => 'DMG/00015/2022'
            'customer' => 'PT. Rapala Indonesia'
            'damage' => 'TEAR IN'
            'description' => 'Tingkat Oval 60% s/d 80 %'
            'files' => [
                0 => 'https://sgp1.digitaloceanspaces.com/files.online/goods/OVR3/.tmb/carbon_18_.png'
                1 => 'https://sgp1.digitaloceanspaces.com/files.online/goods/OVR3/.tmb/teahub.io-cbr250rr-wallpaper-3291320.jpeg'
            ]
        ]
        '0.0.1' => [
            'reference_number' => 'DMG/00015/2022'
            'customer' => 'PT. Rapala Indonesia'
            'damage' => 'TEAR OUT'
            'description' => 'Tingkat Oval 90% s/d 100 % R'
            'files' => [
                0 => 'https://sgp1.digitaloceanspaces.com/files.online/goods/OVR3/.tmb/WhatsApp%20Image%202021-12-22%20at%2012.22.19%20PM.jpeg'
                1 => 'https://sgp1.digitaloceanspaces.com/files.online/goods/OVR3/.tmb/carbon_13_.png'
                2 => 'https://sgp1.digitaloceanspaces.com/files.online/goods/OVR3/.tmb/carbon_14_.png'
                3 => 'https://sgp1.digitaloceanspaces.com/files.online/goods/OVR3/.tmb/Action%20Column.png'
            ]
        ]
    ]
]

    public function actionExportToExcel($id) {
        $model = DamageReport::find()->dataFormatExcel($id);
        $exporter = new Spreadsheet([
            'dataProvider' => new ArrayDataProvider([
                'allModels' =>$model['data']
            ]),
            'columns' => [
                'customer',
                'reference_number',
                'damage',
                'description',
                [
                    'attribute' => 'files',
                    'format' => 'raw',
                    'value' => function($model){
                        if($model['files']){
                            // for testing 
                            return Html::img($model['files'][0]) ;
                        }

                        return null;
                    }
                ],
            ],
        ]);
        return $exporter->send($model['reference_number'] .'.xls');
    }

'attributes' => [
    'myattrib1',  // works
    'othertable.myattrib2', // works
    [
        'attribute' => 'othertable.myattrib2', // doesn't work
        'label' => 'NewLabel',
    ]
]

$cell->setCellValueExplicit(
    'A8',
    "01513789642",
    PhpOfficePhpSpreadsheetCellDataType::TYPE_STRING
);

$cell->setDataType(
    PhpOfficePhpSpreadsheetCellDataType::TYPE_STRING
);

$exporter = new Spreadsheet([
    ///...,
    'columns' => [
        ['attribute' => 'name'], // format detected as 'raw'
        'description', // format detected as 'text'
    ],
]);
$exporter->save('/path/to/file.xls');

  /**
   * Renders sheet table body batch.
   * This method will be invoked several times, one per each model batch.
   * @param array $models batch of models.
   * @param array $keys batch of model keys.
   * @param int $modelIndex model iteration index.
   */
protected function renderBody($models, $keys, &$modelIndex) {
    foreach ($models as $index => $model) {
      $key = isset($keys[$index]) ? $keys[$index] : $index;
      $columnIndex = 'A';
      foreach ($this->columns as $column) {

       /* the class of $column variable is the yiigridSerialColumn, but your code
        assumes that class of $column is your own Column and the renderDataCell
        fills the Column->grid property */

        /* @var $column Column */ 

        $column->renderDataCell($columnIndex . $this->rowIndex, $model, $key, $modelIndex);
        $columnIndex++;
      }
      $this->rowIndex++;
      $modelIndex++;
    }
  }

Spreadsheet Data Export extension for Yii2

This extension provides ability to export data to spreadsheet, e.g. Excel, LibreOffice etc.

For license information check the LICENSE-file.

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist yii2tech/spreadsheet

or add

"yii2tech/spreadsheet": "*"

to the require section of your composer.json.

Usage

This extension provides ability to export data to a spreadsheet, e.g. Excel, LibreOffice etc.
It is powered by phpoffice/phpspreadsheet library.
Export is performed via yii2techspreadsheetSpreadsheet instance, which provides interface similar to yiigridGridView widget.

Example:

<?php

use yii2techspreadsheetSpreadsheet;
use yiidataArrayDataProvider;

$exporter = new Spreadsheet([
    'dataProvider' => new ArrayDataProvider([
        'allModels' => [
            [
                'name' => 'some name',
                'price' => '9879',
            ],
            [
                'name' => 'name 2',
                'price' => '79',
            ],
        ],
    ]),
    'columns' => [
        [
            'attribute' => 'name',
            'contentOptions' => [
                'alignment' => [
                    'horizontal' => 'center',
                    'vertical' => 'center',
                ],
            ],
        ],
        [
            'attribute' => 'price',
        ],
    ],
]);
$exporter->save('/path/to/file.xls');

Please, refer to yii2techspreadsheetColumn class for the information about column properties and configuration specifications.

While running web application you can use yii2techspreadsheetSpreadsheet::send() method to send a result file to
the browser through download dialog:

<?php

use yii2techspreadsheetSpreadsheet;
use yiidataActiveDataProvider;
use yiiwebController;

class ItemController extends Controller
{
    public function actionExport()
    {
        $exporter = new Spreadsheet([
            'dataProvider' => new ActiveDataProvider([
                'query' => Item::find(),
            ]),
        ]);
        return $exporter->send('items.xls');
    }
}

Multiple sheet files

You can create an output file with multiple worksheets (tabs). For example: you may want to export data about
equipment used in the office, keeping monitors, mouses, keyboards and so on in separated listings but in the same file.
To do so you will need to manually call yii2techspreadsheetSpreadsheet::render() method with different configuration
before creating final file. For example:

<?php

use yii2techspreadsheetSpreadsheet;
use yiidataActiveDataProvider;
use appmodelsEquipment;

$exporter = (new Spreadsheet([
    'title' => 'Monitors',
    'dataProvider' => new ActiveDataProvider([
        'query' => Equipment::find()->andWhere(['group' => 'monitor']),
    ]),
    'columns' => [
        [
            'attribute' => 'name',
        ],
        [
            'attribute' => 'price',
        ],
    ],
]))->render(); // call `render()` to create a single worksheet

$exporter->configure([ // update spreadsheet configuration
    'title' => 'Mouses',
    'dataProvider' => new ActiveDataProvider([
        'query' => Equipment::find()->andWhere(['group' => 'mouse']),
    ]),
])->render(); // call `render()` to create a single worksheet

$exporter->configure([ // update spreadsheet configuration
    'title' => 'Keyboards',
    'dataProvider' => new ActiveDataProvider([
        'query' => Equipment::find()->andWhere(['group' => 'keyboard']),
    ]),
])->render(); // call `render()` to create a single worksheet

$exporter->save('/path/to/file.xls');

As the result you will get a single *.xls file with 3 worksheets (tabs): ‘Monitors’, ‘Mouses’ and ‘Keyboards’.

Using yii2techspreadsheetSpreadsheet::configure() you can reset any spreadsheet parameter, including columns.
Thus you are able to combine several entirely different sheets into a single file.

Large data processing

yii2techspreadsheetSpreadsheet allows exporting of the yiidataDataProviderInterface and yiidbQueryInterface instances.
Export is performed via batches, which allows processing of the large data without memory overflow.

In case of yiidataDataProviderInterface usage, data will be split to batches using pagination mechanism.
Thus you should setup pagination with page size in order to control batch size:

<?php

use yii2techspreadsheetSpreadsheet;
use yiidataActiveDataProvider;

$exporter = new Spreadsheet([
    'dataProvider' => new ActiveDataProvider([
        'query' => Item::find(),
        'pagination' => [
            'pageSize' => 100, // export batch size
        ],
    ]),
]);
$exporter->save('/path/to/file.xls');

Note: if you disable pagination in your data provider — no batch processing will be performed.

In case of yiidbQueryInterface usage, Spreadsheet will attempt to use batch() method, if it is present in the query
class (for example in case yiidbQuery or yiidbActiveQuery usage). If batch() method is not available —
yiidataActiveDataProvider instance will be automatically created around given query.
You can control batch size via yii2techspreadsheetSpreadsheet::$batchSize:

<?php

use yii2techspreadsheetSpreadsheet;
use yiidataActiveDataProvider;

$exporter = new Spreadsheet([
    'query' => Item::find(),
    'batchSize' => 200, // export batch size
]);
$exporter->save('/path/to/file.xls');

Note: despite batch data processing reduces amount of resources needed for spreadsheet file generation,
your program may still easily end up with PHP memory limit error on large data. This happens because of
large complexity of the created document, which is stored in the memory during the entire process.
In case you need to export really large data set, consider doing so via simple CSV data format
using yii2tech/csv-grid extension.

You may union some columns in the sheet header into a groups. For example: you may have 2 different data columns:
‘Planned Revenue’ and ‘Actual Revenue’. In this case you may want to display them as a single column ‘Revenue’, split
into 2 sub columns: ‘Planned’ and ‘Actual’.
This can be achieved using yii2techspreadsheetSpreadsheet::$headerColumnUnions. Its each entry
should specify ‘offset’, which determines the amount of columns to be skipped, and ‘length’, which determines
the amount of columns to be united. Other options of the union are the same as for regular column.
For example:

<?php

use yii2techspreadsheetSpreadsheet;
use yiidataArrayDataProvider;

$exporter = new Spreadsheet([
    'dataProvider' => new ArrayDataProvider([
        'allModels' => [
            [
                'column1' => '1.1',
                'column2' => '1.2',
                'column3' => '1.3',
                'column4' => '1.4',
                'column5' => '1.5',
                'column6' => '1.6',
                'column7' => '1.7',
            ],
            [
                'column1' => '2.1',
                'column2' => '2.2',
                'column3' => '2.3',
                'column4' => '2.4',
                'column5' => '2.5',
                'column6' => '2.6',
                'column7' => '2.7',
            ],
        ],
    ]),
    'headerColumnUnions' => [
        [
            'header' => 'Skip 1 column and group 2 next',
            'offset' => 1,
            'length' => 2,
        ],
        [
            'header' => 'Skip 2 columns and group 2 next',
            'offset' => 2,
            'length' => 2,
        ],
    ],
]);
$exporter->save('/path/to/file.xls');

Note: only single level of header column unions is supported. You will need to deal with more complex
cases on your own.

Custom cell rendering

Before save() or send() method is invoked, you are able to edit generated spreadsheet, making some
final adjustments to it. Several methods exist to facilitate this process:

• yii2techspreadsheetSpreadsheet::renderCell() — renders specified cell with given content and style.
• yii2techspreadsheetSpreadsheet::applyCellStyle() — applies specified style to the cell.
• yii2techspreadsheetSpreadsheet::mergeCells() — merges sell range into single one.

You may use these methods, after document has been composed via yii2techspreadsheetSpreadsheet::render(),
to override or add some content. For example:

<?php

use yii2techspreadsheetSpreadsheet;
use yii2techspreadsheetSerialColumn;
use yiidataArrayDataProvider;

$exporter = new Spreadsheet([
    'dataProvider' => new ArrayDataProvider([
        'allModels' => [
            [
                'id' => 1,
                'name' => 'first',
            ],
            [
                'id' => 2,
                'name' => 'second',
            ],
        ],
    ]),
    'columns' => [
        [
            'class' => SerialColumn::class,
        ],
        [
            'attribute' => 'id',
        ],
        [
            'attribute' => 'name',
        ],
    ],
])->render(); // render the document

// override serial column header :
$exporter->renderCell('A1', 'Overridden serial column header');

// add custom footer :
$exporter->renderCell('A4', 'Custom A4', [
    'font' => [
        'color' => [
            'rgb' => '#FF0000',
        ],
    ],
]);

// merge footer cells :
$exporter->mergeCells('A4:B4');

$exporter->save('/path/to/file.xls');

Tip: you can use yii2techspreadsheetSpreadsheet::$rowIndex to get number of the row, which is next
to the last rendered one.