Достаточно распространенной задачей при импорте данных со сторонних ресурсов является обработка экселевских документов. Раньше для этих целей использовалось расширение PhpOffice, Но чтобы данное расширение корректно заработало с файлами xlsx - нужно было изрядно поплясать с бубном.

С некоторых пор перешел на PhpSpreadsheet. Данная библиотека является логичным продолжением библиотеки PHPExcel, которая уже несколько лет не поддерживается.

Подробно с данной библиотекой можно познакомиться на ее официальном сайте.

Установка библиотеки осуществляется с помощью composer.

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

Вот несколько примеров использования данного модуля.

if(\Bitrix\Main\Loader::includeModule('pai.phpoffice')){
    $sFile = \Bitrix\Main\Application::getDocumentRoot().'/upload/file-test.xls';
    $oReader = \PhpOffice\PhpSpreadsheet\IOFactory::createReaderForFile($sFile);
    // Если вы хотите установить строки и столбцы, которые необходимо читать, создайте класс ReadFilter
    // $filterSubset = new PhpOffice\PhpSpreadsheet\chunkReadFilter(1,100,range('A','I'));
    // $oReader->setReadFilter($filterSubset);
    $oSpreadsheet = $oReader->load($sFile);
    $oCells = $oSpreadsheet->getActiveSheet()->getCellCollection();
    $arRows = [];
	$cat = '';
	for ($iRow = 2; $iRow <= $oCells->getHighestRow(); $iRow++)
	{
		$row = [];
		for ($iCol = 'A'; $iCol <= 'I'; $iCol++)
		{
			$oCell = $oCells->get($iCol.$iRow);
			if($oCell)
			{
				$row[$iCol] = iconv('utf8','windows-1251',$oCell->getValue());
			}
		}

		if(strlen($row['A'])>0){
			$cat = $row['A'];
		}

		if(strlen($row['B'])<=0) continue;

		$arRows[] = [
			'CAT'=>$cat,
			'ARTICLE'=>$row['B'],
			'NAME'=>$row['C'],
			'PRICE_USD'=>$row['D'],
			'PRICE_UAH'=>$row['E'],
			'DESCRIPTION'=>$row['F'],
			'VIDEO'=>$row['G'],
			'GARANTEE'=>$row['H'],
			'PROMO'=>$row['I']
		];
	}
}

Данный пример - часть кода из реального обработчика экселевских файлов (только со статическим файлов), где из экселевских файлов получаются данные для последующего наполнения данными описаний товаров.

Вот пример на создание и запись:

use PhpOffice\PhpSpreadsheet\Spreadsheet;
if(\Bitrix\Main\Loader::includeModule('pai.phpoffice')){
  $sOutFile = 'out.xlsx';

  $oSpreadsheet_Out = new Spreadsheet();

  $oSpreadsheet_Out->getProperties()->setCreator('Name Password')
    ->setLastModifiedBy('Name Password')
    ->setTitle('Office 2007 XLSX Test Document')
    ->setSubject('Office 2007 XLSX Test Document')
    ->setDescription('Test document for Office 2007 XLSX, generated using PHP classes.')
    ->setKeywords('office 2007 openxml php')
    ->setCategory('Test result file')
  ;

  // Add some data
  $oSpreadsheet_Out->setActiveSheetIndex(0)
    ->setCellValue('A1', 'Привет 123')
    ->setCellValue('B2', 'world!')
    ->setCellValue('C1', 'Hello')
    ->setCellValue('D2', 'world!')
  ;

  $oWriter = IOFactory::createWriter($oSpreadsheet_Out, 'Xlsx');
  $oWriter->save($sOutFile);
  //$oWriter->save('php://output');
}

Пример на чтение файла:

use PhpOffice\PhpSpreadsheet\Reader\Xlsx;
use PhpOffice\PhpSpreadsheet\IOFactory;
if(\Bitrix\Main\Loader::includeModule('pai.phpoffice')){
  $sFile = 'in.xlsx';
  $oReader = new Xlsx();
  //$oReader = IOFactory::createReaderForFile($sFile);

  // Если вы хотите установить строки и столбцы, которые необходимо читать, создайте класс ReadFilter
  //$oReader->setReadFilter( new MyReadFilter(11, 1000, range('B', 'O')) );

  $oSpreadsheet = $oReader->load($sFile);
  $oCells = $oSpreadsheet->getActiveSheet()->getCellCollection();
  for ($iRow = 1; $iRow <= $oCells->getHighestRow(); $iRow++)
  {
    for ($iCol = 'A'; $iCol <= 'C'; $iCol++)
    {
      $oCell = $oCells->get($iCol.$iRow);
      if($oCell)
      {
        echo $oCell->getValue();
      }
    }
  }
}

Сообщение Warning: ZipArchive::getFromName(): Invalid or uninitialized Zip object in возникает, если попробовать открыть XLS файл, через new xlsX(); Это возникает в том случае, когда вместо автоопределения указывается вручную тип данных для обработки

Имейте ввиду, что для использования данной библиотеки, необходима версия php не ниже 7.1. Если вы пользуетесь более старой версией - вам данный модуль не подойдет.

Как только будут появляться новые интересные примеры использования данной библиотеки - буду дополнять данную статьтью:)

Пример на использование фильтрации выборки

Класс:

use \PhpOffice\PhpSpreadsheet\Reader\IReadFilter;

class chunkreadfilter implements IReadFilter
{

	private $startRow = 0;
	private $endRow = 0;
	private $columns = [];

	public function __construct($startRow, $endRow, $columns)
	{
		$this->startRow = $startRow;
		$this->endRow = $endRow;
		$this->columns = $columns;
	}

	public function readCell($column, $row, $worksheetName = '')
	{
		if ($row >= $this->startRow && $row <= $this->endRow) {
			if (in_array($column, $this->columns)) {
				return true;
			}
		}

		return false;
	}
}

Использование:

$filterSubset = new \chunkReadFilter($line,$line+100,range('A','I'));
$oReader->setReadFilter($filterSubset);