<?php
namespace Box\Spout\Reader\CSV;
use Box\Spout\Common\Exception\IOException;
> use Box\Spout\Common\Helper\GlobalFunctionsHelper;
use Box\Spout\Reader\Common\Entity\Options;
> use Box\Spout\Common\Manager\OptionsManagerInterface;
use Box\Spout\Reader\CSV\Creator\InternalEntityFactory;
> use Box\Spout\Reader\Common\Creator\InternalEntityFactoryInterface;
use Box\Spout\Reader\ReaderAbstract;
/**
* Class Reader
* This class provides support to read data from a CSV file.
*/
class Reader extends ReaderAbstract
{
/** @var resource Pointer to the file to be written */
protected $filePointer;
/** @var SheetIterator To iterator over the CSV unique "sheet" */
protected $sheetIterator;
/** @var string Original value for the "auto_detect_line_endings" INI value */
protected $originalAutoDetectLineEndings;
> /** @var bool Whether the code is running with PHP >= 8.1 */
/**
> private $isRunningAtLeastPhp81;
* Sets the field delimiter for the CSV.
>
* Needs to be called before opening the reader.
> /**
*
> * @param OptionsManagerInterface $optionsManager
* @param string $fieldDelimiter Character that delimits fields
> * @param GlobalFunctionsHelper $globalFunctionsHelper
* @return Reader
> * @param InternalEntityFactoryInterface $entityFactory
*/
> */
public function setFieldDelimiter($fieldDelimiter)
> public function __construct(
{
> OptionsManagerInterface $optionsManager,
$this->optionsManager->setOption(Options::FIELD_DELIMITER, $fieldDelimiter);
> GlobalFunctionsHelper $globalFunctionsHelper,
> InternalEntityFactoryInterface $entityFactory
return $this;
> ) {
}
> parent::__construct($optionsManager, $globalFunctionsHelper, $entityFactory);
> $this->isRunningAtLeastPhp81 = \version_compare(PHP_VERSION, '8.1.0') >= 0;
/**
> }
* Sets the field enclosure for the CSV.
>
* Needs to be called before opening the reader.
*
* @param string $fieldEnclosure Character that enclose fields
* @return Reader
*/
public function setFieldEnclosure($fieldEnclosure)
{
$this->optionsManager->setOption(Options::FIELD_ENCLOSURE, $fieldEnclosure);
return $this;
}
/**
* Sets the encoding of the CSV file to be read.
* Needs to be called before opening the reader.
*
* @param string $encoding Encoding of the CSV file to be read
* @return Reader
*/
public function setEncoding($encoding)
{
$this->optionsManager->setOption(Options::ENCODING, $encoding);
return $this;
}
/**
* Returns whether stream wrappers are supported
*
* @return bool
*/
protected function doesSupportStreamWrapper()
{
return true;
}
/**
* Opens the file at the given path to make it ready to be read.
* If setEncoding() was not called, it assumes that the file is encoded in UTF-8.
*
* @param string $filePath Path of the CSV file to be read
* @throws \Box\Spout\Common\Exception\IOException
* @return void
*/
protected function openReader($filePath)
{
< $this->originalAutoDetectLineEndings = ini_get('auto_detect_line_endings');
< ini_set('auto_detect_line_endings', '1');
> // "auto_detect_line_endings" is deprecated in PHP 8.1
> if (!$this->isRunningAtLeastPhp81) {
> $this->originalAutoDetectLineEndings = \ini_get('auto_detect_line_endings');
> \ini_set('auto_detect_line_endings', '1');
> }
$this->filePointer = $this->globalFunctionsHelper->fopen($filePath, 'r');
if (!$this->filePointer) {
throw new IOException("Could not open file $filePath for reading.");
}
/** @var InternalEntityFactory $entityFactory */
$entityFactory = $this->entityFactory;
$this->sheetIterator = $entityFactory->createSheetIterator(
$this->filePointer,
$this->optionsManager,
$this->globalFunctionsHelper
);
}
/**
* Returns an iterator to iterate over sheets.
*
* @return SheetIterator To iterate over sheets
*/
protected function getConcreteSheetIterator()
{
return $this->sheetIterator;
}
/**
* Closes the reader. To be used after reading the file.
*
* @return void
*/
protected function closeReader()
{
if ($this->filePointer) {
$this->globalFunctionsHelper->fclose($this->filePointer);
}
< ini_set('auto_detect_line_endings', $this->originalAutoDetectLineEndings);
> // "auto_detect_line_endings" is deprecated in PHP 8.1
> if (!$this->isRunningAtLeastPhp81) {
> \ini_set('auto_detect_line_endings', $this->originalAutoDetectLineEndings);
> }
}
}