<?php
namespace Box\Spout\Writer\ODS\Manager;
use Box\Spout\Common\Entity\Cell;
use Box\Spout\Common\Entity\Row;
use Box\Spout\Common\Entity\Style\Style;
use Box\Spout\Common\Exception\InvalidArgumentException;
use Box\Spout\Common\Exception\IOException;
use Box\Spout\Common\Helper\Escaper\ODS as ODSEscaper;
use Box\Spout\Common\Helper\StringHelper;
use Box\Spout\Writer\Common\Entity\Worksheet;
> use Box\Spout\Writer\Common\Manager\RegisteredStyle;
use Box\Spout\Writer\Common\Manager\Style\StyleMerger;
use Box\Spout\Writer\Common\Manager\WorksheetManagerInterface;
use Box\Spout\Writer\ODS\Manager\Style\StyleManager;
/**
* Class WorksheetManager
* ODS worksheet manager, providing the interfaces to work with ODS worksheets.
*/
class WorksheetManager implements WorksheetManagerInterface
{
/** @var \Box\Spout\Common\Helper\Escaper\ODS Strings escaper */
private $stringsEscaper;
/** @var StringHelper String helper */
private $stringHelper;
/** @var StyleManager Manages styles */
private $styleManager;
/** @var StyleMerger Helper to merge styles together */
private $styleMerger;
/**
* WorksheetManager constructor.
*
* @param StyleManager $styleManager
* @param StyleMerger $styleMerger
* @param ODSEscaper $stringsEscaper
* @param StringHelper $stringHelper
*/
public function __construct(
StyleManager $styleManager,
StyleMerger $styleMerger,
ODSEscaper $stringsEscaper,
StringHelper $stringHelper
) {
$this->styleManager = $styleManager;
$this->styleMerger = $styleMerger;
$this->stringsEscaper = $stringsEscaper;
$this->stringHelper = $stringHelper;
}
/**
* Prepares the worksheet to accept data
*
* @param Worksheet $worksheet The worksheet to start
* @throws \Box\Spout\Common\Exception\IOException If the sheet data file cannot be opened for writing
* @return void
*/
public function startSheet(Worksheet $worksheet)
{
< $sheetFilePointer = fopen($worksheet->getFilePath(), 'w');
> $sheetFilePointer = \fopen($worksheet->getFilePath(), 'w');
$this->throwIfSheetFilePointerIsNotAvailable($sheetFilePointer);
$worksheet->setFilePointer($sheetFilePointer);
}
/**
* Checks if the sheet has been sucessfully created. Throws an exception if not.
*
* @param bool|resource $sheetFilePointer Pointer to the sheet data file or FALSE if unable to open the file
* @throws IOException If the sheet data file cannot be opened for writing
* @return void
*/
private function throwIfSheetFilePointerIsNotAvailable($sheetFilePointer)
{
if (!$sheetFilePointer) {
throw new IOException('Unable to open sheet for writing.');
}
}
/**
* Returns the table XML root node as string.
*
* @param Worksheet $worksheet
* @return string <table> node as string
*/
public function getTableElementStartAsString(Worksheet $worksheet)
{
$externalSheet = $worksheet->getExternalSheet();
$escapedSheetName = $this->stringsEscaper->escape($externalSheet->getName());
$tableStyleName = 'ta' . ($externalSheet->getIndex() + 1);
$tableElement = '<table:table table:style-name="' . $tableStyleName . '" table:name="' . $escapedSheetName . '">';
$tableElement .= '<table:table-column table:default-cell-style-name="ce1" table:style-name="co1" table:number-columns-repeated="' . $worksheet->getMaxNumColumns() . '"/>';
return $tableElement;
}
/**
* Adds a row to the given worksheet.
*
* @param Worksheet $worksheet The worksheet to add the row to
* @param Row $row The row to be added
< * @throws IOException If the data cannot be written
* @throws InvalidArgumentException If a cell value's type is not supported
> * @throws IOException If the data cannot be written
* @return void
*/
public function addRow(Worksheet $worksheet, Row $row)
{
$cells = $row->getCells();
$rowStyle = $row->getStyle();
$data = '<table:table-row table:style-name="ro1">';
$currentCellIndex = 0;
$nextCellIndex = 1;
for ($i = 0; $i < $row->getNumCells(); $i++) {
/** @var Cell $cell */
$cell = $cells[$currentCellIndex];
/** @var Cell|null $nextCell */
$nextCell = isset($cells[$nextCellIndex]) ? $cells[$nextCellIndex] : null;
if ($nextCell === null || $cell->getValue() !== $nextCell->getValue()) {
< $data .= $this->applyStyleAndGetCellXML($cell, $rowStyle, $currentCellIndex, $nextCellIndex);
> $registeredStyle = $this->applyStyleAndRegister($cell, $rowStyle);
> $cellStyle = $registeredStyle->getStyle();
> if ($registeredStyle->isMatchingRowStyle()) {
> $rowStyle = $cellStyle; // Replace actual rowStyle (possibly with null id) by registered style (with id)
> }
>
> $data .= $this->getCellXMLWithStyle($cell, $cellStyle, $currentCellIndex, $nextCellIndex);
$currentCellIndex = $nextCellIndex;
}
$nextCellIndex++;
}
$data .= '</table:table-row>';
< $wasWriteSuccessful = fwrite($worksheet->getFilePointer(), $data);
> $wasWriteSuccessful = \fwrite($worksheet->getFilePointer(), $data);
if ($wasWriteSuccessful === false) {
throw new IOException("Unable to write data in {$worksheet->getFilePath()}");
}
// only update the count if the write worked
$lastWrittenRowIndex = $worksheet->getLastWrittenRowIndex();
$worksheet->setLastWrittenRowIndex($lastWrittenRowIndex + 1);
}
/**
* Applies styles to the given style, merging the cell's style with its row's style
< * Then builds and returns xml for the cell.
*
* @param Cell $cell
* @param Style $rowStyle
< * @param int $currentCellIndex
< * @param int $nextCellIndex
* @throws InvalidArgumentException If a cell value's type is not supported
< * @return string
> * @return RegisteredStyle
*/
< private function applyStyleAndGetCellXML(Cell $cell, Style $rowStyle, $currentCellIndex, $nextCellIndex)
> private function applyStyleAndRegister(Cell $cell, Style $rowStyle) : RegisteredStyle
{
< // Apply row and extra styles
> $isMatchingRowStyle = false;
> if ($cell->getStyle()->isEmpty()) {
> $cell->setStyle($rowStyle);
>
> $possiblyUpdatedStyle = $this->styleManager->applyExtraStylesIfNeeded($cell);
>
> if ($possiblyUpdatedStyle->isUpdated()) {
> $registeredStyle = $this->styleManager->registerStyle($possiblyUpdatedStyle->getStyle());
> } else {
> $registeredStyle = $this->styleManager->registerStyle($rowStyle);
> $isMatchingRowStyle = true;
> }
> } else {
$mergedCellAndRowStyle = $this->styleMerger->merge($cell->getStyle(), $rowStyle);
$cell->setStyle($mergedCellAndRowStyle);
< $newCellStyle = $this->styleManager->applyExtraStylesIfNeeded($cell);
>
> $possiblyUpdatedStyle = $this->styleManager->applyExtraStylesIfNeeded($cell);
> if ($possiblyUpdatedStyle->isUpdated()) {
> $newCellStyle = $possiblyUpdatedStyle->getStyle();
> } else {
> $newCellStyle = $mergedCellAndRowStyle;
> }
$registeredStyle = $this->styleManager->registerStyle($newCellStyle);
< $styleIndex = $registeredStyle->getId() + 1; // 1-based
> }
>
> return new RegisteredStyle($registeredStyle, $isMatchingRowStyle);
> }
>
> private function getCellXMLWithStyle(Cell $cell, Style $style, int $currentCellIndex, int $nextCellIndex) : string
> {
> $styleIndex = $style->getId() + 1; // 1-based
$numTimesValueRepeated = ($nextCellIndex - $currentCellIndex);
return $this->getCellXML($cell, $styleIndex, $numTimesValueRepeated);
}
/**
* Returns the cell XML content, given its value.
*
* @param Cell $cell The cell to be written
* @param int $styleIndex Index of the used style
* @param int $numTimesValueRepeated Number of times the value is consecutively repeated
* @throws InvalidArgumentException If a cell value's type is not supported
* @return string The cell XML content
*/
private function getCellXML(Cell $cell, $styleIndex, $numTimesValueRepeated)
{
$data = '<table:table-cell table:style-name="ce' . $styleIndex . '"';
if ($numTimesValueRepeated !== 1) {
$data .= ' table:number-columns-repeated="' . $numTimesValueRepeated . '"';
}
if ($cell->isString()) {
$data .= ' office:value-type="string" calcext:value-type="string">';
< $cellValueLines = explode("\n", $cell->getValue());
> $cellValueLines = \explode("\n", $cell->getValue());
foreach ($cellValueLines as $cellValueLine) {
$data .= '<text:p>' . $this->stringsEscaper->escape($cellValueLine) . '</text:p>';
}
$data .= '</table:table-cell>';
} elseif ($cell->isBoolean()) {
< $data .= ' office:value-type="boolean" calcext:value-type="boolean" office:boolean-value="' . $cell->getValue() . '">';
> $value = $cell->getValue() ? 'true' : 'false'; // boolean-value spec: http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os-part1.html#datatype-boolean
> $data .= ' office:value-type="boolean" calcext:value-type="boolean" office:boolean-value="' . $value . '">';
$data .= '<text:p>' . $cell->getValue() . '</text:p>';
$data .= '</table:table-cell>';
} elseif ($cell->isNumeric()) {
< $data .= ' office:value-type="float" calcext:value-type="float" office:value="' . $cell->getValue() . '">';
< $data .= '<text:p>' . $cell->getValue() . '</text:p>';
> $cellValue = $this->stringHelper->formatNumericValue($cell->getValue());
> $data .= ' office:value-type="float" calcext:value-type="float" office:value="' . $cellValue . '">';
> $data .= '<text:p>' . $cellValue . '</text:p>';
> $data .= '</table:table-cell>';
> } elseif ($cell->isError() && is_string($cell->getValueEvenIfError())) {
> // only writes the error value if it's a string
> $data .= ' office:value-type="string" calcext:value-type="error" office:value="">';
> $data .= '<text:p>' . $cell->getValueEvenIfError() . '</text:p>';
$data .= '</table:table-cell>';
} elseif ($cell->isEmpty()) {
$data .= '/>';
} else {
< throw new InvalidArgumentException('Trying to add a value with an unsupported type: ' . gettype($cell->getValue()));
> throw new InvalidArgumentException('Trying to add a value with an unsupported type: ' . \gettype($cell->getValue()));
}
return $data;
}
/**
* Closes the worksheet
*
* @param Worksheet $worksheet
* @return void
*/
public function close(Worksheet $worksheet)
{
$worksheetFilePointer = $worksheet->getFilePointer();
< if (!is_resource($worksheetFilePointer)) {
> if (!\is_resource($worksheetFilePointer)) {
return;
}
< fclose($worksheetFilePointer);
> \fclose($worksheetFilePointer);
}
}