Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
  • Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
  • PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is supported too.
<?php

namespace Box\Spout\Reader\ODS\Helper;

use Box\Spout\Reader\Exception\InvalidValueException;

/**
 * Class CellValueFormatter
 * This class provides helper functions to format cell values
 */
class CellValueFormatter
{
    /** Definition of all possible cell types */
    const CELL_TYPE_STRING = 'string';
    const CELL_TYPE_FLOAT = 'float';
    const CELL_TYPE_BOOLEAN = 'boolean';
    const CELL_TYPE_DATE = 'date';
    const CELL_TYPE_TIME = 'time';
    const CELL_TYPE_CURRENCY = 'currency';
    const CELL_TYPE_PERCENTAGE = 'percentage';
    const CELL_TYPE_VOID = 'void';

    /** Definition of XML nodes names used to parse data */
    const XML_NODE_P = 'p';
< const XML_NODE_S = 'text:s'; < const XML_NODE_A = 'text:a'; < const XML_NODE_SPAN = 'text:span';
> const XML_NODE_TEXT_A = 'text:a'; > const XML_NODE_TEXT_SPAN = 'text:span'; > const XML_NODE_TEXT_S = 'text:s'; > const XML_NODE_TEXT_TAB = 'text:tab'; > const XML_NODE_TEXT_LINE_BREAK = 'text:line-break';
/** Definition of XML attributes used to parse data */ const XML_ATTRIBUTE_TYPE = 'office:value-type'; const XML_ATTRIBUTE_VALUE = 'office:value'; const XML_ATTRIBUTE_BOOLEAN_VALUE = 'office:boolean-value'; const XML_ATTRIBUTE_DATE_VALUE = 'office:date-value'; const XML_ATTRIBUTE_TIME_VALUE = 'office:time-value'; const XML_ATTRIBUTE_CURRENCY = 'office:currency'; const XML_ATTRIBUTE_C = 'text:c'; /** @var bool Whether date/time values should be returned as PHP objects or be formatted as strings */ protected $shouldFormatDates; /** @var \Box\Spout\Common\Helper\Escaper\ODS Used to unescape XML data */ protected $escaper;
> /** @var array List of XML nodes representing whitespaces and their corresponding value */ /** > private static $WHITESPACE_XML_NODES = [ * @param bool $shouldFormatDates Whether date/time values should be returned as PHP objects or be formatted as strings > self::XML_NODE_TEXT_S => ' ', * @param \Box\Spout\Common\Helper\Escaper\ODS $escaper Used to unescape XML data > self::XML_NODE_TEXT_TAB => "\t", */ > self::XML_NODE_TEXT_LINE_BREAK => "\n", public function __construct($shouldFormatDates, $escaper) > ]; { >
$this->shouldFormatDates = $shouldFormatDates; $this->escaper = $escaper; } /** * Returns the (unescaped) correctly marshalled, cell value associated to the given XML node. * @see http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os-part1.html#refTable13 * * @param \DOMNode $node * @throws InvalidValueException If the node value is not valid * @return string|int|float|bool|\DateTime|\DateInterval The value associated with the cell, empty string if cell's type is void/undefined */ public function extractAndFormatNodeValue($node) { $cellType = $node->getAttribute(self::XML_ATTRIBUTE_TYPE); switch ($cellType) { case self::CELL_TYPE_STRING: return $this->formatStringCellValue($node); case self::CELL_TYPE_FLOAT: return $this->formatFloatCellValue($node); case self::CELL_TYPE_BOOLEAN: return $this->formatBooleanCellValue($node); case self::CELL_TYPE_DATE: return $this->formatDateCellValue($node); case self::CELL_TYPE_TIME: return $this->formatTimeCellValue($node); case self::CELL_TYPE_CURRENCY: return $this->formatCurrencyCellValue($node); case self::CELL_TYPE_PERCENTAGE: return $this->formatPercentageCellValue($node); case self::CELL_TYPE_VOID: default: return ''; } } /** * Returns the cell String value. * * @param \DOMNode $node * @return string The value associated with the cell */ protected function formatStringCellValue($node) { $pNodeValues = []; $pNodes = $node->getElementsByTagName(self::XML_NODE_P); foreach ($pNodes as $pNode) {
< $currentPValue = '';
> $pNodeValues[] = $this->extractTextValueFromNode($pNode); > } > > $escapedCellValue = \implode("\n", $pNodeValues); > $cellValue = $this->escaper->unescape($escapedCellValue); > > return $cellValue; > } > > /** > * @param $pNode > * @return string > */ > private function extractTextValueFromNode($pNode) > { > $textValue = '';
foreach ($pNode->childNodes as $childNode) { if ($childNode instanceof \DOMText) {
< $currentPValue .= $childNode->nodeValue; < } elseif ($childNode->nodeName === self::XML_NODE_S) { < $spaceAttribute = $childNode->getAttribute(self::XML_ATTRIBUTE_C); < $numSpaces = (!empty($spaceAttribute)) ? (int) $spaceAttribute : 1; < $currentPValue .= str_repeat(' ', $numSpaces); < } elseif ($childNode->nodeName === self::XML_NODE_A || $childNode->nodeName === self::XML_NODE_SPAN) { < $currentPValue .= $childNode->nodeValue;
> $textValue .= $childNode->nodeValue; > } elseif ($this->isWhitespaceNode($childNode->nodeName)) { > $textValue .= $this->transformWhitespaceNode($childNode); > } elseif ($childNode->nodeName === self::XML_NODE_TEXT_A || $childNode->nodeName === self::XML_NODE_TEXT_SPAN) { > $textValue .= $this->extractTextValueFromNode($childNode);
} }
< $pNodeValues[] = $currentPValue;
> return $textValue;
}
< $escapedCellValue = implode("\n", $pNodeValues); < $cellValue = $this->escaper->unescape($escapedCellValue);
> /** > * Returns whether the given node is a whitespace node. It must be one of these: > * - <text:s /> > * - <text:tab /> > * - <text:line-break /> > * > * @param string $nodeName > * @return bool > */ > private function isWhitespaceNode($nodeName) > { > return isset(self::$WHITESPACE_XML_NODES[$nodeName]); > }
< return $cellValue;
> /** > * The "<text:p>" node can contain the string value directly > * or contain child elements. In this case, whitespaces contain in > * the child elements should be replaced by their XML equivalent: > * - space => <text:s /> > * - tab => <text:tab /> > * - line break => <text:line-break /> > * > * @see https://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os-part1.html#__RefHeading__1415200_253892949 > * > * @param \DOMNode $node The XML node representing a whitespace > * @return string The corresponding whitespace value > */ > private function transformWhitespaceNode($node) > { > $countAttribute = $node->getAttribute(self::XML_ATTRIBUTE_C); // only defined for "<text:s>" > $numWhitespaces = (!empty($countAttribute)) ? (int) $countAttribute : 1; > > return \str_repeat(self::$WHITESPACE_XML_NODES[$node->nodeName], $numWhitespaces);
} /** * Returns the cell Numeric value from the given node. * * @param \DOMNode $node * @return int|float The value associated with the cell */ protected function formatFloatCellValue($node) { $nodeValue = $node->getAttribute(self::XML_ATTRIBUTE_VALUE); $nodeIntValue = (int) $nodeValue; $nodeFloatValue = (float) $nodeValue; $cellValue = ((float) $nodeIntValue === $nodeFloatValue) ? $nodeIntValue : $nodeFloatValue; return $cellValue; } /** * Returns the cell Boolean value from the given node. * * @param \DOMNode $node * @return bool The value associated with the cell */ protected function formatBooleanCellValue($node) { $nodeValue = $node->getAttribute(self::XML_ATTRIBUTE_BOOLEAN_VALUE); return (bool) $nodeValue; } /** * Returns the cell Date value from the given node. * * @param \DOMNode $node * @throws InvalidValueException If the value is not a valid date * @return \DateTime|string The value associated with the cell */ protected function formatDateCellValue($node) { // The XML node looks like this: // <table:table-cell calcext:value-type="date" office:date-value="2016-05-19T16:39:00" office:value-type="date"> // <text:p>05/19/16 04:39 PM</text:p> // </table:table-cell> if ($this->shouldFormatDates) { // The date is already formatted in the "p" tag $nodeWithValueAlreadyFormatted = $node->getElementsByTagName(self::XML_NODE_P)->item(0); $cellValue = $nodeWithValueAlreadyFormatted->nodeValue; } else { // otherwise, get it from the "date-value" attribute $nodeValue = $node->getAttribute(self::XML_ATTRIBUTE_DATE_VALUE); try { $cellValue = new \DateTime($nodeValue); } catch (\Exception $e) { throw new InvalidValueException($nodeValue); } } return $cellValue; } /** * Returns the cell Time value from the given node. * * @param \DOMNode $node * @throws InvalidValueException If the value is not a valid time * @return \DateInterval|string The value associated with the cell */ protected function formatTimeCellValue($node) { // The XML node looks like this: // <table:table-cell calcext:value-type="time" office:time-value="PT13H24M00S" office:value-type="time"> // <text:p>01:24:00 PM</text:p> // </table:table-cell> if ($this->shouldFormatDates) { // The date is already formatted in the "p" tag $nodeWithValueAlreadyFormatted = $node->getElementsByTagName(self::XML_NODE_P)->item(0); $cellValue = $nodeWithValueAlreadyFormatted->nodeValue; } else { // otherwise, get it from the "time-value" attribute $nodeValue = $node->getAttribute(self::XML_ATTRIBUTE_TIME_VALUE); try { $cellValue = new \DateInterval($nodeValue); } catch (\Exception $e) { throw new InvalidValueException($nodeValue); } } return $cellValue; } /** * Returns the cell Currency value from the given node. * * @param \DOMNode $node * @return string The value associated with the cell (e.g. "100 USD" or "9.99 EUR") */ protected function formatCurrencyCellValue($node) { $value = $node->getAttribute(self::XML_ATTRIBUTE_VALUE); $currency = $node->getAttribute(self::XML_ATTRIBUTE_CURRENCY); return "$value $currency"; } /** * Returns the cell Percentage value from the given node. * * @param \DOMNode $node * @return int|float The value associated with the cell */ protected function formatPercentageCellValue($node) { // percentages are formatted like floats return $this->formatFloatCellValue($node); } }