See Release Notes
Long Term Support Release
<?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); > }} }