or
+ $styles['width'] = (int) $val * 50;
+ $styles['unit'] = \PhpOffice\PhpWord\SimpleType\TblWidth::PERCENT;
+ } else {
+ // e.g. , where "2" = 2px (always pixels)
+ $val = (int) $val . 'px';
+ $styles['cellSpacing'] = Converter::cssToTwip($val);
+
+ break;
+ case 'bgcolor':
+ // tables, rows, cells e.g.
+ $styles['bgColor'] = self::convertRgb($val);
+
+ break;
+ case 'valign':
+ // cells e.g.
+ if (preg_match('#(?:top|bottom|middle|baseline)#i', $val, $matches)) {
+ $styles['valign'] = self::mapAlignVertical($matches[0]);
+ }
+
+ break;
+ }
+ }
+
+ $attributeIdentifier = $attributes->getNamedItem('id');
+ if ($attributeIdentifier && self::$css) {
+ $styles = self::parseStyleDeclarations(self::$css->getStyle('#' . $attributeIdentifier->nodeValue), $styles);
+ }
+
+ $attributeClass = $attributes->getNamedItem('class');
+ if ($attributeClass) {
+ if (self::$css) {
+ $styles = self::parseStyleDeclarations(self::$css->getStyle('.' . $attributeClass->nodeValue), $styles);
+ }
+ $styles['className'] = $attributeClass->nodeValue;
+ }
+
+ $attributeStyle = $attributes->getNamedItem('style');
+ if ($attributeStyle) {
+ $styles = self::parseStyle($attributeStyle, $styles);
+ }
+ }
+
+ return $styles;
+ }
+
+ /**
+ * Parse a node and add a corresponding element to the parent element.
+ *
+ * @param DOMNode $node node to parse
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element object to add an element corresponding with the node
+ * @param array $styles Array with all styles
+ * @param array $data Array to transport data to a next level in the DOM tree, for example level of listitems
+ */
+ protected static function parseNode($node, $element, $styles = [], $data = []): void
+ {
+ if ($node->nodeName == 'style') {
+ self::$css = new Css($node->textContent);
+ self::$css->process();
+
+ return;
+ }
+
+ // Populate styles array
+ $styleTypes = ['font', 'paragraph', 'list', 'table', 'row', 'cell'];
+ foreach ($styleTypes as $styleType) {
+ if (!isset($styles[$styleType])) {
+ $styles[$styleType] = [];
+ }
+ }
+
+ // Node mapping table
+ $nodes = [
+ // $method $node $element $styles $data $argument1 $argument2
+ 'p' => ['Paragraph', $node, $element, $styles, null, null, null],
+ 'h1' => ['Heading', null, $element, $styles, null, 'Heading1', null],
+ 'h2' => ['Heading', null, $element, $styles, null, 'Heading2', null],
+ 'h3' => ['Heading', null, $element, $styles, null, 'Heading3', null],
+ 'h4' => ['Heading', null, $element, $styles, null, 'Heading4', null],
+ 'h5' => ['Heading', null, $element, $styles, null, 'Heading5', null],
+ 'h6' => ['Heading', null, $element, $styles, null, 'Heading6', null],
+ '#text' => ['Text', $node, $element, $styles, null, null, null],
+ 'strong' => ['Property', null, null, $styles, null, 'bold', true],
+ 'b' => ['Property', null, null, $styles, null, 'bold', true],
+ 'em' => ['Property', null, null, $styles, null, 'italic', true],
+ 'i' => ['Property', null, null, $styles, null, 'italic', true],
+ 'u' => ['Property', null, null, $styles, null, 'underline', 'single'],
+ 'sup' => ['Property', null, null, $styles, null, 'superScript', true],
+ 'sub' => ['Property', null, null, $styles, null, 'subScript', true],
+ 'span' => ['Span', $node, null, $styles, null, null, null],
+ 'font' => ['Span', $node, null, $styles, null, null, null],
+ 'table' => ['Table', $node, $element, $styles, null, null, null],
+ 'tr' => ['Row', $node, $element, $styles, null, null, null],
+ 'td' => ['Cell', $node, $element, $styles, null, null, null],
+ 'th' => ['Cell', $node, $element, $styles, null, null, null],
+ 'ul' => ['List', $node, $element, $styles, $data, null, null],
+ 'ol' => ['List', $node, $element, $styles, $data, null, null],
+ 'li' => ['ListItem', $node, $element, $styles, $data, null, null],
+ 'img' => ['Image', $node, $element, $styles, null, null, null],
+ 'br' => ['LineBreak', null, $element, $styles, null, null, null],
+ 'a' => ['Link', $node, $element, $styles, null, null, null],
+ 'input' => ['Input', $node, $element, $styles, null, null, null],
+ 'hr' => ['HorizRule', $node, $element, $styles, null, null, null],
+ ];
+
+ $newElement = null;
+ $keys = ['node', 'element', 'styles', 'data', 'argument1', 'argument2'];
+
+ if (isset($nodes[$node->nodeName])) {
+ // Execute method based on node mapping table and return $newElement or null
+ // Arguments are passed by reference
+ $arguments = [];
+ $args = [];
+ [$method, $args[0], $args[1], $args[2], $args[3], $args[4], $args[5]] = $nodes[$node->nodeName];
+ for ($i = 0; $i <= 5; ++$i) {
+ if ($args[$i] !== null) {
+ $arguments[$keys[$i]] = &$args[$i];
+ }
+ }
+ $method = "parse{$method}";
+ $newElement = call_user_func_array(['PhpOffice\PhpWord\Shared\Html', $method], array_values($arguments));
+
+ // Retrieve back variables from arguments
+ foreach ($keys as $key) {
+ if (array_key_exists($key, $arguments)) {
+ $$key = $arguments[$key];
+ }
+ }
+ }
+
+ if ($newElement === null) {
+ $newElement = $element;
+ }
+
+ static::parseChildNodes($node, $newElement, $styles, $data);
+ }
+
+ /**
+ * Parse child nodes.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer|Row|Table $element
+ * @param array $styles
+ * @param array $data
+ */
+ protected static function parseChildNodes($node, $element, $styles, $data): void
+ {
+ if ('li' != $node->nodeName) {
+ $cNodes = $node->childNodes;
+ if (!empty($cNodes)) {
+ foreach ($cNodes as $cNode) {
+ if ($element instanceof AbstractContainer || $element instanceof Table || $element instanceof Row) {
+ self::parseNode($cNode, $element, $styles, $data);
+ }
+ }
+ }
+ }
+ }
+
+ /**
+ * Parse paragraph node.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ * @param array &$styles
+ *
+ * @return \PhpOffice\PhpWord\Element\PageBreak|\PhpOffice\PhpWord\Element\TextRun
+ */
+ protected static function parseParagraph($node, $element, &$styles)
+ {
+ $styles['paragraph'] = self::recursiveParseStylesInHierarchy($node, $styles['paragraph']);
+ if (isset($styles['paragraph']['isPageBreak']) && $styles['paragraph']['isPageBreak']) {
+ return $element->addPageBreak();
+ }
+
+ return $element->addTextRun($styles['paragraph']);
+ }
+
+ /**
+ * Parse input node.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ * @param array &$styles
+ */
+ protected static function parseInput($node, $element, &$styles): void
+ {
+ $attributes = $node->attributes;
+ if (null === $attributes->getNamedItem('type')) {
+ return;
+ }
+
+ $inputType = $attributes->getNamedItem('type')->nodeValue;
+ switch ($inputType) {
+ case 'checkbox':
+ $checked = ($checked = $attributes->getNamedItem('checked')) && $checked->nodeValue === 'true' ? true : false;
+ $textrun = $element->addTextRun($styles['paragraph']);
+ $textrun->addFormField('checkbox')->setValue($checked);
+
+ break;
+ }
+ }
+
+ /**
+ * Parse heading node.
+ *
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ * @param array &$styles
+ * @param string $argument1 Name of heading style
+ *
+ * @return \PhpOffice\PhpWord\Element\TextRun
+ *
+ * @todo Think of a clever way of defining header styles, now it is only based on the assumption, that
+ * Heading1 - Heading6 are already defined somewhere
+ */
+ protected static function parseHeading($element, &$styles, $argument1)
+ {
+ $styles['paragraph'] = $argument1;
+ $newElement = $element->addTextRun($styles['paragraph']);
+
+ return $newElement;
+ }
+
+ /**
+ * Parse text node.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ * @param array &$styles
+ */
+ protected static function parseText($node, $element, &$styles): void
+ {
+ $styles['font'] = self::recursiveParseStylesInHierarchy($node, $styles['font']);
+
+ //alignment applies on paragraph, not on font. Let's copy it there
+ if (isset($styles['font']['alignment']) && is_array($styles['paragraph'])) {
+ $styles['paragraph']['alignment'] = $styles['font']['alignment'];
+ }
+
+ if (is_callable([$element, 'addText'])) {
+ $element->addText($node->nodeValue, $styles['font'], $styles['paragraph']);
+ }
+ }
+
+ /**
+ * Parse property node.
+ *
+ * @param array &$styles
+ * @param string $argument1 Style name
+ * @param string $argument2 Style value
+ */
+ protected static function parseProperty(&$styles, $argument1, $argument2): void
+ {
+ $styles['font'][$argument1] = $argument2;
+ }
+
+ /**
+ * Parse span node.
+ *
+ * @param DOMNode $node
+ * @param array &$styles
+ */
+ protected static function parseSpan($node, &$styles): void
+ {
+ self::parseInlineStyle($node, $styles['font']);
+ }
+
+ /**
+ * Parse table node.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ * @param array &$styles
+ *
+ * @return Table $element
+ *
+ * @todo As soon as TableItem, RowItem and CellItem support relative width and height
+ */
+ protected static function parseTable($node, $element, &$styles)
+ {
+ $elementStyles = self::parseInlineStyle($node, $styles['table']);
+
+ $newElement = $element->addTable($elementStyles);
+
+ // Add style name from CSS Class
+ if (isset($elementStyles['className'])) {
+ $newElement->getStyle()->setStyleName($elementStyles['className']);
+ }
+
+ $attributes = $node->attributes;
+ if ($attributes->getNamedItem('border')) {
+ $border = (int) $attributes->getNamedItem('border')->nodeValue;
+ $newElement->getStyle()->setBorderSize(Converter::pixelToTwip($border));
+ }
+
+ return $newElement;
+ }
+
+ /**
+ * Parse a table row.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\Table $element
+ * @param array &$styles
+ *
+ * @return Row $element
+ */
+ protected static function parseRow($node, $element, &$styles)
+ {
+ $rowStyles = self::parseInlineStyle($node, $styles['row']);
+ if ($node->parentNode->nodeName == 'thead') {
+ $rowStyles['tblHeader'] = true;
+ }
+
+ // set cell height to control row heights
+ $height = $rowStyles['height'] ?? null;
+ unset($rowStyles['height']); // would not apply
+
+ return $element->addRow($height, $rowStyles);
+ }
+
+ /**
+ * Parse table cell.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\Table $element
+ * @param array &$styles
+ *
+ * @return \PhpOffice\PhpWord\Element\Cell|\PhpOffice\PhpWord\Element\TextRun $element
+ */
+ protected static function parseCell($node, $element, &$styles)
+ {
+ $cellStyles = self::recursiveParseStylesInHierarchy($node, $styles['cell']);
+
+ $colspan = $node->getAttribute('colspan');
+ if (!empty($colspan)) {
+ $cellStyles['gridSpan'] = $colspan - 0;
+ }
+
+ // set cell width to control column widths
+ $width = $cellStyles['width'] ?? null;
+ unset($cellStyles['width']); // would not apply
+ $cell = $element->addCell($width, $cellStyles);
+
+ if (self::shouldAddTextRun($node)) {
+ return $cell->addTextRun(self::filterOutNonInheritedStyles(self::parseInlineStyle($node, $styles['paragraph'])));
+ }
+
+ return $cell;
+ }
+
+ /**
+ * Checks if $node contains an HTML element that cannot be added to TextRun.
+ *
+ * @return bool Returns true if the node contains an HTML element that cannot be added to TextRun
+ */
+ protected static function shouldAddTextRun(DOMNode $node)
+ {
+ $containsBlockElement = self::$xpath->query('.//table|./p|./ul|./ol|./h1|./h2|./h3|./h4|./h5|./h6', $node)->length > 0;
+ if ($containsBlockElement) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * Recursively parses styles on parent nodes
+ * TODO if too slow, add caching of parent nodes, !! everything is static here so watch out for concurrency !!
+ */
+ protected static function recursiveParseStylesInHierarchy(DOMNode $node, array $style)
+ {
+ $parentStyle = [];
+ if ($node->parentNode != null && XML_ELEMENT_NODE == $node->parentNode->nodeType) {
+ $parentStyle = self::recursiveParseStylesInHierarchy($node->parentNode, []);
+ }
+ if ($node->nodeName === '#text') {
+ $parentStyle = array_merge($parentStyle, $style);
+ } else {
+ $parentStyle = self::filterOutNonInheritedStyles($parentStyle);
+ }
+ $style = self::parseInlineStyle($node, $parentStyle);
+
+ return $style;
+ }
+
+ /**
+ * Removes non-inherited styles from array.
+ */
+ protected static function filterOutNonInheritedStyles(array $styles)
+ {
+ $nonInheritedStyles = [
+ 'borderSize',
+ 'borderTopSize',
+ 'borderRightSize',
+ 'borderBottomSize',
+ 'borderLeftSize',
+ 'borderColor',
+ 'borderTopColor',
+ 'borderRightColor',
+ 'borderBottomColor',
+ 'borderLeftColor',
+ 'borderStyle',
+ 'spaceAfter',
+ 'spaceBefore',
+ 'underline',
+ 'strikethrough',
+ 'hidden',
+ ];
+
+ $styles = array_diff_key($styles, array_flip($nonInheritedStyles));
+
+ return $styles;
+ }
+
+ /**
+ * Parse list node.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ * @param array &$styles
+ * @param array &$data
+ */
+ protected static function parseList($node, $element, &$styles, &$data)
+ {
+ $isOrderedList = $node->nodeName === 'ol';
+ if (isset($data['listdepth'])) {
+ ++$data['listdepth'];
+ } else {
+ $data['listdepth'] = 0;
+ $styles['list'] = 'listStyle_' . self::$listIndex++;
+ $style = $element->getPhpWord()->addNumberingStyle($styles['list'], self::getListStyle($isOrderedList));
+
+ // extract attributes start & type e.g.
+ $start = 0;
+ $type = '';
+ foreach ($node->attributes as $attribute) {
+ switch ($attribute->name) {
+ case 'start':
+ $start = (int) $attribute->value;
+
+ break;
+ case 'type':
+ $type = $attribute->value;
+
+ break;
+ }
+ }
+
+ $levels = $style->getLevels();
+ /** @var \PhpOffice\PhpWord\Style\NumberingLevel */
+ $level = $levels[0];
+ if ($start > 0) {
+ $level->setStart($start);
+ }
+ $type = $type ? self::mapListType($type) : null;
+ if ($type) {
+ $level->setFormat($type);
+ }
+ }
+ if ($node->parentNode->nodeName === 'li') {
+ return $element->getParent();
+ }
+ }
+
+ /**
+ * @param bool $isOrderedList
+ *
+ * @return array
+ */
+ protected static function getListStyle($isOrderedList)
+ {
+ if ($isOrderedList) {
+ return [
+ 'type' => 'multilevel',
+ 'levels' => [
+ ['format' => NumberFormat::DECIMAL, 'text' => '%1.', 'alignment' => 'left', 'tabPos' => 720, 'left' => 720, 'hanging' => 360],
+ ['format' => NumberFormat::LOWER_LETTER, 'text' => '%2.', 'alignment' => 'left', 'tabPos' => 1440, 'left' => 1440, 'hanging' => 360],
+ ['format' => NumberFormat::LOWER_ROMAN, 'text' => '%3.', 'alignment' => 'right', 'tabPos' => 2160, 'left' => 2160, 'hanging' => 180],
+ ['format' => NumberFormat::DECIMAL, 'text' => '%4.', 'alignment' => 'left', 'tabPos' => 2880, 'left' => 2880, 'hanging' => 360],
+ ['format' => NumberFormat::LOWER_LETTER, 'text' => '%5.', 'alignment' => 'left', 'tabPos' => 3600, 'left' => 3600, 'hanging' => 360],
+ ['format' => NumberFormat::LOWER_ROMAN, 'text' => '%6.', 'alignment' => 'right', 'tabPos' => 4320, 'left' => 4320, 'hanging' => 180],
+ ['format' => NumberFormat::DECIMAL, 'text' => '%7.', 'alignment' => 'left', 'tabPos' => 5040, 'left' => 5040, 'hanging' => 360],
+ ['format' => NumberFormat::LOWER_LETTER, 'text' => '%8.', 'alignment' => 'left', 'tabPos' => 5760, 'left' => 5760, 'hanging' => 360],
+ ['format' => NumberFormat::LOWER_ROMAN, 'text' => '%9.', 'alignment' => 'right', 'tabPos' => 6480, 'left' => 6480, 'hanging' => 180],
+ ],
+ ];
+ }
+
+ return [
+ 'type' => 'hybridMultilevel',
+ 'levels' => [
+ ['format' => NumberFormat::BULLET, 'text' => '', 'alignment' => 'left', 'tabPos' => 720, 'left' => 720, 'hanging' => 360, 'font' => 'Symbol', 'hint' => 'default'],
+ ['format' => NumberFormat::BULLET, 'text' => 'o', 'alignment' => 'left', 'tabPos' => 1440, 'left' => 1440, 'hanging' => 360, 'font' => 'Courier New', 'hint' => 'default'],
+ ['format' => NumberFormat::BULLET, 'text' => '', 'alignment' => 'left', 'tabPos' => 2160, 'left' => 2160, 'hanging' => 360, 'font' => 'Wingdings', 'hint' => 'default'],
+ ['format' => NumberFormat::BULLET, 'text' => '', 'alignment' => 'left', 'tabPos' => 2880, 'left' => 2880, 'hanging' => 360, 'font' => 'Symbol', 'hint' => 'default'],
+ ['format' => NumberFormat::BULLET, 'text' => 'o', 'alignment' => 'left', 'tabPos' => 3600, 'left' => 3600, 'hanging' => 360, 'font' => 'Courier New', 'hint' => 'default'],
+ ['format' => NumberFormat::BULLET, 'text' => '', 'alignment' => 'left', 'tabPos' => 4320, 'left' => 4320, 'hanging' => 360, 'font' => 'Wingdings', 'hint' => 'default'],
+ ['format' => NumberFormat::BULLET, 'text' => '', 'alignment' => 'left', 'tabPos' => 5040, 'left' => 5040, 'hanging' => 360, 'font' => 'Symbol', 'hint' => 'default'],
+ ['format' => NumberFormat::BULLET, 'text' => 'o', 'alignment' => 'left', 'tabPos' => 5760, 'left' => 5760, 'hanging' => 360, 'font' => 'Courier New', 'hint' => 'default'],
+ ['format' => NumberFormat::BULLET, 'text' => '', 'alignment' => 'left', 'tabPos' => 6480, 'left' => 6480, 'hanging' => 360, 'font' => 'Wingdings', 'hint' => 'default'],
+ ],
+ ];
+ }
+
+ /**
+ * Parse list item node.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ * @param array &$styles
+ * @param array $data
+ *
+ * @todo This function is almost the same like `parseChildNodes`. Merged?
+ * @todo As soon as ListItem inherits from AbstractContainer or TextRun delete parsing part of childNodes
+ */
+ protected static function parseListItem($node, $element, &$styles, $data): void
+ {
+ $cNodes = $node->childNodes;
+ if (!empty($cNodes)) {
+ $listRun = $element->addListItemRun($data['listdepth'], $styles['list'], $styles['paragraph']);
+ foreach ($cNodes as $cNode) {
+ self::parseNode($cNode, $listRun, $styles, $data);
+ }
+ }
+ }
+
+ /**
+ * Parse style.
+ *
+ * @param DOMAttr $attribute
+ * @param array $styles
+ *
+ * @return array
+ */
+ protected static function parseStyle($attribute, $styles)
+ {
+ $properties = explode(';', trim($attribute->value, " \t\n\r\0\x0B;"));
+
+ $selectors = [];
+ foreach ($properties as $property) {
+ [$cKey, $cValue] = array_pad(explode(':', $property, 2), 2, null);
+ $selectors[strtolower(trim($cKey))] = trim($cValue ?? '');
+ }
+
+ return self::parseStyleDeclarations($selectors, $styles);
+ }
+
+ protected static function parseStyleDeclarations(array $selectors, array $styles)
+ {
+ $bidi = ($selectors['direction'] ?? '') === 'rtl';
+ foreach ($selectors as $property => $value) {
+ switch ($property) {
+ case 'text-decoration':
+ switch ($value) {
+ case 'underline':
+ $styles['underline'] = 'single';
+
+ break;
+ case 'line-through':
+ $styles['strikethrough'] = true;
+
+ break;
+ }
+
+ break;
+ case 'text-align':
+ $styles['alignment'] = self::mapAlign($value, $bidi);
+
+ break;
+ case 'display':
+ $styles['hidden'] = $value === 'none' || $value === 'hidden';
+
+ break;
+ case 'direction':
+ $styles['rtl'] = $value === 'rtl';
+ $styles['bidi'] = $value === 'rtl';
+
+ break;
+ case 'font-size':
+ $styles['size'] = Converter::cssToPoint($value);
+
+ break;
+ case 'font-family':
+ $value = array_map('trim', explode(',', $value));
+ $styles['name'] = ucwords($value[0]);
+
+ break;
+ case 'color':
+ $styles['color'] = self::convertRgb($value);
+
+ break;
+ case 'background-color':
+ $styles['bgColor'] = self::convertRgb($value);
+
+ break;
+ case 'line-height':
+ $matches = [];
+ if ($value === 'normal') {
+ $spacingLineRule = \PhpOffice\PhpWord\SimpleType\LineSpacingRule::AUTO;
+ $spacing = 0;
+ } elseif (preg_match('/([0-9]+\.?[0-9]*[a-z]+)/', $value, $matches)) {
+ //matches number with a unit, e.g. 12px, 15pt, 20mm, ...
+ $spacingLineRule = \PhpOffice\PhpWord\SimpleType\LineSpacingRule::EXACT;
+ $spacing = Converter::cssToTwip($matches[1]);
+ } elseif (preg_match('/([0-9]+)%/', $value, $matches)) {
+ //matches percentages
+ $spacingLineRule = \PhpOffice\PhpWord\SimpleType\LineSpacingRule::AUTO;
+ //we are subtracting 1 line height because the Spacing writer is adding one line
+ $spacing = ((((int) $matches[1]) / 100) * Paragraph::LINE_HEIGHT) - Paragraph::LINE_HEIGHT;
+ } else {
+ //any other, wich is a multiplier. E.g. 1.2
+ $spacingLineRule = \PhpOffice\PhpWord\SimpleType\LineSpacingRule::AUTO;
+ //we are subtracting 1 line height because the Spacing writer is adding one line
+ $spacing = ($value * Paragraph::LINE_HEIGHT) - Paragraph::LINE_HEIGHT;
+ }
+ $styles['spacingLineRule'] = $spacingLineRule;
+ $styles['line-spacing'] = $spacing;
+
+ break;
+ case 'letter-spacing':
+ $styles['letter-spacing'] = Converter::cssToTwip($value);
+
+ break;
+ case 'text-indent':
+ $styles['indentation']['firstLine'] = Converter::cssToTwip($value);
+
+ break;
+ case 'font-weight':
+ $tValue = false;
+ if (preg_match('#bold#', $value)) {
+ $tValue = true; // also match bolder
+ }
+ $styles['bold'] = $tValue;
+
+ break;
+ case 'font-style':
+ $tValue = false;
+ if (preg_match('#(?:italic|oblique)#', $value)) {
+ $tValue = true;
+ }
+ $styles['italic'] = $tValue;
+
+ break;
+ case 'font-variant':
+ $tValue = false;
+ if (preg_match('#small-caps#', $value)) {
+ $tValue = true;
+ }
+ $styles['smallCaps'] = $tValue;
+
+ break;
+ case 'margin':
+ $value = Converter::cssToTwip($value);
+ $styles['spaceBefore'] = $value;
+ $styles['spaceAfter'] = $value;
+
+ break;
+ case 'margin-top':
+ // BC change: up to ver. 0.17.0 incorrectly converted to points - Converter::cssToPoint($value)
+ $styles['spaceBefore'] = Converter::cssToTwip($value);
+
+ break;
+ case 'margin-bottom':
+ // BC change: up to ver. 0.17.0 incorrectly converted to points - Converter::cssToPoint($value)
+ $styles['spaceAfter'] = Converter::cssToTwip($value);
+
+ break;
+ case 'border-color':
+ self::mapBorderColor($styles, $value);
+
+ break;
+ case 'border-width':
+ $styles['borderSize'] = Converter::cssToPoint($value);
+
+ break;
+ case 'border-style':
+ $styles['borderStyle'] = self::mapBorderStyle($value);
+
+ break;
+ case 'width':
+ if (preg_match('/([0-9]+[a-z]+)/', $value, $matches)) {
+ $styles['width'] = Converter::cssToTwip($matches[1]);
+ $styles['unit'] = \PhpOffice\PhpWord\SimpleType\TblWidth::TWIP;
+ } elseif (preg_match('/([0-9]+)%/', $value, $matches)) {
+ $styles['width'] = $matches[1] * 50;
+ $styles['unit'] = \PhpOffice\PhpWord\SimpleType\TblWidth::PERCENT;
+ } elseif (preg_match('/([0-9]+)/', $value, $matches)) {
+ $styles['width'] = $matches[1];
+ $styles['unit'] = \PhpOffice\PhpWord\SimpleType\TblWidth::AUTO;
+ }
+
+ break;
+ case 'height':
+ $styles['height'] = Converter::cssToTwip($value);
+ $styles['exactHeight'] = true;
+
+ break;
+ case 'border':
+ case 'border-top':
+ case 'border-bottom':
+ case 'border-right':
+ case 'border-left':
+ // must have exact order [width color style], e.g. "1px #0011CC solid" or "2pt green solid"
+ // Word does not accept shortened hex colors e.g. #CCC, only full e.g. #CCCCCC
+ if (preg_match('/([0-9]+[^0-9]*)\s+(\#[a-fA-F0-9]+|[a-zA-Z]+)\s+([a-z]+)/', $value, $matches)) {
+ if (false !== strpos($property, '-')) {
+ $tmp = explode('-', $property);
+ $which = $tmp[1];
+ $which = ucfirst($which); // e.g. bottom -> Bottom
+ } else {
+ $which = '';
+ }
+ // Note - border width normalization:
+ // Width of border in Word is calculated differently than HTML borders, usually showing up too bold.
+ // Smallest 1px (or 1pt) appears in Word like 2-3px/pt in HTML once converted to twips.
+ // Therefore we need to normalize converted twip value to cca 1/2 of value.
+ // This may be adjusted, if better ratio or formula found.
+ // BC change: up to ver. 0.17.0 was $size converted to points - Converter::cssToPoint($size)
+ $size = Converter::cssToTwip($matches[1]);
+ $size = (int) ($size / 2);
+ // valid variants may be e.g. borderSize, borderTopSize, borderLeftColor, etc ..
+ $styles["border{$which}Size"] = $size; // twips
+ $styles["border{$which}Color"] = trim($matches[2], '#');
+ $styles["border{$which}Style"] = self::mapBorderStyle($matches[3]);
+ }
+
+ break;
+ case 'vertical-align':
+ // https://developer.mozilla.org/en-US/docs/Web/CSS/vertical-align
+ if (preg_match('#(?:top|bottom|middle|sub|baseline)#i', $value, $matches)) {
+ $styles['valign'] = self::mapAlignVertical($matches[0]);
+ }
+
+ break;
+ case 'page-break-after':
+ if ($value == 'always') {
+ $styles['isPageBreak'] = true;
+ }
+
+ break;
+ }
+ }
+
+ return $styles;
+ }
+
+ /**
+ * Parse image node.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ *
+ * @return \PhpOffice\PhpWord\Element\Image
+ */
+ protected static function parseImage($node, $element)
+ {
+ $style = [];
+ $src = null;
+ foreach ($node->attributes as $attribute) {
+ switch ($attribute->name) {
+ case 'src':
+ $src = $attribute->value;
+
+ break;
+ case 'width':
+ $width = $attribute->value;
+
+ // pt
+ if (false !== strpos($width, 'pt')) {
+ $width = Converter::pointToPixel((float) str_replace('pt', '', $width));
+ }
+
+ // px
+ if (false !== strpos($width, 'px')) {
+ $width = str_replace('px', '', $width);
+ }
+
+ $style['width'] = $width;
+ $style['unit'] = \PhpOffice\PhpWord\Style\Image::UNIT_PX;
+
+ break;
+ case 'height':
+ $height = $attribute->value;
+
+ // pt
+ if (false !== strpos($height, 'pt')) {
+ $height = Converter::pointToPixel((float) str_replace('pt', '', $height));
+ }
+
+ // px
+ if (false !== strpos($height, 'px')) {
+ $height = str_replace('px', '', $height);
+ }
+
+ $style['height'] = $height;
+ $style['unit'] = \PhpOffice\PhpWord\Style\Image::UNIT_PX;
+
+ break;
+ case 'style':
+ $styleattr = explode(';', $attribute->value);
+ foreach ($styleattr as $attr) {
+ if (strpos($attr, ':')) {
+ [$k, $v] = explode(':', $attr);
+ switch ($k) {
+ case 'float':
+ if (trim($v) == 'right') {
+ $style['hPos'] = \PhpOffice\PhpWord\Style\Image::POS_RIGHT;
+ $style['hPosRelTo'] = \PhpOffice\PhpWord\Style\Image::POS_RELTO_MARGIN; // inner section area
+ $style['pos'] = \PhpOffice\PhpWord\Style\Image::POS_RELATIVE;
+ $style['wrap'] = \PhpOffice\PhpWord\Style\Image::WRAP_TIGHT;
+ $style['overlap'] = true;
+ }
+ if (trim($v) == 'left') {
+ $style['hPos'] = \PhpOffice\PhpWord\Style\Image::POS_LEFT;
+ $style['hPosRelTo'] = \PhpOffice\PhpWord\Style\Image::POS_RELTO_MARGIN; // inner section area
+ $style['pos'] = \PhpOffice\PhpWord\Style\Image::POS_RELATIVE;
+ $style['wrap'] = \PhpOffice\PhpWord\Style\Image::WRAP_TIGHT;
+ $style['overlap'] = true;
+ }
+
+ break;
+ }
+ }
+ }
+
+ break;
+ }
+ }
+ $originSrc = $src;
+ if (strpos($src, 'data:image') !== false) {
+ $tmpDir = Settings::getTempDir() . '/';
+
+ $match = [];
+ preg_match('/data:image\/(\w+);base64,(.+)/', $src, $match);
+
+ $src = $imgFile = $tmpDir . uniqid() . '.' . $match[1];
+
+ $ifp = fopen($imgFile, 'wb');
+
+ if ($ifp !== false) {
+ fwrite($ifp, base64_decode($match[2]));
+ fclose($ifp);
+ }
+ }
+ $src = urldecode($src);
+
+ if (!is_file($src)
+ && null !== self::$options
+ && isset(self::$options['IMG_SRC_SEARCH'], self::$options['IMG_SRC_REPLACE'])
+ ) {
+ $src = str_replace(self::$options['IMG_SRC_SEARCH'], self::$options['IMG_SRC_REPLACE'], $src);
+ }
+
+ if (!is_file($src)) {
+ if ($imgBlob = @file_get_contents($src)) {
+ $tmpDir = Settings::getTempDir() . '/';
+ $match = [];
+ preg_match('/.+\.(\w+)$/', $src, $match);
+ $src = $tmpDir . uniqid();
+ if (isset($match[1])) {
+ $src .= '.' . $match[1];
+ }
+
+ $ifp = fopen($src, 'wb');
+
+ if ($ifp !== false) {
+ fwrite($ifp, $imgBlob);
+ fclose($ifp);
+ }
+ }
+ }
+
+ if (is_file($src)) {
+ $newElement = $element->addImage($src, $style);
+ } else {
+ throw new Exception("Could not load image $originSrc");
+ }
+
+ return $newElement;
+ }
+
+ /**
+ * Transforms a CSS border style into a word border style.
+ *
+ * @param string $cssBorderStyle
+ *
+ * @return null|string
+ */
+ protected static function mapBorderStyle($cssBorderStyle)
+ {
+ switch ($cssBorderStyle) {
+ case 'none':
+ case 'dashed':
+ case 'dotted':
+ case 'double':
+ return $cssBorderStyle;
+ default:
+ return 'single';
+ }
+ }
+
+ protected static function mapBorderColor(&$styles, $cssBorderColor): void
+ {
+ $numColors = substr_count($cssBorderColor, '#');
+ if ($numColors === 1) {
+ $styles['borderColor'] = trim($cssBorderColor, '#');
+ } elseif ($numColors > 1) {
+ $colors = explode(' ', $cssBorderColor);
+ $borders = ['borderTopColor', 'borderRightColor', 'borderBottomColor', 'borderLeftColor'];
+ for ($i = 0; $i < min(4, $numColors, count($colors)); ++$i) {
+ $styles[$borders[$i]] = trim($colors[$i], '#');
+ }
+ }
+ }
+
+ /**
+ * Transforms a HTML/CSS alignment into a \PhpOffice\PhpWord\SimpleType\Jc.
+ *
+ * @param string $cssAlignment
+ * @param bool $bidi
+ *
+ * @return null|string
+ */
+ protected static function mapAlign($cssAlignment, $bidi)
+ {
+ switch ($cssAlignment) {
+ case 'right':
+ return $bidi ? Jc::START : Jc::END;
+ case 'center':
+ return Jc::CENTER;
+ case 'justify':
+ return Jc::BOTH;
+ default:
+ return $bidi ? Jc::END : Jc::START;
+ }
+ }
+
+ /**
+ * Transforms a HTML/CSS vertical alignment.
+ *
+ * @param string $alignment
+ *
+ * @return null|string
+ */
+ protected static function mapAlignVertical($alignment)
+ {
+ $alignment = strtolower($alignment);
+ switch ($alignment) {
+ case 'top':
+ case 'baseline':
+ case 'bottom':
+ return $alignment;
+ case 'middle':
+ return 'center';
+ case 'sub':
+ return 'bottom';
+ case 'text-top':
+ case 'baseline':
+ return 'top';
+ default:
+ // @discuss - which one should apply:
+ // - Word uses default vert. alignment: top
+ // - all browsers use default vert. alignment: middle
+ // Returning empty string means attribute wont be set so use Word default (top).
+ return '';
+ }
+ }
+
+ /**
+ * Map list style for ordered list.
+ *
+ * @param string $cssListType
+ */
+ protected static function mapListType($cssListType)
+ {
+ switch ($cssListType) {
+ case 'a':
+ return NumberFormat::LOWER_LETTER; // a, b, c, ..
+ case 'A':
+ return NumberFormat::UPPER_LETTER; // A, B, C, ..
+ case 'i':
+ return NumberFormat::LOWER_ROMAN; // i, ii, iii, iv, ..
+ case 'I':
+ return NumberFormat::UPPER_ROMAN; // I, II, III, IV, ..
+ case '1':
+ default:
+ return NumberFormat::DECIMAL; // 1, 2, 3, ..
+ }
+ }
+
+ /**
+ * Parse line break.
+ *
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ */
+ protected static function parseLineBreak($element): void
+ {
+ $element->addTextBreak();
+ }
+
+ /**
+ * Parse link node.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ * @param array $styles
+ */
+ protected static function parseLink($node, $element, &$styles)
+ {
+ $target = null;
+ foreach ($node->attributes as $attribute) {
+ switch ($attribute->name) {
+ case 'href':
+ $target = $attribute->value;
+
+ break;
+ }
+ }
+ $styles['font'] = self::parseInlineStyle($node, $styles['font']);
+
+ if (empty($target)) {
+ $target = '#';
+ }
+
+ if (strpos($target, '#') === 0 && strlen($target) > 1) {
+ return $element->addLink(substr($target, 1), $node->textContent, $styles['font'], $styles['paragraph'], true);
+ }
+
+ return $element->addLink($target, $node->textContent, $styles['font'], $styles['paragraph']);
+ }
+
+ /**
+ * Render horizontal rule
+ * Note: Word rule is not the same as HTML's
since it does not support width and thus neither alignment.
+ *
+ * @param DOMNode $node
+ * @param \PhpOffice\PhpWord\Element\AbstractContainer $element
+ */
+ protected static function parseHorizRule($node, $element): void
+ {
+ $styles = self::parseInlineStyle($node);
+
+ //
is implemented as an empty paragraph - extending 100% inside the section
+ // Some properties may be controlled, e.g.
+
+ $fontStyle = $styles + ['size' => 3];
+
+ $paragraphStyle = $styles + [
+ 'lineHeight' => 0.25, // multiply default line height - e.g. 1, 1.5 etc
+ 'spacing' => 0, // twip
+ 'spaceBefore' => 120, // twip, 240/2 (default line height)
+ 'spaceAfter' => 120, // twip
+ 'borderBottomSize' => empty($styles['line-height']) ? 1 : $styles['line-height'],
+ 'borderBottomColor' => empty($styles['color']) ? '000000' : $styles['color'],
+ 'borderBottomStyle' => 'single', // same as "solid"
+ ];
+
+ $element->addText('', $fontStyle, $paragraphStyle);
+
+ // Notes:
cannot be:
+ // - table - throws error "cannot be inside textruns", e.g. lists
+ // - line - that is a shape, has different behaviour
+ // - repeated text, e.g. underline "_", because of unpredictable line wrapping
+ }
+
+ private static function convertRgb(string $rgb): string
+ {
+ if (preg_match(self::RGB_REGEXP, $rgb, $matches) === 1) {
+ return sprintf('%02X%02X%02X', $matches[1], $matches[2], $matches[3]);
+ }
+
+ return trim($rgb, '# ');
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Shared/Microsoft/PasswordEncoder.php b/vendor/phpoffice/phpword/src/PhpWord/Shared/Microsoft/PasswordEncoder.php
new file mode 100644
index 00000000..d6cf69fc
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Shared/Microsoft/PasswordEncoder.php
@@ -0,0 +1,246 @@
+ 4) ? 0xFFFFFFFF : -1;
+ private const HIGH_ORDER_BIT = (PHP_INT_SIZE > 4) ? 0x80000000 : PHP_INT_MIN;
+
+ /**
+ * Mapping between algorithm name and algorithm ID.
+ *
+ * @var array
+ *
+ * @see https://msdn.microsoft.com/en-us/library/documentformat.openxml.wordprocessing.writeprotection.cryptographicalgorithmsid(v=office.14).aspx
+ */
+ private static $algorithmMapping = [
+ self::ALGORITHM_MD2 => [1, 'md2'],
+ self::ALGORITHM_MD4 => [2, 'md4'],
+ self::ALGORITHM_MD5 => [3, 'md5'],
+ self::ALGORITHM_SHA_1 => [4, 'sha1'],
+ self::ALGORITHM_MAC => [5, ''], // 'mac' -> not possible with hash()
+ self::ALGORITHM_RIPEMD => [6, 'ripemd'],
+ self::ALGORITHM_RIPEMD_160 => [7, 'ripemd160'],
+ self::ALGORITHM_HMAC => [9, ''], //'hmac' -> not possible with hash()
+ self::ALGORITHM_SHA_256 => [12, 'sha256'],
+ self::ALGORITHM_SHA_384 => [13, 'sha384'],
+ self::ALGORITHM_SHA_512 => [14, 'sha512'],
+ ];
+
+ private static $initialCodeArray = [
+ 0xE1F0,
+ 0x1D0F,
+ 0xCC9C,
+ 0x84C0,
+ 0x110C,
+ 0x0E10,
+ 0xF1CE,
+ 0x313E,
+ 0x1872,
+ 0xE139,
+ 0xD40F,
+ 0x84F9,
+ 0x280C,
+ 0xA96A,
+ 0x4EC3,
+ ];
+
+ private static $encryptionMatrix = [
+ [0xAEFC, 0x4DD9, 0x9BB2, 0x2745, 0x4E8A, 0x9D14, 0x2A09],
+ [0x7B61, 0xF6C2, 0xFDA5, 0xEB6B, 0xC6F7, 0x9DCF, 0x2BBF],
+ [0x4563, 0x8AC6, 0x05AD, 0x0B5A, 0x16B4, 0x2D68, 0x5AD0],
+ [0x0375, 0x06EA, 0x0DD4, 0x1BA8, 0x3750, 0x6EA0, 0xDD40],
+ [0xD849, 0xA0B3, 0x5147, 0xA28E, 0x553D, 0xAA7A, 0x44D5],
+ [0x6F45, 0xDE8A, 0xAD35, 0x4A4B, 0x9496, 0x390D, 0x721A],
+ [0xEB23, 0xC667, 0x9CEF, 0x29FF, 0x53FE, 0xA7FC, 0x5FD9],
+ [0x47D3, 0x8FA6, 0x0F6D, 0x1EDA, 0x3DB4, 0x7B68, 0xF6D0],
+ [0xB861, 0x60E3, 0xC1C6, 0x93AD, 0x377B, 0x6EF6, 0xDDEC],
+ [0x45A0, 0x8B40, 0x06A1, 0x0D42, 0x1A84, 0x3508, 0x6A10],
+ [0xAA51, 0x4483, 0x8906, 0x022D, 0x045A, 0x08B4, 0x1168],
+ [0x76B4, 0xED68, 0xCAF1, 0x85C3, 0x1BA7, 0x374E, 0x6E9C],
+ [0x3730, 0x6E60, 0xDCC0, 0xA9A1, 0x4363, 0x86C6, 0x1DAD],
+ [0x3331, 0x6662, 0xCCC4, 0x89A9, 0x0373, 0x06E6, 0x0DCC],
+ [0x1021, 0x2042, 0x4084, 0x8108, 0x1231, 0x2462, 0x48C4],
+ ];
+
+ private static $passwordMaxLength = 15;
+
+ /**
+ * Create a hashed password that MS Word will be able to work with.
+ *
+ * @see https://blogs.msdn.microsoft.com/vsod/2010/04/05/how-to-set-the-editing-restrictions-in-word-using-open-xml-sdk-2-0/
+ *
+ * @param string $password
+ * @param string $algorithmName
+ * @param string $salt
+ * @param int $spinCount
+ *
+ * @return string
+ */
+ public static function hashPassword($password, $algorithmName = self::ALGORITHM_SHA_1, $salt = null, $spinCount = 10000)
+ {
+ $origEncoding = mb_internal_encoding();
+ mb_internal_encoding('UTF-8');
+
+ $password = mb_substr($password, 0, min(self::$passwordMaxLength, mb_strlen($password)));
+
+ // Get the single-byte values by iterating through the Unicode characters of the truncated password.
+ // For each character, if the low byte is not equal to 0, take it. Otherwise, take the high byte.
+ $passUtf8 = mb_convert_encoding($password, 'UCS-2LE', 'UTF-8');
+ $byteChars = [];
+
+ for ($i = 0; $i < mb_strlen($password); ++$i) {
+ $byteChars[$i] = ord(substr($passUtf8, $i * 2, 1));
+
+ if ($byteChars[$i] == 0) {
+ $byteChars[$i] = ord(substr($passUtf8, $i * 2 + 1, 1));
+ }
+ }
+
+ // build low-order word and hig-order word and combine them
+ $combinedKey = self::buildCombinedKey($byteChars);
+ // build reversed hexadecimal string
+ $hex = str_pad(strtoupper(dechex($combinedKey & self::ALL_ONE_BITS)), 8, '0', \STR_PAD_LEFT);
+ $reversedHex = $hex[6] . $hex[7] . $hex[4] . $hex[5] . $hex[2] . $hex[3] . $hex[0] . $hex[1];
+
+ $generatedKey = mb_convert_encoding($reversedHex, 'UCS-2LE', 'UTF-8');
+
+ // Implementation Notes List:
+ // Word requires that the initial hash of the password with the salt not be considered in the count.
+ // The initial hash of salt + key is not included in the iteration count.
+ $algorithm = self::getAlgorithm($algorithmName);
+ $generatedKey = hash($algorithm, $salt . $generatedKey, true);
+
+ for ($i = 0; $i < $spinCount; ++$i) {
+ $generatedKey = hash($algorithm, $generatedKey . pack('CCCC', $i, $i >> 8, $i >> 16, $i >> 24), true);
+ }
+ $generatedKey = base64_encode($generatedKey);
+
+ mb_internal_encoding($origEncoding);
+
+ return $generatedKey;
+ }
+
+ /**
+ * Get algorithm from self::$algorithmMapping.
+ *
+ * @param string $algorithmName
+ *
+ * @return string
+ */
+ private static function getAlgorithm($algorithmName)
+ {
+ $algorithm = self::$algorithmMapping[$algorithmName][1];
+ if ($algorithm == '') {
+ $algorithm = 'sha1';
+ }
+
+ return $algorithm;
+ }
+
+ /**
+ * Returns the algorithm ID.
+ *
+ * @param string $algorithmName
+ *
+ * @return int
+ */
+ public static function getAlgorithmId($algorithmName)
+ {
+ return self::$algorithmMapping[$algorithmName][0];
+ }
+
+ /**
+ * Build combined key from low-order word and high-order word.
+ *
+ * @param array $byteChars byte array representation of password
+ *
+ * @return int
+ */
+ private static function buildCombinedKey($byteChars)
+ {
+ $byteCharsLength = count($byteChars);
+ // Compute the high-order word
+ // Initialize from the initial code array (see above), depending on the passwords length.
+ $highOrderWord = self::$initialCodeArray[$byteCharsLength - 1];
+
+ // For each character in the password:
+ // For every bit in the character, starting with the least significant and progressing to (but excluding)
+ // the most significant, if the bit is set, XOR the key’s high-order word with the corresponding word from
+ // the Encryption Matrix
+ for ($i = 0; $i < $byteCharsLength; ++$i) {
+ $tmp = self::$passwordMaxLength - $byteCharsLength + $i;
+ $matrixRow = self::$encryptionMatrix[$tmp];
+ for ($intBit = 0; $intBit < 7; ++$intBit) {
+ if (($byteChars[$i] & (0x0001 << $intBit)) != 0) {
+ $highOrderWord = ($highOrderWord ^ $matrixRow[$intBit]);
+ }
+ }
+ }
+
+ // Compute low-order word
+ // Initialize with 0
+ $lowOrderWord = 0;
+ // For each character in the password, going backwards
+ for ($i = $byteCharsLength - 1; $i >= 0; --$i) {
+ // low-order word = (((low-order word SHR 14) AND 0x0001) OR (low-order word SHL 1) AND 0x7FFF)) XOR character
+ $lowOrderWord = (((($lowOrderWord >> 14) & 0x0001) | (($lowOrderWord << 1) & 0x7FFF)) ^ $byteChars[$i]);
+ }
+ // Lastly, low-order word = (((low-order word SHR 14) AND 0x0001) OR (low-order word SHL 1) AND 0x7FFF)) XOR strPassword length XOR 0xCE4B.
+ $lowOrderWord = (((($lowOrderWord >> 14) & 0x0001) | (($lowOrderWord << 1) & 0x7FFF)) ^ $byteCharsLength ^ 0xCE4B);
+
+ // Combine the Low and High Order Word
+ return self::int32(($highOrderWord << 16) + $lowOrderWord);
+ }
+
+ /**
+ * Simulate behaviour of (signed) int32.
+ *
+ * @codeCoverageIgnore
+ *
+ * @param int $value
+ *
+ * @return int
+ */
+ private static function int32($value)
+ {
+ $value = $value & self::ALL_ONE_BITS;
+
+ if ($value & self::HIGH_ORDER_BIT) {
+ $value = -((~$value & self::ALL_ONE_BITS) + 1);
+ }
+
+ return $value;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Shared/OLERead.php b/vendor/phpoffice/phpword/src/PhpWord/Shared/OLERead.php
new file mode 100644
index 00000000..d4399d6f
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Shared/OLERead.php
@@ -0,0 +1,334 @@
+data = file_get_contents($sFileName, false, null, 0, 8);
+
+ // Check OLE identifier
+ if ($this->data != self::IDENTIFIER_OLE) {
+ throw new Exception('The filename ' . $sFileName . ' is not recognised as an OLE file');
+ }
+
+ // Get the file data
+ $this->data = file_get_contents($sFileName);
+
+ // Total number of sectors used for the SAT
+ $this->numBigBlockDepotBlocks = self::getInt4d($this->data, self::NUM_BIG_BLOCK_DEPOT_BLOCKS_POS);
+
+ // SecID of the first sector of the directory stream
+ $this->rootStartBlock = self::getInt4d($this->data, self::ROOT_START_BLOCK_POS);
+
+ // SecID of the first sector of the SSAT (or -2 if not extant)
+ $this->sbdStartBlock = self::getInt4d($this->data, self::SMALL_BLOCK_DEPOT_BLOCK_POS);
+
+ // SecID of the first sector of the MSAT (or -2 if no additional sectors are used)
+ $this->extensionBlock = self::getInt4d($this->data, self::EXTENSION_BLOCK_POS);
+
+ // Total number of sectors used by MSAT
+ $this->numExtensionBlocks = self::getInt4d($this->data, self::NUM_EXTENSION_BLOCK_POS);
+
+ $bigBlockDepotBlocks = array();
+ $pos = self::BIG_BLOCK_DEPOT_BLOCKS_POS;
+
+ $bbdBlocks = $this->numBigBlockDepotBlocks;
+
+ // @codeCoverageIgnoreStart
+ if ($this->numExtensionBlocks != 0) {
+ $bbdBlocks = (self::BIG_BLOCK_SIZE - self::BIG_BLOCK_DEPOT_BLOCKS_POS) / 4;
+ }
+ // @codeCoverageIgnoreEnd
+
+ for ($i = 0; $i < $bbdBlocks; ++$i) {
+ $bigBlockDepotBlocks[$i] = self::getInt4d($this->data, $pos);
+ $pos += 4;
+ }
+
+ // @codeCoverageIgnoreStart
+ for ($j = 0; $j < $this->numExtensionBlocks; ++$j) {
+ $pos = ($this->extensionBlock + 1) * self::BIG_BLOCK_SIZE;
+ $blocksToRead = min($this->numBigBlockDepotBlocks - $bbdBlocks, self::BIG_BLOCK_SIZE / 4 - 1);
+
+ for ($i = $bbdBlocks; $i < $bbdBlocks + $blocksToRead; ++$i) {
+ $bigBlockDepotBlocks[$i] = self::getInt4d($this->data, $pos);
+ $pos += 4;
+ }
+
+ $bbdBlocks += $blocksToRead;
+ if ($bbdBlocks < $this->numBigBlockDepotBlocks) {
+ $this->extensionBlock = self::getInt4d($this->data, $pos);
+ }
+ }
+ // @codeCoverageIgnoreEnd
+
+ $pos = 0;
+ $this->bigBlockChain = '';
+ $bbs = self::BIG_BLOCK_SIZE / 4;
+ for ($i = 0; $i < $this->numBigBlockDepotBlocks; ++$i) {
+ $pos = ($bigBlockDepotBlocks[$i] + 1) * self::BIG_BLOCK_SIZE;
+
+ $this->bigBlockChain .= substr($this->data, $pos, 4 * $bbs);
+ $pos += 4 * $bbs;
+ }
+
+ $pos = 0;
+ $sbdBlock = $this->sbdStartBlock;
+ $this->smallBlockChain = '';
+ while ($sbdBlock != -2) {
+ $pos = ($sbdBlock + 1) * self::BIG_BLOCK_SIZE;
+
+ $this->smallBlockChain .= substr($this->data, $pos, 4 * $bbs);
+ $pos += 4 * $bbs;
+
+ $sbdBlock = self::getInt4d($this->bigBlockChain, $sbdBlock * 4);
+ }
+
+ // read the directory stream
+ $block = $this->rootStartBlock;
+ $this->entry = $this->readData($block);
+
+ $this->readPropertySets();
+ }
+
+ /**
+ * Extract binary stream data
+ *
+ * @param mixed $stream
+ * @return string
+ */
+ public function getStream($stream)
+ {
+ if ($stream === null) {
+ return null;
+ }
+
+ $streamData = '';
+
+ if ($this->props[$stream]['size'] < self::SMALL_BLOCK_THRESHOLD) {
+ $rootdata = $this->readData($this->props[$this->rootentry]['startBlock']);
+
+ $block = $this->props[$stream]['startBlock'];
+
+ while ($block != -2) {
+ $pos = $block * self::SMALL_BLOCK_SIZE;
+ $streamData .= substr($rootdata, $pos, self::SMALL_BLOCK_SIZE);
+
+ $block = self::getInt4d($this->smallBlockChain, $block * 4);
+ }
+
+ return $streamData;
+ }
+
+ $numBlocks = $this->props[$stream]['size'] / self::BIG_BLOCK_SIZE;
+ if ($this->props[$stream]['size'] % self::BIG_BLOCK_SIZE != 0) {
+ ++$numBlocks;
+ }
+
+ if ($numBlocks == 0) {
+ return ''; // @codeCoverageIgnore
+ }
+
+ $block = $this->props[$stream]['startBlock'];
+
+ while ($block != -2) {
+ $pos = ($block + 1) * self::BIG_BLOCK_SIZE;
+ $streamData .= substr($this->data, $pos, self::BIG_BLOCK_SIZE);
+ $block = self::getInt4d($this->bigBlockChain, $block * 4);
+ }
+
+ return $streamData;
+ }
+
+ /**
+ * Read a standard stream (by joining sectors using information from SAT)
+ *
+ * @param int $blSectorId Sector ID where the stream starts
+ * @return string Data for standard stream
+ */
+ private function readData($blSectorId)
+ {
+ $block = $blSectorId;
+ $data = '';
+
+ while ($block != -2) {
+ $pos = ($block + 1) * self::BIG_BLOCK_SIZE;
+ $data .= substr($this->data, $pos, self::BIG_BLOCK_SIZE);
+ $block = self::getInt4d($this->bigBlockChain, $block * 4);
+ }
+
+ return $data;
+ }
+
+ /**
+ * Read entries in the directory stream.
+ */
+ private function readPropertySets()
+ {
+ $offset = 0;
+
+ // loop through entires, each entry is 128 bytes
+ $entryLen = strlen($this->entry);
+ while ($offset < $entryLen) {
+ // entry data (128 bytes)
+ $data = substr($this->entry, $offset, self::PROPERTY_STORAGE_BLOCK_SIZE);
+
+ // size in bytes of name
+ $nameSize = ord($data[self::SIZE_OF_NAME_POS]) | (ord($data[self::SIZE_OF_NAME_POS + 1]) << 8);
+
+ // type of entry
+ $type = ord($data[self::TYPE_POS]);
+
+ // sectorID of first sector or short sector, if this entry refers to a stream (the case with workbook)
+ // sectorID of first sector of the short-stream container stream, if this entry is root entry
+ $startBlock = self::getInt4d($data, self::START_BLOCK_POS);
+
+ $size = self::getInt4d($data, self::SIZE_POS);
+
+ $name = str_replace("\x00", '', substr($data, 0, $nameSize));
+
+ $this->props[] = array(
+ 'name' => $name,
+ 'type' => $type,
+ 'startBlock' => $startBlock,
+ 'size' => $size, );
+
+ // tmp helper to simplify checks
+ $upName = strtoupper($name);
+
+ // Workbook directory entry (BIFF5 uses Book, BIFF8 uses Workbook)
+ // print_r($upName.PHP_EOL);
+ if (($upName === 'WORDDOCUMENT')) {
+ $this->wrkdocument = count($this->props) - 1;
+ } elseif ($upName === '1TABLE') {
+ $this->wrk1Table = count($this->props) - 1;
+ } elseif ($upName === 'DATA') {
+ $this->wrkData = count($this->props) - 1;
+ } elseif ($upName === 'OBJECTPOOL') {
+ $this->wrkObjectPoolelseif = count($this->props) - 1;
+ } elseif ($upName === 'ROOT ENTRY' || $upName === 'R') {
+ $this->rootentry = count($this->props) - 1;
+ }
+
+ // Summary information
+ if ($name == chr(5) . 'SummaryInformation') {
+ $this->summaryInformation = count($this->props) - 1;
+ }
+
+ // Additional Document Summary information
+ if ($name == chr(5) . 'DocumentSummaryInformation') {
+ $this->docSummaryInfos = count($this->props) - 1;
+ }
+
+ $offset += self::PROPERTY_STORAGE_BLOCK_SIZE;
+ }
+ }
+
+ /**
+ * Read 4 bytes of data at specified position
+ *
+ * @param string $data
+ * @param int $pos
+ * @return int
+ */
+ private static function getInt4d($data, $pos)
+ {
+ // FIX: represent numbers correctly on 64-bit system
+ // http://sourceforge.net/tracker/index.php?func=detail&aid=1487372&group_id=99160&atid=623334
+ // Hacked by Andreas Rehm 2006 to ensure correct result of the <<24 block on 32 and 64bit systems
+ $or24 = ord($data[$pos + 3]);
+ if ($or24 >= 128) {
+ // negative number
+ $ord24 = -abs((256 - $or24) << 24);
+ } else {
+ $ord24 = ($or24 & 127) << 24;
+ }
+
+ return ord($data[$pos]) | (ord($data[$pos + 1]) << 8) | (ord($data[$pos + 2]) << 16) | $ord24;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Shared/PCLZip/pclzip.lib.php b/vendor/phpoffice/phpword/src/PhpWord/Shared/PCLZip/pclzip.lib.php
new file mode 100644
index 00000000..5243b3c3
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Shared/PCLZip/pclzip.lib.php
@@ -0,0 +1,5392 @@
+zipname = $p_zipname;
+ $this->zip_fd = 0;
+ $this->magic_quotes_status = -1;
+
+ // ----- Return
+ return;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function :
+ // create($p_filelist, $p_add_dir="", $p_remove_dir="")
+ // create($p_filelist, $p_option, $p_option_value, ...)
+ // Description :
+ // This method supports two different synopsis. The first one is historical.
+ // This method creates a Zip Archive. The Zip file is created in the
+ // filesystem. The files and directories indicated in $p_filelist
+ // are added in the archive. See the parameters description for the
+ // supported format of $p_filelist.
+ // When a directory is in the list, the directory and its content is added
+ // in the archive.
+ // In this synopsis, the function takes an optional variable list of
+ // options. See bellow the supported options.
+ // Parameters :
+ // $p_filelist : An array containing file or directory names, or
+ // a string containing one filename or one directory name, or
+ // a string containing a list of filenames and/or directory
+ // names separated by spaces.
+ // $p_add_dir : A path to add before the real path of the archived file,
+ // in order to have it memorized in the archive.
+ // $p_remove_dir : A path to remove from the real path of the file to archive,
+ // in order to have a shorter path memorized in the archive.
+ // When $p_add_dir and $p_remove_dir are set, $p_remove_dir
+ // is removed first, before $p_add_dir is added.
+ // Options :
+ // PCLZIP_OPT_ADD_PATH :
+ // PCLZIP_OPT_REMOVE_PATH :
+ // PCLZIP_OPT_REMOVE_ALL_PATH :
+ // PCLZIP_OPT_COMMENT :
+ // PCLZIP_CB_PRE_ADD :
+ // PCLZIP_CB_POST_ADD :
+ // Return Values :
+ // 0 on failure,
+ // The list of the added files, with a status of the add action.
+ // (see PclZip::listContent() for list entry format)
+ // --------------------------------------------------------------------------------
+ public function create($p_filelist)
+ {
+ $v_result = 1;
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Set default values
+ $v_options = array();
+ $v_options[PCLZIP_OPT_NO_COMPRESSION] = false;
+
+ // ----- Look for variable options arguments
+ $v_size = func_num_args();
+
+ // ----- Look for arguments
+ if ($v_size > 1) {
+ // ----- Get the arguments
+ $v_arg_list = func_get_args();
+
+ // ----- Remove from the options list the first argument
+ array_shift($v_arg_list);
+ $v_size--;
+
+ // ----- Look for first arg
+ if ((is_integer($v_arg_list[0])) && ($v_arg_list[0] > 77000)) {
+
+ // ----- Parse the options
+ $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, array(
+ PCLZIP_OPT_REMOVE_PATH => 'optional',
+ PCLZIP_OPT_REMOVE_ALL_PATH => 'optional',
+ PCLZIP_OPT_ADD_PATH => 'optional',
+ PCLZIP_CB_PRE_ADD => 'optional',
+ PCLZIP_CB_POST_ADD => 'optional',
+ PCLZIP_OPT_NO_COMPRESSION => 'optional',
+ PCLZIP_OPT_COMMENT => 'optional',
+ PCLZIP_OPT_TEMP_FILE_THRESHOLD => 'optional',
+ PCLZIP_OPT_TEMP_FILE_ON => 'optional',
+ PCLZIP_OPT_TEMP_FILE_OFF => 'optional'
+ //, PCLZIP_OPT_CRYPT => 'optional'
+ ));
+ if ($v_result != 1) {
+ return 0;
+ }
+
+ // ----- Look for 2 args
+ // Here we need to support the first historic synopsis of the
+ // method.
+ } else {
+
+ // ----- Get the first argument
+ $v_options[PCLZIP_OPT_ADD_PATH] = $v_arg_list[0];
+
+ // ----- Look for the optional second argument
+ if ($v_size == 2) {
+ $v_options[PCLZIP_OPT_REMOVE_PATH] = $v_arg_list[1];
+ } elseif ($v_size > 2) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid number / type of arguments");
+
+ return 0;
+ }
+ }
+ }
+
+ // ----- Look for default option values
+ $this->privOptionDefaultThreshold($v_options);
+
+ // ----- Init
+ $v_string_list = array();
+ $v_att_list = array();
+ $v_filedescr_list = array();
+ $p_result_list = array();
+
+ // ----- Look if the $p_filelist is really an array
+ if (is_array($p_filelist)) {
+
+ // ----- Look if the first element is also an array
+ // This will mean that this is a file description entry
+ if (isset($p_filelist[0]) && is_array($p_filelist[0])) {
+ $v_att_list = $p_filelist;
+
+ // ----- The list is a list of string names
+ } else {
+ $v_string_list = $p_filelist;
+ }
+
+ // ----- Look if the $p_filelist is a string
+ } elseif (is_string($p_filelist)) {
+ // ----- Create a list from the string
+ $v_string_list = explode(PCLZIP_SEPARATOR, $p_filelist);
+
+ // ----- Invalid variable type for $p_filelist
+ } else {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid variable type p_filelist");
+
+ return 0;
+ }
+
+ // ----- Reformat the string list
+ if (sizeof($v_string_list) != 0) {
+ foreach ($v_string_list as $v_string) {
+ if ($v_string != '') {
+ $v_att_list[][PCLZIP_ATT_FILE_NAME] = $v_string;
+ } else {
+ }
+ }
+ }
+
+ // ----- For each file in the list check the attributes
+ $v_supported_attributes = array(
+ PCLZIP_ATT_FILE_NAME => 'mandatory',
+ PCLZIP_ATT_FILE_NEW_SHORT_NAME => 'optional',
+ PCLZIP_ATT_FILE_NEW_FULL_NAME => 'optional',
+ PCLZIP_ATT_FILE_MTIME => 'optional',
+ PCLZIP_ATT_FILE_CONTENT => 'optional',
+ PCLZIP_ATT_FILE_COMMENT => 'optional'
+ );
+ foreach ($v_att_list as $v_entry) {
+ $v_result = $this->privFileDescrParseAtt($v_entry, $v_filedescr_list[], $v_options, $v_supported_attributes);
+ if ($v_result != 1) {
+ return 0;
+ }
+ }
+
+ // ----- Expand the filelist (expand directories)
+ $v_result = $this->privFileDescrExpand($v_filedescr_list, $v_options);
+ if ($v_result != 1) {
+ return 0;
+ }
+
+ // ----- Call the create fct
+ $v_result = $this->privCreate($v_filedescr_list, $p_result_list, $v_options);
+ if ($v_result != 1) {
+ return 0;
+ }
+
+ // ----- Return
+ return $p_result_list;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function :
+ // add($p_filelist, $p_add_dir="", $p_remove_dir="")
+ // add($p_filelist, $p_option, $p_option_value, ...)
+ // Description :
+ // This method supports two synopsis. The first one is historical.
+ // This methods add the list of files in an existing archive.
+ // If a file with the same name already exists, it is added at the end of the
+ // archive, the first one is still present.
+ // If the archive does not exist, it is created.
+ // Parameters :
+ // $p_filelist : An array containing file or directory names, or
+ // a string containing one filename or one directory name, or
+ // a string containing a list of filenames and/or directory
+ // names separated by spaces.
+ // $p_add_dir : A path to add before the real path of the archived file,
+ // in order to have it memorized in the archive.
+ // $p_remove_dir : A path to remove from the real path of the file to archive,
+ // in order to have a shorter path memorized in the archive.
+ // When $p_add_dir and $p_remove_dir are set, $p_remove_dir
+ // is removed first, before $p_add_dir is added.
+ // Options :
+ // PCLZIP_OPT_ADD_PATH :
+ // PCLZIP_OPT_REMOVE_PATH :
+ // PCLZIP_OPT_REMOVE_ALL_PATH :
+ // PCLZIP_OPT_COMMENT :
+ // PCLZIP_OPT_ADD_COMMENT :
+ // PCLZIP_OPT_PREPEND_COMMENT :
+ // PCLZIP_CB_PRE_ADD :
+ // PCLZIP_CB_POST_ADD :
+ // Return Values :
+ // 0 on failure,
+ // The list of the added files, with a status of the add action.
+ // (see PclZip::listContent() for list entry format)
+ // --------------------------------------------------------------------------------
+ public function add($p_filelist)
+ {
+ $v_result = 1;
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Set default values
+ $v_options = array();
+ $v_options[PCLZIP_OPT_NO_COMPRESSION] = false;
+
+ // ----- Look for variable options arguments
+ $v_size = func_num_args();
+
+ // ----- Look for arguments
+ if ($v_size > 1) {
+ // ----- Get the arguments
+ $v_arg_list = func_get_args();
+
+ // ----- Remove form the options list the first argument
+ array_shift($v_arg_list);
+ $v_size--;
+
+ // ----- Look for first arg
+ if ((is_integer($v_arg_list[0])) && ($v_arg_list[0] > 77000)) {
+
+ // ----- Parse the options
+ $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, array(
+ PCLZIP_OPT_REMOVE_PATH => 'optional',
+ PCLZIP_OPT_REMOVE_ALL_PATH => 'optional',
+ PCLZIP_OPT_ADD_PATH => 'optional',
+ PCLZIP_CB_PRE_ADD => 'optional',
+ PCLZIP_CB_POST_ADD => 'optional',
+ PCLZIP_OPT_NO_COMPRESSION => 'optional',
+ PCLZIP_OPT_COMMENT => 'optional',
+ PCLZIP_OPT_ADD_COMMENT => 'optional',
+ PCLZIP_OPT_PREPEND_COMMENT => 'optional',
+ PCLZIP_OPT_TEMP_FILE_THRESHOLD => 'optional',
+ PCLZIP_OPT_TEMP_FILE_ON => 'optional',
+ PCLZIP_OPT_TEMP_FILE_OFF => 'optional'
+ //, PCLZIP_OPT_CRYPT => 'optional'
+ ));
+ if ($v_result != 1) {
+ return 0;
+ }
+
+ // ----- Look for 2 args
+ // Here we need to support the first historic synopsis of the
+ // method.
+ } else {
+
+ // ----- Get the first argument
+ $v_options[PCLZIP_OPT_ADD_PATH] = $v_add_path = $v_arg_list[0];
+
+ // ----- Look for the optional second argument
+ if ($v_size == 2) {
+ $v_options[PCLZIP_OPT_REMOVE_PATH] = $v_arg_list[1];
+ } elseif ($v_size > 2) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid number / type of arguments");
+
+ // ----- Return
+ return 0;
+ }
+ }
+ }
+
+ // ----- Look for default option values
+ $this->privOptionDefaultThreshold($v_options);
+
+ // ----- Init
+ $v_string_list = array();
+ $v_att_list = array();
+ $v_filedescr_list = array();
+ $p_result_list = array();
+
+ // ----- Look if the $p_filelist is really an array
+ if (is_array($p_filelist)) {
+
+ // ----- Look if the first element is also an array
+ // This will mean that this is a file description entry
+ if (isset($p_filelist[0]) && is_array($p_filelist[0])) {
+ $v_att_list = $p_filelist;
+
+ // ----- The list is a list of string names
+ } else {
+ $v_string_list = $p_filelist;
+ }
+
+ // ----- Look if the $p_filelist is a string
+ } elseif (is_string($p_filelist)) {
+ // ----- Create a list from the string
+ $v_string_list = explode(PCLZIP_SEPARATOR, $p_filelist);
+
+ // ----- Invalid variable type for $p_filelist
+ } else {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid variable type '" . gettype($p_filelist) . "' for p_filelist");
+
+ return 0;
+ }
+
+ // ----- Reformat the string list
+ if (sizeof($v_string_list) != 0) {
+ foreach ($v_string_list as $v_string) {
+ $v_att_list[][PCLZIP_ATT_FILE_NAME] = $v_string;
+ }
+ }
+
+ // ----- For each file in the list check the attributes
+ $v_supported_attributes = array(
+ PCLZIP_ATT_FILE_NAME => 'mandatory',
+ PCLZIP_ATT_FILE_NEW_SHORT_NAME => 'optional',
+ PCLZIP_ATT_FILE_NEW_FULL_NAME => 'optional',
+ PCLZIP_ATT_FILE_MTIME => 'optional',
+ PCLZIP_ATT_FILE_CONTENT => 'optional',
+ PCLZIP_ATT_FILE_COMMENT => 'optional'
+ );
+ foreach ($v_att_list as $v_entry) {
+ $v_result = $this->privFileDescrParseAtt($v_entry, $v_filedescr_list[], $v_options, $v_supported_attributes);
+ if ($v_result != 1) {
+ return 0;
+ }
+ }
+
+ // ----- Expand the filelist (expand directories)
+ $v_result = $this->privFileDescrExpand($v_filedescr_list, $v_options);
+ if ($v_result != 1) {
+ return 0;
+ }
+
+ // ----- Call the create fct
+ $v_result = $this->privAdd($v_filedescr_list, $p_result_list, $v_options);
+ if ($v_result != 1) {
+ return 0;
+ }
+
+ // ----- Return
+ return $p_result_list;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : listContent()
+ // Description :
+ // This public method, gives the list of the files and directories, with their
+ // properties.
+ // The properties of each entries in the list are (used also in other functions) :
+ // filename : Name of the file. For a create or add action it is the filename
+ // given by the user. For an extract function it is the filename
+ // of the extracted file.
+ // stored_filename : Name of the file / directory stored in the archive.
+ // size : Size of the stored file.
+ // compressed_size : Size of the file's data compressed in the archive
+ // (without the headers overhead)
+ // mtime : Last known modification date of the file (UNIX timestamp)
+ // comment : Comment associated with the file
+ // folder : true | false
+ // index : index of the file in the archive
+ // status : status of the action (depending of the action) :
+ // Values are :
+ // ok : OK !
+ // filtered : the file / dir is not extracted (filtered by user)
+ // already_a_directory : the file can not be extracted because a
+ // directory with the same name already exists
+ // write_protected : the file can not be extracted because a file
+ // with the same name already exists and is
+ // write protected
+ // newer_exist : the file was not extracted because a newer file exists
+ // path_creation_fail : the file is not extracted because the folder
+ // does not exist and can not be created
+ // write_error : the file was not extracted because there was a
+ // error while writing the file
+ // read_error : the file was not extracted because there was a error
+ // while reading the file
+ // invalid_header : the file was not extracted because of an archive
+ // format error (bad file header)
+ // Note that each time a method can continue operating when there
+ // is an action error on a file, the error is only logged in the file status.
+ // Return Values :
+ // 0 on an unrecoverable failure,
+ // The list of the files in the archive.
+ // --------------------------------------------------------------------------------
+ public function listContent()
+ {
+ $v_result = 1;
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Check archive
+ if (!$this->privCheckFormat()) {
+ return (0);
+ }
+
+ // ----- Call the extracting fct
+ $p_list = array();
+ if (($v_result = $this->privList($p_list)) != 1) {
+ unset($p_list);
+
+ return (0);
+ }
+
+ // ----- Return
+ return $p_list;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function :
+ // extract($p_path="./", $p_remove_path="")
+ // extract([$p_option, $p_option_value, ...])
+ // Description :
+ // This method supports two synopsis. The first one is historical.
+ // This method extract all the files / directories from the archive to the
+ // folder indicated in $p_path.
+ // If you want to ignore the 'root' part of path of the memorized files
+ // you can indicate this in the optional $p_remove_path parameter.
+ // By default, if a newer file with the same name already exists, the
+ // file is not extracted.
+ //
+ // If both PCLZIP_OPT_PATH and PCLZIP_OPT_ADD_PATH aoptions
+ // are used, the path indicated in PCLZIP_OPT_ADD_PATH is append
+ // at the end of the path value of PCLZIP_OPT_PATH.
+ // Parameters :
+ // $p_path : Path where the files and directories are to be extracted
+ // $p_remove_path : First part ('root' part) of the memorized path
+ // (if any similar) to remove while extracting.
+ // Options :
+ // PCLZIP_OPT_PATH :
+ // PCLZIP_OPT_ADD_PATH :
+ // PCLZIP_OPT_REMOVE_PATH :
+ // PCLZIP_OPT_REMOVE_ALL_PATH :
+ // PCLZIP_CB_PRE_EXTRACT :
+ // PCLZIP_CB_POST_EXTRACT :
+ // Return Values :
+ // 0 or a negative value on failure,
+ // The list of the extracted files, with a status of the action.
+ // (see PclZip::listContent() for list entry format)
+ // --------------------------------------------------------------------------------
+ public function extract()
+ {
+ $v_result = 1;
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Check archive
+ if (!$this->privCheckFormat()) {
+ return (0);
+ }
+
+ // ----- Set default values
+ $v_options = array();
+ // $v_path = "./";
+ $v_path = '';
+ $v_remove_path = "";
+ $v_remove_all_path = false;
+
+ // ----- Look for variable options arguments
+ $v_size = func_num_args();
+
+ // ----- Default values for option
+ $v_options[PCLZIP_OPT_EXTRACT_AS_STRING] = false;
+
+ // ----- Look for arguments
+ if ($v_size > 0) {
+ // ----- Get the arguments
+ $v_arg_list = func_get_args();
+
+ // ----- Look for first arg
+ if ((is_integer($v_arg_list[0])) && ($v_arg_list[0] > 77000)) {
+
+ // ----- Parse the options
+ $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, array(
+ PCLZIP_OPT_PATH => 'optional',
+ PCLZIP_OPT_REMOVE_PATH => 'optional',
+ PCLZIP_OPT_REMOVE_ALL_PATH => 'optional',
+ PCLZIP_OPT_ADD_PATH => 'optional',
+ PCLZIP_CB_PRE_EXTRACT => 'optional',
+ PCLZIP_CB_POST_EXTRACT => 'optional',
+ PCLZIP_OPT_SET_CHMOD => 'optional',
+ PCLZIP_OPT_BY_NAME => 'optional',
+ PCLZIP_OPT_BY_EREG => 'optional',
+ PCLZIP_OPT_BY_PREG => 'optional',
+ PCLZIP_OPT_BY_INDEX => 'optional',
+ PCLZIP_OPT_EXTRACT_AS_STRING => 'optional',
+ PCLZIP_OPT_EXTRACT_IN_OUTPUT => 'optional',
+ PCLZIP_OPT_REPLACE_NEWER => 'optional',
+ PCLZIP_OPT_STOP_ON_ERROR => 'optional',
+ PCLZIP_OPT_EXTRACT_DIR_RESTRICTION => 'optional',
+ PCLZIP_OPT_TEMP_FILE_THRESHOLD => 'optional',
+ PCLZIP_OPT_TEMP_FILE_ON => 'optional',
+ PCLZIP_OPT_TEMP_FILE_OFF => 'optional'
+ ));
+ if ($v_result != 1) {
+ return 0;
+ }
+
+ // ----- Set the arguments
+ if (isset($v_options[PCLZIP_OPT_PATH])) {
+ $v_path = $v_options[PCLZIP_OPT_PATH];
+ }
+ if (isset($v_options[PCLZIP_OPT_REMOVE_PATH])) {
+ $v_remove_path = $v_options[PCLZIP_OPT_REMOVE_PATH];
+ }
+ if (isset($v_options[PCLZIP_OPT_REMOVE_ALL_PATH])) {
+ $v_remove_all_path = $v_options[PCLZIP_OPT_REMOVE_ALL_PATH];
+ }
+ if (isset($v_options[PCLZIP_OPT_ADD_PATH])) {
+ // ----- Check for '/' in last path char
+ if ((strlen($v_path) > 0) && (substr($v_path, -1) != '/')) {
+ $v_path .= '/';
+ }
+ $v_path .= $v_options[PCLZIP_OPT_ADD_PATH];
+ }
+
+ // ----- Look for 2 args
+ // Here we need to support the first historic synopsis of the
+ // method.
+ } else {
+
+ // ----- Get the first argument
+ $v_path = $v_arg_list[0];
+
+ // ----- Look for the optional second argument
+ if ($v_size == 2) {
+ $v_remove_path = $v_arg_list[1];
+ } elseif ($v_size > 2) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid number / type of arguments");
+
+ // ----- Return
+ return 0;
+ }
+ }
+ }
+
+ // ----- Look for default option values
+ $this->privOptionDefaultThreshold($v_options);
+
+ // ----- Trace
+
+ // ----- Call the extracting fct
+ $p_list = array();
+ $v_result = $this->privExtractByRule($p_list, $v_path, $v_remove_path, $v_remove_all_path, $v_options);
+ if ($v_result < 1) {
+ unset($p_list);
+
+ return (0);
+ }
+
+ // ----- Return
+ return $p_list;
+ }
+ // --------------------------------------------------------------------------------
+
+
+ // --------------------------------------------------------------------------------
+ // Function :
+ // extractByIndex($p_index, $p_path="./", $p_remove_path="")
+ // extractByIndex($p_index, [$p_option, $p_option_value, ...])
+ // Description :
+ // This method supports two synopsis. The first one is historical.
+ // This method is doing a partial extract of the archive.
+ // The extracted files or folders are identified by their index in the
+ // archive (from 0 to n).
+ // Note that if the index identify a folder, only the folder entry is
+ // extracted, not all the files included in the archive.
+ // Parameters :
+ // $p_index : A single index (integer) or a string of indexes of files to
+ // extract. The form of the string is "0,4-6,8-12" with only numbers
+ // and '-' for range or ',' to separate ranges. No spaces or ';'
+ // are allowed.
+ // $p_path : Path where the files and directories are to be extracted
+ // $p_remove_path : First part ('root' part) of the memorized path
+ // (if any similar) to remove while extracting.
+ // Options :
+ // PCLZIP_OPT_PATH :
+ // PCLZIP_OPT_ADD_PATH :
+ // PCLZIP_OPT_REMOVE_PATH :
+ // PCLZIP_OPT_REMOVE_ALL_PATH :
+ // PCLZIP_OPT_EXTRACT_AS_STRING : The files are extracted as strings and
+ // not as files.
+ // The resulting content is in a new field 'content' in the file
+ // structure.
+ // This option must be used alone (any other options are ignored).
+ // PCLZIP_CB_PRE_EXTRACT :
+ // PCLZIP_CB_POST_EXTRACT :
+ // Return Values :
+ // 0 on failure,
+ // The list of the extracted files, with a status of the action.
+ // (see PclZip::listContent() for list entry format)
+ // --------------------------------------------------------------------------------
+ //function extractByIndex($p_index, options...)
+ public function extractByIndex($p_index)
+ {
+ $v_result = 1;
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Check archive
+ if (!$this->privCheckFormat()) {
+ return (0);
+ }
+
+ // ----- Set default values
+ $v_options = array();
+ // $v_path = "./";
+ $v_path = '';
+ $v_remove_path = "";
+ $v_remove_all_path = false;
+
+ // ----- Look for variable options arguments
+ $v_size = func_num_args();
+
+ // ----- Default values for option
+ $v_options[PCLZIP_OPT_EXTRACT_AS_STRING] = false;
+
+ // ----- Look for arguments
+ if ($v_size > 1) {
+ // ----- Get the arguments
+ $v_arg_list = func_get_args();
+
+ // ----- Remove form the options list the first argument
+ array_shift($v_arg_list);
+ $v_size--;
+
+ // ----- Look for first arg
+ if ((is_integer($v_arg_list[0])) && ($v_arg_list[0] > 77000)) {
+
+ // ----- Parse the options
+ $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, array(
+ PCLZIP_OPT_PATH => 'optional',
+ PCLZIP_OPT_REMOVE_PATH => 'optional',
+ PCLZIP_OPT_REMOVE_ALL_PATH => 'optional',
+ PCLZIP_OPT_EXTRACT_AS_STRING => 'optional',
+ PCLZIP_OPT_ADD_PATH => 'optional',
+ PCLZIP_CB_PRE_EXTRACT => 'optional',
+ PCLZIP_CB_POST_EXTRACT => 'optional',
+ PCLZIP_OPT_SET_CHMOD => 'optional',
+ PCLZIP_OPT_REPLACE_NEWER => 'optional',
+ PCLZIP_OPT_STOP_ON_ERROR => 'optional',
+ PCLZIP_OPT_EXTRACT_DIR_RESTRICTION => 'optional',
+ PCLZIP_OPT_TEMP_FILE_THRESHOLD => 'optional',
+ PCLZIP_OPT_TEMP_FILE_ON => 'optional',
+ PCLZIP_OPT_TEMP_FILE_OFF => 'optional'
+ ));
+ if ($v_result != 1) {
+ return 0;
+ }
+
+ // ----- Set the arguments
+ if (isset($v_options[PCLZIP_OPT_PATH])) {
+ $v_path = $v_options[PCLZIP_OPT_PATH];
+ }
+ if (isset($v_options[PCLZIP_OPT_REMOVE_PATH])) {
+ $v_remove_path = $v_options[PCLZIP_OPT_REMOVE_PATH];
+ }
+ if (isset($v_options[PCLZIP_OPT_REMOVE_ALL_PATH])) {
+ $v_remove_all_path = $v_options[PCLZIP_OPT_REMOVE_ALL_PATH];
+ }
+ if (isset($v_options[PCLZIP_OPT_ADD_PATH])) {
+ // ----- Check for '/' in last path char
+ if ((strlen($v_path) > 0) && (substr($v_path, -1) != '/')) {
+ $v_path .= '/';
+ }
+ $v_path .= $v_options[PCLZIP_OPT_ADD_PATH];
+ }
+ if (!isset($v_options[PCLZIP_OPT_EXTRACT_AS_STRING])) {
+ $v_options[PCLZIP_OPT_EXTRACT_AS_STRING] = false;
+ } else {
+ }
+
+ // ----- Look for 2 args
+ // Here we need to support the first historic synopsis of the
+ // method.
+ } else {
+
+ // ----- Get the first argument
+ $v_path = $v_arg_list[0];
+
+ // ----- Look for the optional second argument
+ if ($v_size == 2) {
+ $v_remove_path = $v_arg_list[1];
+ } elseif ($v_size > 2) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid number / type of arguments");
+
+ // ----- Return
+ return 0;
+ }
+ }
+ }
+
+ // ----- Trace
+
+ // ----- Trick
+ // Here I want to reuse extractByRule(), so I need to parse the $p_index
+ // with privParseOptions()
+ $v_arg_trick = array(
+ PCLZIP_OPT_BY_INDEX,
+ $p_index
+ );
+ $v_options_trick = array();
+ $v_result = $this->privParseOptions($v_arg_trick, sizeof($v_arg_trick), $v_options_trick, array(
+ PCLZIP_OPT_BY_INDEX => 'optional'
+ ));
+ if ($v_result != 1) {
+ return 0;
+ }
+ $v_options[PCLZIP_OPT_BY_INDEX] = $v_options_trick[PCLZIP_OPT_BY_INDEX];
+
+ // ----- Look for default option values
+ $this->privOptionDefaultThreshold($v_options);
+
+ // ----- Call the extracting fct
+ if (($v_result = $this->privExtractByRule($p_list, $v_path, $v_remove_path, $v_remove_all_path, $v_options)) < 1) {
+ return (0);
+ }
+
+ // ----- Return
+ return $p_list;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function :
+ // delete([$p_option, $p_option_value, ...])
+ // Description :
+ // This method removes files from the archive.
+ // If no parameters are given, then all the archive is emptied.
+ // Parameters :
+ // None or optional arguments.
+ // Options :
+ // PCLZIP_OPT_BY_INDEX :
+ // PCLZIP_OPT_BY_NAME :
+ // PCLZIP_OPT_BY_EREG :
+ // PCLZIP_OPT_BY_PREG :
+ // Return Values :
+ // 0 on failure,
+ // The list of the files which are still present in the archive.
+ // (see PclZip::listContent() for list entry format)
+ // --------------------------------------------------------------------------------
+ public function delete()
+ {
+ $v_result = 1;
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Check archive
+ if (!$this->privCheckFormat()) {
+ return (0);
+ }
+
+ // ----- Set default values
+ $v_options = array();
+
+ // ----- Look for variable options arguments
+ $v_size = func_num_args();
+
+ // ----- Look for arguments
+ if ($v_size > 0) {
+ // ----- Get the arguments
+ $v_arg_list = func_get_args();
+
+ // ----- Parse the options
+ $v_result = $this->privParseOptions($v_arg_list, $v_size, $v_options, array(
+ PCLZIP_OPT_BY_NAME => 'optional',
+ PCLZIP_OPT_BY_EREG => 'optional',
+ PCLZIP_OPT_BY_PREG => 'optional',
+ PCLZIP_OPT_BY_INDEX => 'optional'
+ ));
+ if ($v_result != 1) {
+ return 0;
+ }
+ }
+
+ // ----- Magic quotes trick
+ $this->privDisableMagicQuotes();
+
+ // ----- Call the delete fct
+ $v_list = array();
+ if (($v_result = $this->privDeleteByRule($v_list, $v_options)) != 1) {
+ $this->privSwapBackMagicQuotes();
+ unset($v_list);
+
+ return (0);
+ }
+
+ // ----- Magic quotes trick
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Return
+ return $v_list;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : deleteByIndex()
+ // Description :
+ // ***** Deprecated *****
+ // delete(PCLZIP_OPT_BY_INDEX, $p_index) should be prefered.
+ // --------------------------------------------------------------------------------
+ public function deleteByIndex($p_index)
+ {
+
+ $p_list = $this->delete(PCLZIP_OPT_BY_INDEX, $p_index);
+
+ // ----- Return
+ return $p_list;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : properties()
+ // Description :
+ // This method gives the properties of the archive.
+ // The properties are :
+ // nb : Number of files in the archive
+ // comment : Comment associated with the archive file
+ // status : not_exist, ok
+ // Parameters :
+ // None
+ // Return Values :
+ // 0 on failure,
+ // An array with the archive properties.
+ // --------------------------------------------------------------------------------
+ public function properties()
+ {
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Magic quotes trick
+ $this->privDisableMagicQuotes();
+
+ // ----- Check archive
+ if (!$this->privCheckFormat()) {
+ $this->privSwapBackMagicQuotes();
+
+ return (0);
+ }
+
+ // ----- Default properties
+ $v_prop = array();
+ $v_prop['comment'] = '';
+ $v_prop['nb'] = 0;
+ $v_prop['status'] = 'not_exist';
+
+ // ----- Look if file exists
+ if (@is_file($this->zipname)) {
+ // ----- Open the zip file
+ if (($this->zip_fd = @fopen($this->zipname, 'rb')) == 0) {
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open archive \'' . $this->zipname . '\' in binary read mode');
+
+ // ----- Return
+ return 0;
+ }
+
+ // ----- Read the central directory informations
+ $v_central_dir = array();
+ if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) {
+ $this->privSwapBackMagicQuotes();
+
+ return 0;
+ }
+
+ // ----- Close the zip file
+ $this->privCloseFd();
+
+ // ----- Set the user attributes
+ $v_prop['comment'] = $v_central_dir['comment'];
+ $v_prop['nb'] = $v_central_dir['entries'];
+ $v_prop['status'] = 'ok';
+ }
+
+ // ----- Magic quotes trick
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Return
+ return $v_prop;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : duplicate()
+ // Description :
+ // This method creates an archive by copying the content of an other one. If
+ // the archive already exist, it is replaced by the new one without any warning.
+ // Parameters :
+ // $p_archive : The filename of a valid archive, or
+ // a valid PclZip object.
+ // Return Values :
+ // 1 on success.
+ // 0 or a negative value on error (error code).
+ // --------------------------------------------------------------------------------
+ public function duplicate($p_archive)
+ {
+ $v_result = 1;
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Look if the $p_archive is a PclZip object
+ if ((is_object($p_archive)) && (get_class($p_archive) == 'pclzip')) {
+
+ // ----- Duplicate the archive
+ $v_result = $this->privDuplicate($p_archive->zipname);
+
+ // ----- Look if the $p_archive is a string (so a filename)
+ } elseif (is_string($p_archive)) {
+
+ // ----- Check that $p_archive is a valid zip file
+ // TBC : Should also check the archive format
+ if (!is_file($p_archive)) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_FILE, "No file with filename '" . $p_archive . "'");
+ $v_result = PCLZIP_ERR_MISSING_FILE;
+ } else {
+ // ----- Duplicate the archive
+ $v_result = $this->privDuplicate($p_archive);
+ }
+
+ // ----- Invalid variable
+ } else {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid variable type p_archive_to_add");
+ $v_result = PCLZIP_ERR_INVALID_PARAMETER;
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : merge()
+ // Description :
+ // This method merge the $p_archive_to_add archive at the end of the current
+ // one ($this).
+ // If the archive ($this) does not exist, the merge becomes a duplicate.
+ // If the $p_archive_to_add archive does not exist, the merge is a success.
+ // Parameters :
+ // $p_archive_to_add : It can be directly the filename of a valid zip archive,
+ // or a PclZip object archive.
+ // Return Values :
+ // 1 on success,
+ // 0 or negative values on error (see below).
+ // --------------------------------------------------------------------------------
+ public function merge($p_archive_to_add)
+ {
+ $v_result = 1;
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Check archive
+ if (!$this->privCheckFormat()) {
+ return (0);
+ }
+
+ // ----- Look if the $p_archive_to_add is a PclZip object
+ if ((is_object($p_archive_to_add)) && (get_class($p_archive_to_add) == 'pclzip')) {
+
+ // ----- Merge the archive
+ $v_result = $this->privMerge($p_archive_to_add);
+
+ // ----- Look if the $p_archive_to_add is a string (so a filename)
+ } elseif (is_string($p_archive_to_add)) {
+
+ // ----- Create a temporary archive
+ $v_object_archive = new PclZip($p_archive_to_add);
+
+ // ----- Merge the archive
+ $v_result = $this->privMerge($v_object_archive);
+
+ // ----- Invalid variable
+ } else {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid variable type p_archive_to_add");
+ $v_result = PCLZIP_ERR_INVALID_PARAMETER;
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : errorCode()
+ // Description :
+ // Parameters :
+ // --------------------------------------------------------------------------------
+ public function errorCode()
+ {
+ if (PCLZIP_ERROR_EXTERNAL == 1) {
+ return (PclErrorCode());
+ }
+
+ return ($this->error_code);
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : errorName()
+ // Description :
+ // Parameters :
+ // --------------------------------------------------------------------------------
+ public function errorName($p_with_code = false)
+ {
+ $v_name = array(
+ PCLZIP_ERR_NO_ERROR => 'PCLZIP_ERR_NO_ERROR',
+ PCLZIP_ERR_WRITE_OPEN_FAIL => 'PCLZIP_ERR_WRITE_OPEN_FAIL',
+ PCLZIP_ERR_READ_OPEN_FAIL => 'PCLZIP_ERR_READ_OPEN_FAIL',
+ PCLZIP_ERR_INVALID_PARAMETER => 'PCLZIP_ERR_INVALID_PARAMETER',
+ PCLZIP_ERR_MISSING_FILE => 'PCLZIP_ERR_MISSING_FILE',
+ PCLZIP_ERR_FILENAME_TOO_LONG => 'PCLZIP_ERR_FILENAME_TOO_LONG',
+ PCLZIP_ERR_INVALID_ZIP => 'PCLZIP_ERR_INVALID_ZIP',
+ PCLZIP_ERR_BAD_EXTRACTED_FILE => 'PCLZIP_ERR_BAD_EXTRACTED_FILE',
+ PCLZIP_ERR_DIR_CREATE_FAIL => 'PCLZIP_ERR_DIR_CREATE_FAIL',
+ PCLZIP_ERR_BAD_EXTENSION => 'PCLZIP_ERR_BAD_EXTENSION',
+ PCLZIP_ERR_BAD_FORMAT => 'PCLZIP_ERR_BAD_FORMAT',
+ PCLZIP_ERR_DELETE_FILE_FAIL => 'PCLZIP_ERR_DELETE_FILE_FAIL',
+ PCLZIP_ERR_RENAME_FILE_FAIL => 'PCLZIP_ERR_RENAME_FILE_FAIL',
+ PCLZIP_ERR_BAD_CHECKSUM => 'PCLZIP_ERR_BAD_CHECKSUM',
+ PCLZIP_ERR_INVALID_ARCHIVE_ZIP => 'PCLZIP_ERR_INVALID_ARCHIVE_ZIP',
+ PCLZIP_ERR_MISSING_OPTION_VALUE => 'PCLZIP_ERR_MISSING_OPTION_VALUE',
+ PCLZIP_ERR_INVALID_OPTION_VALUE => 'PCLZIP_ERR_INVALID_OPTION_VALUE',
+ PCLZIP_ERR_UNSUPPORTED_COMPRESSION => 'PCLZIP_ERR_UNSUPPORTED_COMPRESSION',
+ PCLZIP_ERR_UNSUPPORTED_ENCRYPTION => 'PCLZIP_ERR_UNSUPPORTED_ENCRYPTION',
+ PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE => 'PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE',
+ PCLZIP_ERR_DIRECTORY_RESTRICTION => 'PCLZIP_ERR_DIRECTORY_RESTRICTION'
+ );
+
+ if (isset($v_name[$this->error_code])) {
+ $v_value = $v_name[$this->error_code];
+ } else {
+ $v_value = 'NoName';
+ }
+
+ if ($p_with_code) {
+ return ($v_value . ' (' . $this->error_code . ')');
+ }
+
+ return ($v_value);
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : errorInfo()
+ // Description :
+ // Parameters :
+ // --------------------------------------------------------------------------------
+ public function errorInfo($p_full = false)
+ {
+ if (PCLZIP_ERROR_EXTERNAL == 1) {
+ return (PclErrorString());
+ }
+
+ if ($p_full) {
+ return ($this->errorName(true) . " : " . $this->error_string);
+ }
+
+ return ($this->error_string . " [code " . $this->error_code . "]");
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // ***** UNDER THIS LINE ARE DEFINED PRIVATE INTERNAL FUNCTIONS *****
+ // ***** *****
+ // ***** THESES FUNCTIONS MUST NOT BE USED DIRECTLY *****
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privCheckFormat()
+ // Description :
+ // This method check that the archive exists and is a valid zip archive.
+ // Several level of check exists. (futur)
+ // Parameters :
+ // $p_level : Level of check. Default 0.
+ // 0 : Check the first bytes (magic codes) (default value))
+ // 1 : 0 + Check the central directory (futur)
+ // 2 : 1 + Check each file header (futur)
+ // Return Values :
+ // true on success,
+ // false on error, the error code is set.
+ // --------------------------------------------------------------------------------
+ public function privCheckFormat($p_level = 0)
+ {
+ $v_result = true;
+
+ // ----- Reset the file system cache
+ clearstatcache();
+
+ // ----- Reset the error handler
+ $this->privErrorReset();
+
+ // ----- Look if the file exits
+ if (!is_file($this->zipname)) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_FILE, "Missing archive file '" . $this->zipname . "'");
+
+ return (false);
+ }
+
+ // ----- Check that the file is readeable
+ if (!is_readable($this->zipname)) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, "Unable to read archive '" . $this->zipname . "'");
+
+ return (false);
+ }
+
+ // ----- Check the magic code
+ // TBC
+
+ // ----- Check the central header
+ // TBC
+
+ // ----- Check each file header
+ // TBC
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privParseOptions()
+ // Description :
+ // This internal methods reads the variable list of arguments ($p_options_list,
+ // $p_size) and generate an array with the options and values ($v_result_list).
+ // $v_requested_options contains the options that can be present and those that
+ // must be present.
+ // $v_requested_options is an array, with the option value as key, and 'optional',
+ // or 'mandatory' as value.
+ // Parameters :
+ // See above.
+ // Return Values :
+ // 1 on success.
+ // 0 on failure.
+ // --------------------------------------------------------------------------------
+ public function privParseOptions(&$p_options_list, $p_size, &$v_result_list, $v_requested_options = false)
+ {
+ $v_result = 1;
+
+ // ----- Read the options
+ $i = 0;
+ while ($i < $p_size) {
+
+ // ----- Check if the option is supported
+ if (!isset($v_requested_options[$p_options_list[$i]])) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid optional parameter '" . $p_options_list[$i] . "' for this method");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Look for next option
+ switch ($p_options_list[$i]) {
+ // ----- Look for options that request a path value
+ case PCLZIP_OPT_PATH:
+ case PCLZIP_OPT_REMOVE_PATH:
+ case PCLZIP_OPT_ADD_PATH:
+ // ----- Check the number of parameters
+ if (($i + 1) >= $p_size) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Get the value
+ $v_result_list[$p_options_list[$i]] = PclZipUtilTranslateWinPath($p_options_list[$i + 1], false);
+ $i++;
+ break;
+
+ case PCLZIP_OPT_TEMP_FILE_THRESHOLD:
+ // ----- Check the number of parameters
+ if (($i + 1) >= $p_size) {
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Check for incompatible options
+ if (isset($v_result_list[PCLZIP_OPT_TEMP_FILE_OFF])) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Option '" . PclZipUtilOptionText($p_options_list[$i]) . "' can not be used with option 'PCLZIP_OPT_TEMP_FILE_OFF'");
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Check the value
+ $v_value = $p_options_list[$i + 1];
+ if ((!is_integer($v_value)) || ($v_value < 0)) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Integer expected for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Get the value (and convert it in bytes)
+ $v_result_list[$p_options_list[$i]] = $v_value * 1048576;
+ $i++;
+ break;
+
+ case PCLZIP_OPT_TEMP_FILE_ON:
+ // ----- Check for incompatible options
+ if (isset($v_result_list[PCLZIP_OPT_TEMP_FILE_OFF])) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Option '" . PclZipUtilOptionText($p_options_list[$i]) . "' can not be used with option 'PCLZIP_OPT_TEMP_FILE_OFF'");
+
+ return PclZip::errorCode();
+ }
+
+ $v_result_list[$p_options_list[$i]] = true;
+ break;
+
+ case PCLZIP_OPT_TEMP_FILE_OFF:
+ // ----- Check for incompatible options
+ if (isset($v_result_list[PCLZIP_OPT_TEMP_FILE_ON])) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Option '" . PclZipUtilOptionText($p_options_list[$i]) . "' can not be used with option 'PCLZIP_OPT_TEMP_FILE_ON'");
+
+ return PclZip::errorCode();
+ }
+ // ----- Check for incompatible options
+ if (isset($v_result_list[PCLZIP_OPT_TEMP_FILE_THRESHOLD])) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Option '" . PclZipUtilOptionText($p_options_list[$i]) . "' can not be used with option 'PCLZIP_OPT_TEMP_FILE_THRESHOLD'");
+
+ return PclZip::errorCode();
+ }
+
+ $v_result_list[$p_options_list[$i]] = true;
+ break;
+
+ case PCLZIP_OPT_EXTRACT_DIR_RESTRICTION:
+ // ----- Check the number of parameters
+ if (($i + 1) >= $p_size) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Get the value
+ if (is_string($p_options_list[$i + 1]) && ($p_options_list[$i + 1] != '')) {
+ $v_result_list[$p_options_list[$i]] = PclZipUtilTranslateWinPath($p_options_list[$i + 1], false);
+ $i++;
+ } else {
+ }
+ break;
+
+ // ----- Look for options that request an array of string for value
+ case PCLZIP_OPT_BY_NAME:
+ // ----- Check the number of parameters
+ if (($i + 1) >= $p_size) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Get the value
+ if (is_string($p_options_list[$i + 1])) {
+ $v_result_list[$p_options_list[$i]][0] = $p_options_list[$i + 1];
+ } elseif (is_array($p_options_list[$i + 1])) {
+ $v_result_list[$p_options_list[$i]] = $p_options_list[$i + 1];
+ } else {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Wrong parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+ $i++;
+ break;
+
+ // ----- Look for options that request an EREG or PREG expression
+ case PCLZIP_OPT_BY_EREG:
+ $p_options_list[$i] = PCLZIP_OPT_BY_PREG;
+ // ereg() is deprecated starting with PHP 5.3. Move PCLZIP_OPT_BY_EREG
+ // to PCLZIP_OPT_BY_PREG
+ case PCLZIP_OPT_BY_PREG:
+ //case PCLZIP_OPT_CRYPT :
+ // ----- Check the number of parameters
+ if (($i + 1) >= $p_size) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Get the value
+ if (is_string($p_options_list[$i + 1])) {
+ $v_result_list[$p_options_list[$i]] = $p_options_list[$i + 1];
+ } else {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Wrong parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+ $i++;
+ break;
+
+ // ----- Look for options that takes a string
+ case PCLZIP_OPT_COMMENT:
+ case PCLZIP_OPT_ADD_COMMENT:
+ case PCLZIP_OPT_PREPEND_COMMENT:
+ // ----- Check the number of parameters
+ if (($i + 1) >= $p_size) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Get the value
+ if (is_string($p_options_list[$i + 1])) {
+ $v_result_list[$p_options_list[$i]] = $p_options_list[$i + 1];
+ } else {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Wrong parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+ $i++;
+ break;
+
+ // ----- Look for options that request an array of index
+ case PCLZIP_OPT_BY_INDEX:
+ // ----- Check the number of parameters
+ if (($i + 1) >= $p_size) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Get the value
+ $v_work_list = array();
+ if (is_string($p_options_list[$i + 1])) {
+
+ // ----- Remove spaces
+ $p_options_list[$i + 1] = str_replace(' ', '', $p_options_list[$i + 1]);
+
+ // ----- Parse items
+ $v_work_list = explode(",", $p_options_list[$i + 1]);
+ } elseif (is_integer($p_options_list[$i + 1])) {
+ $v_work_list[0] = $p_options_list[$i + 1] . '-' . $p_options_list[$i + 1];
+ } elseif (is_array($p_options_list[$i + 1])) {
+ $v_work_list = $p_options_list[$i + 1];
+ } else {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Value must be integer, string or array for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Reduce the index list
+ // each index item in the list must be a couple with a start and
+ // an end value : [0,3], [5-5], [8-10], ...
+ // ----- Check the format of each item
+ $v_sort_flag = false;
+ $v_sort_value = 0;
+ for ($j = 0; $j < sizeof($v_work_list); $j++) {
+ // ----- Explode the item
+ $v_item_list = explode("-", $v_work_list[$j]);
+ $v_size_item_list = sizeof($v_item_list);
+
+ // ----- TBC : Here we might check that each item is a
+ // real integer ...
+
+ // ----- Look for single value
+ if ($v_size_item_list == 1) {
+ // ----- Set the option value
+ $v_result_list[$p_options_list[$i]][$j]['start'] = $v_item_list[0];
+ $v_result_list[$p_options_list[$i]][$j]['end'] = $v_item_list[0];
+ } elseif ($v_size_item_list == 2) {
+ // ----- Set the option value
+ $v_result_list[$p_options_list[$i]][$j]['start'] = $v_item_list[0];
+ $v_result_list[$p_options_list[$i]][$j]['end'] = $v_item_list[1];
+ } else {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Too many values in index range for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Look for list sort
+ if ($v_result_list[$p_options_list[$i]][$j]['start'] < $v_sort_value) {
+ $v_sort_flag = true;
+
+ // ----- TBC : An automatic sort should be writen ...
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Invalid order of index range for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+ $v_sort_value = $v_result_list[$p_options_list[$i]][$j]['start'];
+ }
+
+ // ----- Sort the items
+ if ($v_sort_flag) {
+ // TBC : To Be Completed
+ }
+
+ // ----- Next option
+ $i++;
+ break;
+
+ // ----- Look for options that request no value
+ case PCLZIP_OPT_REMOVE_ALL_PATH:
+ case PCLZIP_OPT_EXTRACT_AS_STRING:
+ case PCLZIP_OPT_NO_COMPRESSION:
+ case PCLZIP_OPT_EXTRACT_IN_OUTPUT:
+ case PCLZIP_OPT_REPLACE_NEWER:
+ case PCLZIP_OPT_STOP_ON_ERROR:
+ $v_result_list[$p_options_list[$i]] = true;
+ break;
+
+ // ----- Look for options that request an octal value
+ case PCLZIP_OPT_SET_CHMOD:
+ // ----- Check the number of parameters
+ if (($i + 1) >= $p_size) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Get the value
+ $v_result_list[$p_options_list[$i]] = $p_options_list[$i + 1];
+ $i++;
+ break;
+
+ // ----- Look for options that request a call-back
+ case PCLZIP_CB_PRE_EXTRACT:
+ case PCLZIP_CB_POST_EXTRACT:
+ case PCLZIP_CB_PRE_ADD:
+ case PCLZIP_CB_POST_ADD:
+ /* for futur use
+ case PCLZIP_CB_PRE_DELETE :
+ case PCLZIP_CB_POST_DELETE :
+ case PCLZIP_CB_PRE_LIST :
+ case PCLZIP_CB_POST_LIST :
+ */
+ // ----- Check the number of parameters
+ if (($i + 1) >= $p_size) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_OPTION_VALUE, "Missing parameter value for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Get the value
+ $v_function_name = $p_options_list[$i + 1];
+
+ // ----- Check that the value is a valid existing function
+ if (!function_exists($v_function_name)) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_OPTION_VALUE, "Function '" . $v_function_name . "()' is not an existing function for option '" . PclZipUtilOptionText($p_options_list[$i]) . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Set the attribute
+ $v_result_list[$p_options_list[$i]] = $v_function_name;
+ $i++;
+ break;
+
+ default:
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Unknown parameter '" . $p_options_list[$i] . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Next options
+ $i++;
+ }
+
+ // ----- Look for mandatory options
+ if ($v_requested_options !== false) {
+ for ($key = reset($v_requested_options); $key = key($v_requested_options); $key = next($v_requested_options)) {
+ // ----- Look for mandatory option
+ if ($v_requested_options[$key] == 'mandatory') {
+ // ----- Look if present
+ if (!isset($v_result_list[$key])) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Missing mandatory parameter " . PclZipUtilOptionText($key) . "(" . $key . ")");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+ }
+ }
+ }
+
+ // ----- Look for default values
+ if (!isset($v_result_list[PCLZIP_OPT_TEMP_FILE_THRESHOLD])) {
+
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privOptionDefaultThreshold()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privOptionDefaultThreshold(&$p_options)
+ {
+ $v_result = 1;
+
+ if (isset($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD]) || isset($p_options[PCLZIP_OPT_TEMP_FILE_OFF])) {
+ return $v_result;
+ }
+
+ // ----- Get 'memory_limit' configuration value
+ $v_memory_limit = ini_get('memory_limit');
+ $v_memory_limit = trim($v_memory_limit);
+ $last = strtolower(substr($v_memory_limit, -1));
+ $v_memory_limit = preg_replace('/[^0-9,.]/', '', $v_memory_limit);
+
+ if ($last == 'g') {
+ //$v_memory_limit = $v_memory_limit*1024*1024*1024;
+ $v_memory_limit = $v_memory_limit * 1073741824;
+ }
+ if ($last == 'm') {
+ //$v_memory_limit = $v_memory_limit*1024*1024;
+ $v_memory_limit = $v_memory_limit * 1048576;
+ }
+ if ($last == 'k') {
+ $v_memory_limit = $v_memory_limit * 1024;
+ }
+
+ $p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD] = floor($v_memory_limit * PCLZIP_TEMPORARY_FILE_RATIO);
+
+ // ----- Sanity check : No threshold if value lower than 1M
+ if ($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD] < 1048576) {
+ unset($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD]);
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privFileDescrParseAtt()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // 1 on success.
+ // 0 on failure.
+ // --------------------------------------------------------------------------------
+ public function privFileDescrParseAtt(&$p_file_list, &$p_filedescr, $v_options, $v_requested_options = false)
+ {
+ $v_result = 1;
+
+ // ----- For each file in the list check the attributes
+ foreach ($p_file_list as $v_key => $v_value) {
+
+ // ----- Check if the option is supported
+ if (!isset($v_requested_options[$v_key])) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid file attribute '" . $v_key . "' for this file");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Look for attribute
+ switch ($v_key) {
+ case PCLZIP_ATT_FILE_NAME:
+ if (!is_string($v_value)) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type " . gettype($v_value) . ". String expected for attribute '" . PclZipUtilOptionText($v_key) . "'");
+
+ return PclZip::errorCode();
+ }
+
+ $p_filedescr['filename'] = PclZipUtilPathReduction($v_value);
+
+ if ($p_filedescr['filename'] == '') {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid empty filename for attribute '" . PclZipUtilOptionText($v_key) . "'");
+
+ return PclZip::errorCode();
+ }
+
+ break;
+
+ case PCLZIP_ATT_FILE_NEW_SHORT_NAME:
+ if (!is_string($v_value)) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type " . gettype($v_value) . ". String expected for attribute '" . PclZipUtilOptionText($v_key) . "'");
+
+ return PclZip::errorCode();
+ }
+
+ $p_filedescr['new_short_name'] = PclZipUtilPathReduction($v_value);
+
+ if ($p_filedescr['new_short_name'] == '') {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid empty short filename for attribute '" . PclZipUtilOptionText($v_key) . "'");
+
+ return PclZip::errorCode();
+ }
+ break;
+
+ case PCLZIP_ATT_FILE_NEW_FULL_NAME:
+ if (!is_string($v_value)) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type " . gettype($v_value) . ". String expected for attribute '" . PclZipUtilOptionText($v_key) . "'");
+
+ return PclZip::errorCode();
+ }
+
+ $p_filedescr['new_full_name'] = PclZipUtilPathReduction($v_value);
+
+ if ($p_filedescr['new_full_name'] == '') {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid empty full filename for attribute '" . PclZipUtilOptionText($v_key) . "'");
+
+ return PclZip::errorCode();
+ }
+ break;
+
+ // ----- Look for options that takes a string
+ case PCLZIP_ATT_FILE_COMMENT:
+ if (!is_string($v_value)) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type " . gettype($v_value) . ". String expected for attribute '" . PclZipUtilOptionText($v_key) . "'");
+
+ return PclZip::errorCode();
+ }
+
+ $p_filedescr['comment'] = $v_value;
+ break;
+
+ case PCLZIP_ATT_FILE_MTIME:
+ if (!is_integer($v_value)) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ATTRIBUTE_VALUE, "Invalid type " . gettype($v_value) . ". Integer expected for attribute '" . PclZipUtilOptionText($v_key) . "'");
+
+ return PclZip::errorCode();
+ }
+
+ $p_filedescr['mtime'] = $v_value;
+ break;
+
+ case PCLZIP_ATT_FILE_CONTENT:
+ $p_filedescr['content'] = $v_value;
+ break;
+
+ default:
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Unknown parameter '" . $v_key . "'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Look for mandatory options
+ if ($v_requested_options !== false) {
+ for ($key = reset($v_requested_options); $key = key($v_requested_options); $key = next($v_requested_options)) {
+ // ----- Look for mandatory option
+ if ($v_requested_options[$key] == 'mandatory') {
+ // ----- Look if present
+ if (!isset($p_file_list[$key])) {
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Missing mandatory parameter " . PclZipUtilOptionText($key) . "(" . $key . ")");
+
+ return PclZip::errorCode();
+ }
+ }
+ }
+ }
+
+ // end foreach
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privFileDescrExpand()
+ // Description :
+ // This method look for each item of the list to see if its a file, a folder
+ // or a string to be added as file. For any other type of files (link, other)
+ // just ignore the item.
+ // Then prepare the information that will be stored for that file.
+ // When its a folder, expand the folder with all the files that are in that
+ // folder (recursively).
+ // Parameters :
+ // Return Values :
+ // 1 on success.
+ // 0 on failure.
+ // --------------------------------------------------------------------------------
+ public function privFileDescrExpand(&$p_filedescr_list, &$p_options)
+ {
+ $v_result = 1;
+
+ // ----- Create a result list
+ $v_result_list = array();
+
+ // ----- Look each entry
+ for ($i = 0; $i < sizeof($p_filedescr_list); $i++) {
+
+ // ----- Get filedescr
+ $v_descr = $p_filedescr_list[$i];
+
+ // ----- Reduce the filename
+ $v_descr['filename'] = PclZipUtilTranslateWinPath($v_descr['filename'], false);
+ $v_descr['filename'] = PclZipUtilPathReduction($v_descr['filename']);
+
+ // ----- Look for real file or folder
+ if (file_exists($v_descr['filename'])) {
+ if (@is_file($v_descr['filename'])) {
+ $v_descr['type'] = 'file';
+ } elseif (@is_dir($v_descr['filename'])) {
+ $v_descr['type'] = 'folder';
+ } elseif (@is_link($v_descr['filename'])) {
+ // skip
+ continue;
+ } else {
+ // skip
+ continue;
+ }
+
+ // ----- Look for string added as file
+ } elseif (isset($v_descr['content'])) {
+ $v_descr['type'] = 'virtual_file';
+
+ // ----- Missing file
+ } else {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_FILE, "File '" . $v_descr['filename'] . "' does not exist");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Calculate the stored filename
+ $this->privCalculateStoredFilename($v_descr, $p_options);
+
+ // ----- Add the descriptor in result list
+ $v_result_list[sizeof($v_result_list)] = $v_descr;
+
+ // ----- Look for folder
+ if ($v_descr['type'] == 'folder') {
+ // ----- List of items in folder
+ $v_dirlist_descr = array();
+ $v_dirlist_nb = 0;
+ if ($v_folder_handler = @opendir($v_descr['filename'])) {
+ while (($v_item_handler = @readdir($v_folder_handler)) !== false) {
+
+ // ----- Skip '.' and '..'
+ if (($v_item_handler == '.') || ($v_item_handler == '..')) {
+ continue;
+ }
+
+ // ----- Compose the full filename
+ $v_dirlist_descr[$v_dirlist_nb]['filename'] = $v_descr['filename'] . '/' . $v_item_handler;
+
+ // ----- Look for different stored filename
+ // Because the name of the folder was changed, the name of the
+ // files/sub-folders also change
+ if (($v_descr['stored_filename'] != $v_descr['filename']) && (!isset($p_options[PCLZIP_OPT_REMOVE_ALL_PATH]))) {
+ if ($v_descr['stored_filename'] != '') {
+ $v_dirlist_descr[$v_dirlist_nb]['new_full_name'] = $v_descr['stored_filename'] . '/' . $v_item_handler;
+ } else {
+ $v_dirlist_descr[$v_dirlist_nb]['new_full_name'] = $v_item_handler;
+ }
+ }
+
+ $v_dirlist_nb++;
+ }
+
+ @closedir($v_folder_handler);
+ } else {
+ // TBC : unable to open folder in read mode
+ }
+
+ // ----- Expand each element of the list
+ if ($v_dirlist_nb != 0) {
+ // ----- Expand
+ if (($v_result = $this->privFileDescrExpand($v_dirlist_descr, $p_options)) != 1) {
+ return $v_result;
+ }
+
+ // ----- Concat the resulting list
+ $v_result_list = array_merge($v_result_list, $v_dirlist_descr);
+ } else {
+ }
+
+ // ----- Free local array
+ unset($v_dirlist_descr);
+ }
+ }
+
+ // ----- Get the result list
+ $p_filedescr_list = $v_result_list;
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privCreate()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privCreate($p_filedescr_list, &$p_result_list, &$p_options)
+ {
+ $v_result = 1;
+ $v_list_detail = array();
+
+ // ----- Magic quotes trick
+ $this->privDisableMagicQuotes();
+
+ // ----- Open the file in write mode
+ if (($v_result = $this->privOpenFd('wb')) != 1) {
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Add the list of files
+ $v_result = $this->privAddList($p_filedescr_list, $p_result_list, $p_options);
+
+ // ----- Close
+ $this->privCloseFd();
+
+ // ----- Magic quotes trick
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privAdd()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privAdd($p_filedescr_list, &$p_result_list, &$p_options)
+ {
+ $v_result = 1;
+ $v_list_detail = array();
+
+ // ----- Look if the archive exists or is empty
+ if ((!is_file($this->zipname)) || (filesize($this->zipname) == 0)) {
+
+ // ----- Do a create
+ $v_result = $this->privCreate($p_filedescr_list, $p_result_list, $p_options);
+
+ // ----- Return
+ return $v_result;
+ }
+ // ----- Magic quotes trick
+ $this->privDisableMagicQuotes();
+
+ // ----- Open the zip file
+ if (($v_result = $this->privOpenFd('rb')) != 1) {
+ // ----- Magic quotes trick
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Read the central directory informations
+ $v_central_dir = array();
+ if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) {
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+
+ // ----- Go to beginning of File
+ @rewind($this->zip_fd);
+
+ // ----- Creates a temporay file
+ $v_zip_temp_name = PCLZIP_TEMPORARY_DIR . uniqid('pclzip-') . '.tmp';
+
+ // ----- Open the temporary file in write mode
+ if (($v_zip_temp_fd = @fopen($v_zip_temp_name, 'wb')) == 0) {
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \'' . $v_zip_temp_name . '\' in binary write mode');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Copy the files from the archive to the temporary file
+ // TBC : Here I should better append the file and go back to erase the central dir
+ $v_size = $v_central_dir['offset'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = fread($this->zip_fd, $v_read_size);
+ @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Swap the file descriptor
+ // Here is a trick : I swap the temporary fd with the zip fd, in order to use
+ // the following methods on the temporary fil and not the real archive
+ $v_swap = $this->zip_fd;
+ $this->zip_fd = $v_zip_temp_fd;
+ $v_zip_temp_fd = $v_swap;
+
+ // ----- Add the files
+ $v_header_list = array();
+ if (($v_result = $this->privAddFileList($p_filedescr_list, $v_header_list, $p_options)) != 1) {
+ fclose($v_zip_temp_fd);
+ $this->privCloseFd();
+ @unlink($v_zip_temp_name);
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Store the offset of the central dir
+ $v_offset = @ftell($this->zip_fd);
+
+ // ----- Copy the block of file headers from the old archive
+ $v_size = $v_central_dir['size'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @fread($v_zip_temp_fd, $v_read_size);
+ @fwrite($this->zip_fd, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Create the Central Dir files header
+ for ($i = 0, $v_count = 0; $i < sizeof($v_header_list); $i++) {
+ // ----- Create the file header
+ if ($v_header_list[$i]['status'] == 'ok') {
+ if (($v_result = $this->privWriteCentralFileHeader($v_header_list[$i])) != 1) {
+ fclose($v_zip_temp_fd);
+ $this->privCloseFd();
+ @unlink($v_zip_temp_name);
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Return
+ return $v_result;
+ }
+ $v_count++;
+ }
+
+ // ----- Transform the header to a 'usable' info
+ $this->privConvertHeader2FileInfo($v_header_list[$i], $p_result_list[$i]);
+ }
+
+ // ----- Zip file comment
+ $v_comment = $v_central_dir['comment'];
+ if (isset($p_options[PCLZIP_OPT_COMMENT])) {
+ $v_comment = $p_options[PCLZIP_OPT_COMMENT];
+ }
+ if (isset($p_options[PCLZIP_OPT_ADD_COMMENT])) {
+ $v_comment = $v_comment . $p_options[PCLZIP_OPT_ADD_COMMENT];
+ }
+ if (isset($p_options[PCLZIP_OPT_PREPEND_COMMENT])) {
+ $v_comment = $p_options[PCLZIP_OPT_PREPEND_COMMENT] . $v_comment;
+ }
+
+ // ----- Calculate the size of the central header
+ $v_size = @ftell($this->zip_fd) - $v_offset;
+
+ // ----- Create the central dir footer
+ if (($v_result = $this->privWriteCentralHeader($v_count + $v_central_dir['entries'], $v_size, $v_offset, $v_comment)) != 1) {
+ // ----- Reset the file list
+ unset($v_header_list);
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Swap back the file descriptor
+ $v_swap = $this->zip_fd;
+ $this->zip_fd = $v_zip_temp_fd;
+ $v_zip_temp_fd = $v_swap;
+
+ // ----- Close
+ $this->privCloseFd();
+
+ // ----- Close the temporary file
+ @fclose($v_zip_temp_fd);
+
+ // ----- Magic quotes trick
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Delete the zip file
+ // TBC : I should test the result ...
+ @unlink($this->zipname);
+
+ // ----- Rename the temporary file
+ // TBC : I should test the result ...
+ //@rename($v_zip_temp_name, $this->zipname);
+ PclZipUtilRename($v_zip_temp_name, $this->zipname);
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privOpenFd()
+ // Description :
+ // Parameters :
+ // --------------------------------------------------------------------------------
+ public function privOpenFd($p_mode)
+ {
+ $v_result = 1;
+
+ // ----- Look if already open
+ if ($this->zip_fd != 0) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Zip file \'' . $this->zipname . '\' already open');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Open the zip file
+ if (($this->zip_fd = @fopen($this->zipname, $p_mode)) == 0) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open archive \'' . $this->zipname . '\' in ' . $p_mode . ' mode');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privCloseFd()
+ // Description :
+ // Parameters :
+ // --------------------------------------------------------------------------------
+ public function privCloseFd()
+ {
+ $v_result = 1;
+
+ if ($this->zip_fd != 0) {
+ @fclose($this->zip_fd);
+ }
+ $this->zip_fd = 0;
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privAddList()
+ // Description :
+ // $p_add_dir and $p_remove_dir will give the ability to memorize a path which is
+ // different from the real path of the file. This is usefull if you want to have PclTar
+ // running in any directory, and memorize relative path from an other directory.
+ // Parameters :
+ // $p_list : An array containing the file or directory names to add in the tar
+ // $p_result_list : list of added files with their properties (specially the status field)
+ // $p_add_dir : Path to add in the filename path archived
+ // $p_remove_dir : Path to remove in the filename path archived
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ // function privAddList($p_list, &$p_result_list, $p_add_dir, $p_remove_dir, $p_remove_all_dir, &$p_options)
+ public function privAddList($p_filedescr_list, &$p_result_list, &$p_options)
+ {
+ $v_result = 1;
+
+ // ----- Add the files
+ $v_header_list = array();
+ if (($v_result = $this->privAddFileList($p_filedescr_list, $v_header_list, $p_options)) != 1) {
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Store the offset of the central dir
+ $v_offset = @ftell($this->zip_fd);
+
+ // ----- Create the Central Dir files header
+ for ($i = 0, $v_count = 0; $i < sizeof($v_header_list); $i++) {
+ // ----- Create the file header
+ if ($v_header_list[$i]['status'] == 'ok') {
+ if (($v_result = $this->privWriteCentralFileHeader($v_header_list[$i])) != 1) {
+ // ----- Return
+ return $v_result;
+ }
+ $v_count++;
+ }
+
+ // ----- Transform the header to a 'usable' info
+ $this->privConvertHeader2FileInfo($v_header_list[$i], $p_result_list[$i]);
+ }
+
+ // ----- Zip file comment
+ $v_comment = '';
+ if (isset($p_options[PCLZIP_OPT_COMMENT])) {
+ $v_comment = $p_options[PCLZIP_OPT_COMMENT];
+ }
+
+ // ----- Calculate the size of the central header
+ $v_size = @ftell($this->zip_fd) - $v_offset;
+
+ // ----- Create the central dir footer
+ if (($v_result = $this->privWriteCentralHeader($v_count, $v_size, $v_offset, $v_comment)) != 1) {
+ // ----- Reset the file list
+ unset($v_header_list);
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privAddFileList()
+ // Description :
+ // Parameters :
+ // $p_filedescr_list : An array containing the file description
+ // or directory names to add in the zip
+ // $p_result_list : list of added files with their properties (specially the status field)
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privAddFileList($p_filedescr_list, &$p_result_list, &$p_options)
+ {
+ $v_result = 1;
+ $v_header = array();
+
+ // ----- Recuperate the current number of elt in list
+ $v_nb = sizeof($p_result_list);
+
+ // ----- Loop on the files
+ for ($j = 0; ($j < sizeof($p_filedescr_list)) && ($v_result == 1); $j++) {
+ // ----- Format the filename
+ $p_filedescr_list[$j]['filename'] = PclZipUtilTranslateWinPath($p_filedescr_list[$j]['filename'], false);
+
+ // ----- Skip empty file names
+ // TBC : Can this be possible ? not checked in DescrParseAtt ?
+ if ($p_filedescr_list[$j]['filename'] == "") {
+ continue;
+ }
+
+ // ----- Check the filename
+ if (($p_filedescr_list[$j]['type'] != 'virtual_file') && (!file_exists($p_filedescr_list[$j]['filename']))) {
+ PclZip::privErrorLog(PCLZIP_ERR_MISSING_FILE, "File '" . $p_filedescr_list[$j]['filename'] . "' does not exist");
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Look if it is a file or a dir with no all path remove option
+ // or a dir with all its path removed
+ // if ( (is_file($p_filedescr_list[$j]['filename']))
+ // || ( is_dir($p_filedescr_list[$j]['filename'])
+ if (($p_filedescr_list[$j]['type'] == 'file') || ($p_filedescr_list[$j]['type'] == 'virtual_file') || (($p_filedescr_list[$j]['type'] == 'folder') && (!isset($p_options[PCLZIP_OPT_REMOVE_ALL_PATH]) || !$p_options[PCLZIP_OPT_REMOVE_ALL_PATH]))) {
+
+ // ----- Add the file
+ $v_result = $this->privAddFile($p_filedescr_list[$j], $v_header, $p_options);
+ if ($v_result != 1) {
+ return $v_result;
+ }
+
+ // ----- Store the file infos
+ $p_result_list[$v_nb++] = $v_header;
+ }
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privAddFile()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privAddFile($p_filedescr, &$p_header, &$p_options)
+ {
+ $v_result = 1;
+
+ // ----- Working variable
+ $p_filename = $p_filedescr['filename'];
+
+ // TBC : Already done in the fileAtt check ... ?
+ if ($p_filename == "") {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_PARAMETER, "Invalid file list parameter (invalid or empty list)");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Look for a stored different filename
+ /* TBC : Removed
+ if (isset($p_filedescr['stored_filename'])) {
+ $v_stored_filename = $p_filedescr['stored_filename'];
+ } else {
+ $v_stored_filename = $p_filedescr['stored_filename'];
+ }
+ */
+
+ // ----- Set the file properties
+ clearstatcache();
+ $p_header['version'] = 20;
+ $p_header['version_extracted'] = 10;
+ $p_header['flag'] = 0;
+ $p_header['compression'] = 0;
+ $p_header['crc'] = 0;
+ $p_header['compressed_size'] = 0;
+ $p_header['filename_len'] = strlen($p_filename);
+ $p_header['extra_len'] = 0;
+ $p_header['disk'] = 0;
+ $p_header['internal'] = 0;
+ $p_header['offset'] = 0;
+ $p_header['filename'] = $p_filename;
+ // TBC : Removed $p_header['stored_filename'] = $v_stored_filename;
+ $p_header['stored_filename'] = $p_filedescr['stored_filename'];
+ $p_header['extra'] = '';
+ $p_header['status'] = 'ok';
+ $p_header['index'] = -1;
+
+ // ----- Look for regular file
+ if ($p_filedescr['type'] == 'file') {
+ $p_header['external'] = 0x00000000;
+ $p_header['size'] = filesize($p_filename);
+
+ // ----- Look for regular folder
+ } elseif ($p_filedescr['type'] == 'folder') {
+ $p_header['external'] = 0x00000010;
+ $p_header['mtime'] = filemtime($p_filename);
+ $p_header['size'] = filesize($p_filename);
+
+ // ----- Look for virtual file
+ } elseif ($p_filedescr['type'] == 'virtual_file') {
+ $p_header['external'] = 0x00000000;
+ $p_header['size'] = strlen($p_filedescr['content']);
+ }
+
+ // ----- Look for filetime
+ if (isset($p_filedescr['mtime'])) {
+ $p_header['mtime'] = $p_filedescr['mtime'];
+ } elseif ($p_filedescr['type'] == 'virtual_file') {
+ $p_header['mtime'] = time();
+ } else {
+ $p_header['mtime'] = filemtime($p_filename);
+ }
+
+ // ------ Look for file comment
+ if (isset($p_filedescr['comment'])) {
+ $p_header['comment_len'] = strlen($p_filedescr['comment']);
+ $p_header['comment'] = $p_filedescr['comment'];
+ } else {
+ $p_header['comment_len'] = 0;
+ $p_header['comment'] = '';
+ }
+
+ // ----- Look for pre-add callback
+ if (isset($p_options[PCLZIP_CB_PRE_ADD])) {
+
+ // ----- Generate a local information
+ $v_local_header = array();
+ $this->privConvertHeader2FileInfo($p_header, $v_local_header);
+
+ // ----- Call the callback
+ // Here I do not use call_user_func() because I need to send a reference to the
+ // header.
+ // eval('$v_result = '.$p_options[PCLZIP_CB_PRE_ADD].'(PCLZIP_CB_PRE_ADD, $v_local_header);');
+ $v_result = $p_options[PCLZIP_CB_PRE_ADD](PCLZIP_CB_PRE_ADD, $v_local_header);
+ if ($v_result == 0) {
+ // ----- Change the file status
+ $p_header['status'] = "skipped";
+ $v_result = 1;
+ }
+
+ // ----- Update the informations
+ // Only some fields can be modified
+ if ($p_header['stored_filename'] != $v_local_header['stored_filename']) {
+ $p_header['stored_filename'] = PclZipUtilPathReduction($v_local_header['stored_filename']);
+ }
+ }
+
+ // ----- Look for empty stored filename
+ if ($p_header['stored_filename'] == "") {
+ $p_header['status'] = "filtered";
+ }
+
+ // ----- Check the path length
+ if (strlen($p_header['stored_filename']) > 0xFF) {
+ $p_header['status'] = 'filename_too_long';
+ }
+
+ // ----- Look if no error, or file not skipped
+ if ($p_header['status'] == 'ok') {
+
+ // ----- Look for a file
+ if ($p_filedescr['type'] == 'file') {
+ // ----- Look for using temporary file to zip
+ if ((!isset($p_options[PCLZIP_OPT_TEMP_FILE_OFF])) && (isset($p_options[PCLZIP_OPT_TEMP_FILE_ON]) || (isset($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD]) && ($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD] <= $p_header['size'])))) {
+ $v_result = $this->privAddFileUsingTempFile($p_filedescr, $p_header, $p_options);
+ if ($v_result < PCLZIP_ERR_NO_ERROR) {
+ return $v_result;
+ }
+
+ // ----- Use "in memory" zip algo
+ } else {
+
+ // ----- Open the source file
+ if (($v_file = @fopen($p_filename, "rb")) == 0) {
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, "Unable to open file '$p_filename' in binary read mode");
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the file content
+ $v_content = @fread($v_file, $p_header['size']);
+
+ // ----- Close the file
+ @fclose($v_file);
+
+ // ----- Calculate the CRC
+ $p_header['crc'] = @crc32($v_content);
+
+ // ----- Look for no compression
+ if ($p_options[PCLZIP_OPT_NO_COMPRESSION]) {
+ // ----- Set header parameters
+ $p_header['compressed_size'] = $p_header['size'];
+ $p_header['compression'] = 0;
+
+ // ----- Look for normal compression
+ } else {
+ // ----- Compress the content
+ $v_content = @gzdeflate($v_content);
+
+ // ----- Set header parameters
+ $p_header['compressed_size'] = strlen($v_content);
+ $p_header['compression'] = 8;
+ }
+
+ // ----- Call the header generation
+ if (($v_result = $this->privWriteFileHeader($p_header)) != 1) {
+ @fclose($v_file);
+
+ return $v_result;
+ }
+
+ // ----- Write the compressed (or not) content
+ @fwrite($this->zip_fd, $v_content, $p_header['compressed_size']);
+
+ }
+
+ // ----- Look for a virtual file (a file from string)
+ } elseif ($p_filedescr['type'] == 'virtual_file') {
+
+ $v_content = $p_filedescr['content'];
+
+ // ----- Calculate the CRC
+ $p_header['crc'] = @crc32($v_content);
+
+ // ----- Look for no compression
+ if ($p_options[PCLZIP_OPT_NO_COMPRESSION]) {
+ // ----- Set header parameters
+ $p_header['compressed_size'] = $p_header['size'];
+ $p_header['compression'] = 0;
+
+ // ----- Look for normal compression
+ } else {
+ // ----- Compress the content
+ $v_content = @gzdeflate($v_content);
+
+ // ----- Set header parameters
+ $p_header['compressed_size'] = strlen($v_content);
+ $p_header['compression'] = 8;
+ }
+
+ // ----- Call the header generation
+ if (($v_result = $this->privWriteFileHeader($p_header)) != 1) {
+ @fclose($v_file);
+
+ return $v_result;
+ }
+
+ // ----- Write the compressed (or not) content
+ @fwrite($this->zip_fd, $v_content, $p_header['compressed_size']);
+
+ // ----- Look for a directory
+ } elseif ($p_filedescr['type'] == 'folder') {
+ // ----- Look for directory last '/'
+ if (@substr($p_header['stored_filename'], -1) != '/') {
+ $p_header['stored_filename'] .= '/';
+ }
+
+ // ----- Set the file properties
+ $p_header['size'] = 0;
+ //$p_header['external'] = 0x41FF0010; // Value for a folder : to be checked
+ $p_header['external'] = 0x00000010; // Value for a folder : to be checked
+
+ // ----- Call the header generation
+ if (($v_result = $this->privWriteFileHeader($p_header)) != 1) {
+ return $v_result;
+ }
+ }
+ }
+
+ // ----- Look for post-add callback
+ if (isset($p_options[PCLZIP_CB_POST_ADD])) {
+
+ // ----- Generate a local information
+ $v_local_header = array();
+ $this->privConvertHeader2FileInfo($p_header, $v_local_header);
+
+ // ----- Call the callback
+ // Here I do not use call_user_func() because I need to send a reference to the
+ // header.
+ // eval('$v_result = '.$p_options[PCLZIP_CB_POST_ADD].'(PCLZIP_CB_POST_ADD, $v_local_header);');
+ $v_result = $p_options[PCLZIP_CB_POST_ADD](PCLZIP_CB_POST_ADD, $v_local_header);
+ if ($v_result == 0) {
+ // ----- Ignored
+ $v_result = 1;
+ }
+
+ // ----- Update the informations
+ // Nothing can be modified
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privAddFileUsingTempFile()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privAddFileUsingTempFile($p_filedescr, &$p_header, &$p_options)
+ {
+ $v_result = PCLZIP_ERR_NO_ERROR;
+
+ // ----- Working variable
+ $p_filename = $p_filedescr['filename'];
+
+ // ----- Open the source file
+ if (($v_file = @fopen($p_filename, "rb")) == 0) {
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, "Unable to open file '$p_filename' in binary read mode");
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Creates a compressed temporary file
+ $v_gzip_temp_name = PCLZIP_TEMPORARY_DIR . uniqid('pclzip-') . '.gz';
+ if (($v_file_compressed = @gzopen($v_gzip_temp_name, "wb")) == 0) {
+ fclose($v_file);
+ PclZip::privErrorLog(PCLZIP_ERR_WRITE_OPEN_FAIL, 'Unable to open temporary file \'' . $v_gzip_temp_name . '\' in binary write mode');
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks
+ $v_size = filesize($p_filename);
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @fread($v_file, $v_read_size);
+ //$v_binary_data = pack('a'.$v_read_size, $v_buffer);
+ @gzputs($v_file_compressed, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Close the file
+ @fclose($v_file);
+ @gzclose($v_file_compressed);
+
+ // ----- Check the minimum file size
+ if (filesize($v_gzip_temp_name) < 18) {
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'gzip temporary file \'' . $v_gzip_temp_name . '\' has invalid filesize - should be minimum 18 bytes');
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Extract the compressed attributes
+ if (($v_file_compressed = @fopen($v_gzip_temp_name, "rb")) == 0) {
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \'' . $v_gzip_temp_name . '\' in binary read mode');
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the gzip file header
+ $v_binary_data = @fread($v_file_compressed, 10);
+ $v_data_header = unpack('a1id1/a1id2/a1cm/a1flag/Vmtime/a1xfl/a1os', $v_binary_data);
+
+ // ----- Check some parameters
+ $v_data_header['os'] = bin2hex($v_data_header['os']);
+
+ // ----- Read the gzip file footer
+ @fseek($v_file_compressed, filesize($v_gzip_temp_name) - 8);
+ $v_binary_data = @fread($v_file_compressed, 8);
+ $v_data_footer = unpack('Vcrc/Vcompressed_size', $v_binary_data);
+
+ // ----- Set the attributes
+ $p_header['compression'] = ord($v_data_header['cm']);
+ //$p_header['mtime'] = $v_data_header['mtime'];
+ $p_header['crc'] = $v_data_footer['crc'];
+ $p_header['compressed_size'] = filesize($v_gzip_temp_name) - 18;
+
+ // ----- Close the file
+ @fclose($v_file_compressed);
+
+ // ----- Call the header generation
+ if (($v_result = $this->privWriteFileHeader($p_header)) != 1) {
+ return $v_result;
+ }
+
+ // ----- Add the compressed data
+ if (($v_file_compressed = @fopen($v_gzip_temp_name, "rb")) == 0) {
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \'' . $v_gzip_temp_name . '\' in binary read mode');
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks
+ fseek($v_file_compressed, 10);
+ $v_size = $p_header['compressed_size'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @fread($v_file_compressed, $v_read_size);
+ //$v_binary_data = pack('a'.$v_read_size, $v_buffer);
+ @fwrite($this->zip_fd, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Close the file
+ @fclose($v_file_compressed);
+
+ // ----- Unlink the temporary file
+ @unlink($v_gzip_temp_name);
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privCalculateStoredFilename()
+ // Description :
+ // Based on file descriptor properties and global options, this method
+ // calculate the filename that will be stored in the archive.
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privCalculateStoredFilename(&$p_filedescr, &$p_options)
+ {
+ $v_result = 1;
+
+ // ----- Working variables
+ $p_filename = $p_filedescr['filename'];
+ if (isset($p_options[PCLZIP_OPT_ADD_PATH])) {
+ $p_add_dir = $p_options[PCLZIP_OPT_ADD_PATH];
+ } else {
+ $p_add_dir = '';
+ }
+ if (isset($p_options[PCLZIP_OPT_REMOVE_PATH])) {
+ $p_remove_dir = $p_options[PCLZIP_OPT_REMOVE_PATH];
+ } else {
+ $p_remove_dir = '';
+ }
+ if (isset($p_options[PCLZIP_OPT_REMOVE_ALL_PATH])) {
+ $p_remove_all_dir = $p_options[PCLZIP_OPT_REMOVE_ALL_PATH];
+ } else {
+ $p_remove_all_dir = 0;
+ }
+
+ // ----- Look for full name change
+ if (isset($p_filedescr['new_full_name'])) {
+ // ----- Remove drive letter if any
+ $v_stored_filename = PclZipUtilTranslateWinPath($p_filedescr['new_full_name']);
+
+ // ----- Look for path and/or short name change
+ } else {
+
+ // ----- Look for short name change
+ // Its when we cahnge just the filename but not the path
+ if (isset($p_filedescr['new_short_name'])) {
+ $v_path_info = pathinfo($p_filename);
+ $v_dir = '';
+ if ($v_path_info['dirname'] != '') {
+ $v_dir = $v_path_info['dirname'] . '/';
+ }
+ $v_stored_filename = $v_dir . $p_filedescr['new_short_name'];
+ } else {
+ // ----- Calculate the stored filename
+ $v_stored_filename = $p_filename;
+ }
+
+ // ----- Look for all path to remove
+ if ($p_remove_all_dir) {
+ $v_stored_filename = basename($p_filename);
+
+ // ----- Look for partial path remove
+ } elseif ($p_remove_dir != "") {
+ if (substr($p_remove_dir, -1) != '/') {
+ $p_remove_dir .= "/";
+ }
+
+ if ((substr($p_filename, 0, 2) == "./") || (substr($p_remove_dir, 0, 2) == "./")) {
+
+ if ((substr($p_filename, 0, 2) == "./") && (substr($p_remove_dir, 0, 2) != "./")) {
+ $p_remove_dir = "./" . $p_remove_dir;
+ }
+ if ((substr($p_filename, 0, 2) != "./") && (substr($p_remove_dir, 0, 2) == "./")) {
+ $p_remove_dir = substr($p_remove_dir, 2);
+ }
+ }
+
+ $v_compare = PclZipUtilPathInclusion($p_remove_dir, $v_stored_filename);
+ if ($v_compare > 0) {
+ if ($v_compare == 2) {
+ $v_stored_filename = "";
+ } else {
+ $v_stored_filename = substr($v_stored_filename, strlen($p_remove_dir));
+ }
+ }
+ }
+
+ // ----- Remove drive letter if any
+ $v_stored_filename = PclZipUtilTranslateWinPath($v_stored_filename);
+
+ // ----- Look for path to add
+ if ($p_add_dir != "") {
+ if (substr($p_add_dir, -1) == "/") {
+ $v_stored_filename = $p_add_dir . $v_stored_filename;
+ } else {
+ $v_stored_filename = $p_add_dir . "/" . $v_stored_filename;
+ }
+ }
+ }
+
+ // ----- Filename (reduce the path of stored name)
+ $v_stored_filename = PclZipUtilPathReduction($v_stored_filename);
+ $p_filedescr['stored_filename'] = $v_stored_filename;
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privWriteFileHeader()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privWriteFileHeader(&$p_header)
+ {
+ $v_result = 1;
+
+ // ----- Store the offset position of the file
+ $p_header['offset'] = ftell($this->zip_fd);
+
+ // ----- Transform UNIX mtime to DOS format mdate/mtime
+ $v_date = getdate($p_header['mtime']);
+ $v_mtime = ($v_date['hours'] << 11) + ($v_date['minutes'] << 5) + $v_date['seconds'] / 2;
+ $v_mdate = (($v_date['year'] - 1980) << 9) + ($v_date['mon'] << 5) + $v_date['mday'];
+
+ // ----- Packed data
+ $v_binary_data = pack("VvvvvvVVVvv", 0x04034b50, $p_header['version_extracted'], $p_header['flag'], $p_header['compression'], $v_mtime, $v_mdate, $p_header['crc'], $p_header['compressed_size'], $p_header['size'], strlen($p_header['stored_filename']), $p_header['extra_len']);
+
+ // ----- Write the first 148 bytes of the header in the archive
+ fputs($this->zip_fd, $v_binary_data, 30);
+
+ // ----- Write the variable fields
+ if (strlen($p_header['stored_filename']) != 0) {
+ fputs($this->zip_fd, $p_header['stored_filename'], strlen($p_header['stored_filename']));
+ }
+ if ($p_header['extra_len'] != 0) {
+ fputs($this->zip_fd, $p_header['extra'], $p_header['extra_len']);
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privWriteCentralFileHeader()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privWriteCentralFileHeader(&$p_header)
+ {
+ $v_result = 1;
+
+ // TBC
+ //for (reset($p_header); $key = key($p_header); next($p_header)) {
+ //}
+
+ // ----- Transform UNIX mtime to DOS format mdate/mtime
+ $v_date = getdate($p_header['mtime']);
+ $v_mtime = ($v_date['hours'] << 11) + ($v_date['minutes'] << 5) + $v_date['seconds'] / 2;
+ $v_mdate = (($v_date['year'] - 1980) << 9) + ($v_date['mon'] << 5) + $v_date['mday'];
+
+ // ----- Packed data
+ $v_binary_data = pack("VvvvvvvVVVvvvvvVV", 0x02014b50, $p_header['version'], $p_header['version_extracted'], $p_header['flag'], $p_header['compression'], $v_mtime, $v_mdate, $p_header['crc'], $p_header['compressed_size'], $p_header['size'], strlen($p_header['stored_filename']), $p_header['extra_len'], $p_header['comment_len'], $p_header['disk'], $p_header['internal'], $p_header['external'], $p_header['offset']);
+
+ // ----- Write the 42 bytes of the header in the zip file
+ fputs($this->zip_fd, $v_binary_data, 46);
+
+ // ----- Write the variable fields
+ if (strlen($p_header['stored_filename']) != 0) {
+ fputs($this->zip_fd, $p_header['stored_filename'], strlen($p_header['stored_filename']));
+ }
+ if ($p_header['extra_len'] != 0) {
+ fputs($this->zip_fd, $p_header['extra'], $p_header['extra_len']);
+ }
+ if ($p_header['comment_len'] != 0) {
+ fputs($this->zip_fd, $p_header['comment'], $p_header['comment_len']);
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privWriteCentralHeader()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privWriteCentralHeader($p_nb_entries, $p_size, $p_offset, $p_comment)
+ {
+ $v_result = 1;
+
+ // ----- Packed data
+ $v_binary_data = pack("VvvvvVVv", 0x06054b50, 0, 0, $p_nb_entries, $p_nb_entries, $p_size, $p_offset, strlen($p_comment));
+
+ // ----- Write the 22 bytes of the header in the zip file
+ fputs($this->zip_fd, $v_binary_data, 22);
+
+ // ----- Write the variable fields
+ if (strlen($p_comment) != 0) {
+ fputs($this->zip_fd, $p_comment, strlen($p_comment));
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privList()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privList(&$p_list)
+ {
+ $v_result = 1;
+
+ // ----- Magic quotes trick
+ $this->privDisableMagicQuotes();
+
+ // ----- Open the zip file
+ if (($this->zip_fd = @fopen($this->zipname, 'rb')) == 0) {
+ // ----- Magic quotes trick
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open archive \'' . $this->zipname . '\' in binary read mode');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the central directory informations
+ $v_central_dir = array();
+ if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) {
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+
+ // ----- Go to beginning of Central Dir
+ @rewind($this->zip_fd);
+ if (@fseek($this->zip_fd, $v_central_dir['offset'])) {
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Read each entry
+ for ($i = 0; $i < $v_central_dir['entries']; $i++) {
+ // ----- Read the file header
+ if (($v_result = $this->privReadCentralFileHeader($v_header)) != 1) {
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+ $v_header['index'] = $i;
+
+ // ----- Get the only interesting attributes
+ $this->privConvertHeader2FileInfo($v_header, $p_list[$i]);
+ unset($v_header);
+ }
+
+ // ----- Close the zip file
+ $this->privCloseFd();
+
+ // ----- Magic quotes trick
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privConvertHeader2FileInfo()
+ // Description :
+ // This function takes the file informations from the central directory
+ // entries and extract the interesting parameters that will be given back.
+ // The resulting file infos are set in the array $p_info
+ // $p_info['filename'] : Filename with full path. Given by user (add),
+ // extracted in the filesystem (extract).
+ // $p_info['stored_filename'] : Stored filename in the archive.
+ // $p_info['size'] = Size of the file.
+ // $p_info['compressed_size'] = Compressed size of the file.
+ // $p_info['mtime'] = Last modification date of the file.
+ // $p_info['comment'] = Comment associated with the file.
+ // $p_info['folder'] = true/false : indicates if the entry is a folder or not.
+ // $p_info['status'] = status of the action on the file.
+ // $p_info['crc'] = CRC of the file content.
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privConvertHeader2FileInfo($p_header, &$p_info)
+ {
+ $v_result = 1;
+
+ // ----- Get the interesting attributes
+ $v_temp_path = PclZipUtilPathReduction($p_header['filename']);
+ $p_info['filename'] = $v_temp_path;
+ $v_temp_path = PclZipUtilPathReduction($p_header['stored_filename']);
+ $p_info['stored_filename'] = $v_temp_path;
+ $p_info['size'] = $p_header['size'];
+ $p_info['compressed_size'] = $p_header['compressed_size'];
+ $p_info['mtime'] = $p_header['mtime'];
+ $p_info['comment'] = $p_header['comment'];
+ $p_info['folder'] = (($p_header['external'] & 0x00000010) == 0x00000010);
+ $p_info['index'] = $p_header['index'];
+ $p_info['status'] = $p_header['status'];
+ $p_info['crc'] = $p_header['crc'];
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privExtractByRule()
+ // Description :
+ // Extract a file or directory depending of rules (by index, by name, ...)
+ // Parameters :
+ // $p_file_list : An array where will be placed the properties of each
+ // extracted file
+ // $p_path : Path to add while writing the extracted files
+ // $p_remove_path : Path to remove (from the file memorized path) while writing the
+ // extracted files. If the path does not match the file path,
+ // the file is extracted with its memorized path.
+ // $p_remove_path does not apply to 'list' mode.
+ // $p_path and $p_remove_path are commulative.
+ // Return Values :
+ // 1 on success,0 or less on error (see error code list)
+ // --------------------------------------------------------------------------------
+ public function privExtractByRule(&$p_file_list, $p_path, $p_remove_path, $p_remove_all_path, &$p_options)
+ {
+ $v_result = 1;
+
+ // ----- Magic quotes trick
+ $this->privDisableMagicQuotes();
+
+ // ----- Check the path
+ if (($p_path == "") || ((substr($p_path, 0, 1) != "/") && (substr($p_path, 0, 3) != "../") && (substr($p_path, 1, 2) != ":/"))) {
+ $p_path = "./" . $p_path;
+ }
+
+ // ----- Reduce the path last (and duplicated) '/'
+ if (($p_path != "./") && ($p_path != "/")) {
+ // ----- Look for the path end '/'
+ while (substr($p_path, -1) == "/") {
+ $p_path = substr($p_path, 0, strlen($p_path) - 1);
+ }
+ }
+
+ // ----- Look for path to remove format (should end by /)
+ if (($p_remove_path != "") && (substr($p_remove_path, -1) != '/')) {
+ $p_remove_path .= '/';
+ }
+ $p_remove_path_size = strlen($p_remove_path);
+
+ // ----- Open the zip file
+ if (($v_result = $this->privOpenFd('rb')) != 1) {
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+
+ // ----- Read the central directory informations
+ $v_central_dir = array();
+ if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+
+ // ----- Start at beginning of Central Dir
+ $v_pos_entry = $v_central_dir['offset'];
+
+ // ----- Read each entry
+ $j_start = 0;
+ for ($i = 0, $v_nb_extracted = 0; $i < $v_central_dir['entries']; $i++) {
+
+ // ----- Read next Central dir entry
+ @rewind($this->zip_fd);
+ if (@fseek($this->zip_fd, $v_pos_entry)) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the file header
+ $v_header = array();
+ if (($v_result = $this->privReadCentralFileHeader($v_header)) != 1) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+
+ // ----- Store the index
+ $v_header['index'] = $i;
+
+ // ----- Store the file position
+ $v_pos_entry = ftell($this->zip_fd);
+
+ // ----- Look for the specific extract rules
+ $v_extract = false;
+
+ // ----- Look for extract by name rule
+ if ((isset($p_options[PCLZIP_OPT_BY_NAME])) && ($p_options[PCLZIP_OPT_BY_NAME] != 0)) {
+
+ // ----- Look if the filename is in the list
+ for ($j = 0; ($j < sizeof($p_options[PCLZIP_OPT_BY_NAME])) && (!$v_extract); $j++) {
+
+ // ----- Look for a directory
+ if (substr($p_options[PCLZIP_OPT_BY_NAME][$j], -1) == "/") {
+
+ // ----- Look if the directory is in the filename path
+ if ((strlen($v_header['stored_filename']) > strlen($p_options[PCLZIP_OPT_BY_NAME][$j])) && (substr($v_header['stored_filename'], 0, strlen($p_options[PCLZIP_OPT_BY_NAME][$j])) == $p_options[PCLZIP_OPT_BY_NAME][$j])) {
+ $v_extract = true;
+ }
+
+ // ----- Look for a filename
+ } elseif ($v_header['stored_filename'] == $p_options[PCLZIP_OPT_BY_NAME][$j]) {
+ $v_extract = true;
+ }
+ }
+
+ // ----- Look for extract by preg rule
+ } elseif ((isset($p_options[PCLZIP_OPT_BY_PREG])) && ($p_options[PCLZIP_OPT_BY_PREG] != "")) {
+
+ if (preg_match($p_options[PCLZIP_OPT_BY_PREG], $v_header['stored_filename'])) {
+ $v_extract = true;
+ }
+
+ // ----- Look for extract by index rule
+ } elseif ((isset($p_options[PCLZIP_OPT_BY_INDEX])) && ($p_options[PCLZIP_OPT_BY_INDEX] != 0)) {
+
+ // ----- Look if the index is in the list
+ for ($j = $j_start; ($j < sizeof($p_options[PCLZIP_OPT_BY_INDEX])) && (!$v_extract); $j++) {
+
+ if (($i >= $p_options[PCLZIP_OPT_BY_INDEX][$j]['start']) && ($i <= $p_options[PCLZIP_OPT_BY_INDEX][$j]['end'])) {
+ $v_extract = true;
+ }
+ if ($i >= $p_options[PCLZIP_OPT_BY_INDEX][$j]['end']) {
+ $j_start = $j + 1;
+ }
+
+ if ($p_options[PCLZIP_OPT_BY_INDEX][$j]['start'] > $i) {
+ break;
+ }
+ }
+
+ // ----- Look for no rule, which means extract all the archive
+ } else {
+ $v_extract = true;
+ }
+
+ // ----- Check compression method
+ if (($v_extract) && (($v_header['compression'] != 8) && ($v_header['compression'] != 0))) {
+ $v_header['status'] = 'unsupported_compression';
+
+ // ----- Look for PCLZIP_OPT_STOP_ON_ERROR
+ if ((isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) && ($p_options[PCLZIP_OPT_STOP_ON_ERROR] === true)) {
+
+ $this->privSwapBackMagicQuotes();
+
+ PclZip::privErrorLog(PCLZIP_ERR_UNSUPPORTED_COMPRESSION, "Filename '" . $v_header['stored_filename'] . "' is " . "compressed by an unsupported compression " . "method (" . $v_header['compression'] . ") ");
+
+ return PclZip::errorCode();
+ }
+ }
+
+ // ----- Check encrypted files
+ if (($v_extract) && (($v_header['flag'] & 1) == 1)) {
+ $v_header['status'] = 'unsupported_encryption';
+
+ // ----- Look for PCLZIP_OPT_STOP_ON_ERROR
+ if ((isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) && ($p_options[PCLZIP_OPT_STOP_ON_ERROR] === true)) {
+
+ $this->privSwapBackMagicQuotes();
+
+ PclZip::privErrorLog(PCLZIP_ERR_UNSUPPORTED_ENCRYPTION, "Unsupported encryption for " . " filename '" . $v_header['stored_filename'] . "'");
+
+ return PclZip::errorCode();
+ }
+ }
+
+ // ----- Look for real extraction
+ if (($v_extract) && ($v_header['status'] != 'ok')) {
+ $v_result = $this->privConvertHeader2FileInfo($v_header, $p_file_list[$v_nb_extracted++]);
+ if ($v_result != 1) {
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+
+ $v_extract = false;
+ }
+
+ // ----- Look for real extraction
+ if ($v_extract) {
+
+ // ----- Go to the file position
+ @rewind($this->zip_fd);
+ if (@fseek($this->zip_fd, $v_header['offset'])) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Look for extraction as string
+ if ($p_options[PCLZIP_OPT_EXTRACT_AS_STRING]) {
+
+ $v_string = '';
+
+ // ----- Extracting the file
+ $v_result1 = $this->privExtractFileAsString($v_header, $v_string, $p_options);
+ if ($v_result1 < 1) {
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result1;
+ }
+
+ // ----- Get the only interesting attributes
+ if (($v_result = $this->privConvertHeader2FileInfo($v_header, $p_file_list[$v_nb_extracted])) != 1) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+
+ // ----- Set the file content
+ $p_file_list[$v_nb_extracted]['content'] = $v_string;
+
+ // ----- Next extracted file
+ $v_nb_extracted++;
+
+ // ----- Look for user callback abort
+ if ($v_result1 == 2) {
+ break;
+ }
+
+ // ----- Look for extraction in standard output
+ } elseif ((isset($p_options[PCLZIP_OPT_EXTRACT_IN_OUTPUT])) && ($p_options[PCLZIP_OPT_EXTRACT_IN_OUTPUT])) {
+ // ----- Extracting the file in standard output
+ $v_result1 = $this->privExtractFileInOutput($v_header, $p_options);
+ if ($v_result1 < 1) {
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result1;
+ }
+
+ // ----- Get the only interesting attributes
+ if (($v_result = $this->privConvertHeader2FileInfo($v_header, $p_file_list[$v_nb_extracted++])) != 1) {
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+
+ // ----- Look for user callback abort
+ if ($v_result1 == 2) {
+ break;
+ }
+
+ // ----- Look for normal extraction
+ } else {
+ // ----- Extracting the file
+ $v_result1 = $this->privExtractFile($v_header, $p_path, $p_remove_path, $p_remove_all_path, $p_options);
+ if ($v_result1 < 1) {
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result1;
+ }
+
+ // ----- Get the only interesting attributes
+ if (($v_result = $this->privConvertHeader2FileInfo($v_header, $p_file_list[$v_nb_extracted++])) != 1) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ return $v_result;
+ }
+
+ // ----- Look for user callback abort
+ if ($v_result1 == 2) {
+ break;
+ }
+ }
+ }
+ }
+
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $this->privSwapBackMagicQuotes();
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privExtractFile()
+ // Description :
+ // Parameters :
+ // Return Values :
+ //
+ // 1 : ... ?
+ // PCLZIP_ERR_USER_ABORTED(2) : User ask for extraction stop in callback
+ // --------------------------------------------------------------------------------
+ public function privExtractFile(&$p_entry, $p_path, $p_remove_path, $p_remove_all_path, &$p_options)
+ {
+ $v_result = 1;
+
+ // ----- Read the file header
+ if (($v_result = $this->privReadFileHeader($v_header)) != 1) {
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Check that the file header is coherent with $p_entry info
+ if ($this->privCheckFileHeaders($v_header, $p_entry) != 1) {
+ // TBC
+ }
+
+ // ----- Look for all path to remove
+ if ($p_remove_all_path == true) {
+ // ----- Look for folder entry that not need to be extracted
+ if (($p_entry['external'] & 0x00000010) == 0x00000010) {
+
+ $p_entry['status'] = "filtered";
+
+ return $v_result;
+ }
+
+ // ----- Get the basename of the path
+ $p_entry['filename'] = basename($p_entry['filename']);
+
+ // ----- Look for path to remove
+ } elseif ($p_remove_path != "") {
+ if (PclZipUtilPathInclusion($p_remove_path, $p_entry['filename']) == 2) {
+
+ // ----- Change the file status
+ $p_entry['status'] = "filtered";
+
+ // ----- Return
+ return $v_result;
+ }
+
+ $p_remove_path_size = strlen($p_remove_path);
+ if (substr($p_entry['filename'], 0, $p_remove_path_size) == $p_remove_path) {
+
+ // ----- Remove the path
+ $p_entry['filename'] = substr($p_entry['filename'], $p_remove_path_size);
+
+ }
+ }
+
+ // ----- Add the path
+ if ($p_path != '') {
+ $p_entry['filename'] = $p_path . "/" . $p_entry['filename'];
+ }
+
+ // ----- Check a base_dir_restriction
+ if (isset($p_options[PCLZIP_OPT_EXTRACT_DIR_RESTRICTION])) {
+ $v_inclusion = PclZipUtilPathInclusion($p_options[PCLZIP_OPT_EXTRACT_DIR_RESTRICTION], $p_entry['filename']);
+ if ($v_inclusion == 0) {
+
+ PclZip::privErrorLog(PCLZIP_ERR_DIRECTORY_RESTRICTION, "Filename '" . $p_entry['filename'] . "' is " . "outside PCLZIP_OPT_EXTRACT_DIR_RESTRICTION");
+
+ return PclZip::errorCode();
+ }
+ }
+
+ // ----- Look for pre-extract callback
+ if (isset($p_options[PCLZIP_CB_PRE_EXTRACT])) {
+
+ // ----- Generate a local information
+ $v_local_header = array();
+ $this->privConvertHeader2FileInfo($p_entry, $v_local_header);
+
+ // ----- Call the callback
+ // Here I do not use call_user_func() because I need to send a reference to the
+ // header.
+ // eval('$v_result = '.$p_options[PCLZIP_CB_PRE_EXTRACT].'(PCLZIP_CB_PRE_EXTRACT, $v_local_header);');
+ $v_result = $p_options[PCLZIP_CB_PRE_EXTRACT](PCLZIP_CB_PRE_EXTRACT, $v_local_header);
+ if ($v_result == 0) {
+ // ----- Change the file status
+ $p_entry['status'] = "skipped";
+ $v_result = 1;
+ }
+
+ // ----- Look for abort result
+ if ($v_result == 2) {
+ // ----- This status is internal and will be changed in 'skipped'
+ $p_entry['status'] = "aborted";
+ $v_result = PCLZIP_ERR_USER_ABORTED;
+ }
+
+ // ----- Update the informations
+ // Only some fields can be modified
+ $p_entry['filename'] = $v_local_header['filename'];
+ }
+
+ // ----- Look if extraction should be done
+ if ($p_entry['status'] == 'ok') {
+
+ // ----- Look for specific actions while the file exist
+ if (file_exists($p_entry['filename'])) {
+
+ // ----- Look if file is a directory
+ if (is_dir($p_entry['filename'])) {
+
+ // ----- Change the file status
+ $p_entry['status'] = "already_a_directory";
+
+ // ----- Look for PCLZIP_OPT_STOP_ON_ERROR
+ // For historical reason first PclZip implementation does not stop
+ // when this kind of error occurs.
+ if ((isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) && ($p_options[PCLZIP_OPT_STOP_ON_ERROR] === true)) {
+
+ PclZip::privErrorLog(PCLZIP_ERR_ALREADY_A_DIRECTORY, "Filename '" . $p_entry['filename'] . "' is " . "already used by an existing directory");
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Look if file is write protected
+ } elseif (!is_writeable($p_entry['filename'])) {
+
+ // ----- Change the file status
+ $p_entry['status'] = "write_protected";
+
+ // ----- Look for PCLZIP_OPT_STOP_ON_ERROR
+ // For historical reason first PclZip implementation does not stop
+ // when this kind of error occurs.
+ if ((isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) && ($p_options[PCLZIP_OPT_STOP_ON_ERROR] === true)) {
+
+ PclZip::privErrorLog(PCLZIP_ERR_WRITE_OPEN_FAIL, "Filename '" . $p_entry['filename'] . "' exists " . "and is write protected");
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Look if the extracted file is older
+ } elseif (filemtime($p_entry['filename']) > $p_entry['mtime']) {
+ // ----- Change the file status
+ if ((isset($p_options[PCLZIP_OPT_REPLACE_NEWER])) && ($p_options[PCLZIP_OPT_REPLACE_NEWER] === true)) {
+ } else {
+ $p_entry['status'] = "newer_exist";
+
+ // ----- Look for PCLZIP_OPT_STOP_ON_ERROR
+ // For historical reason first PclZip implementation does not stop
+ // when this kind of error occurs.
+ if ((isset($p_options[PCLZIP_OPT_STOP_ON_ERROR])) && ($p_options[PCLZIP_OPT_STOP_ON_ERROR] === true)) {
+
+ PclZip::privErrorLog(PCLZIP_ERR_WRITE_OPEN_FAIL, "Newer version of '" . $p_entry['filename'] . "' exists " . "and option PCLZIP_OPT_REPLACE_NEWER is not selected");
+
+ return PclZip::errorCode();
+ }
+ }
+ } else {
+ }
+
+ // ----- Check the directory availability and create it if necessary
+ } else {
+ if ((($p_entry['external'] & 0x00000010) == 0x00000010) || (substr($p_entry['filename'], -1) == '/')) {
+ $v_dir_to_check = $p_entry['filename'];
+ } elseif (!strstr($p_entry['filename'], "/")) {
+ $v_dir_to_check = "";
+ } else {
+ $v_dir_to_check = dirname($p_entry['filename']);
+ }
+
+ if (($v_result = $this->privDirCheck($v_dir_to_check, (($p_entry['external'] & 0x00000010) == 0x00000010))) != 1) {
+
+ // ----- Change the file status
+ $p_entry['status'] = "path_creation_fail";
+
+ // ----- Return
+ //return $v_result;
+ $v_result = 1;
+ }
+ }
+ }
+
+ // ----- Look if extraction should be done
+ if ($p_entry['status'] == 'ok') {
+
+ // ----- Do the extraction (if not a folder)
+ if (!(($p_entry['external'] & 0x00000010) == 0x00000010)) {
+ // ----- Look for not compressed file
+ if ($p_entry['compression'] == 0) {
+
+ // ----- Opening destination file
+ if (($v_dest_file = @fopen($p_entry['filename'], 'wb')) == 0) {
+
+ // ----- Change the file status
+ $p_entry['status'] = "write_error";
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks
+ $v_size = $p_entry['compressed_size'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @fread($this->zip_fd, $v_read_size);
+ /* Try to speed up the code
+ $v_binary_data = pack('a'.$v_read_size, $v_buffer);
+ @fwrite($v_dest_file, $v_binary_data, $v_read_size);
+ */
+ @fwrite($v_dest_file, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Closing the destination file
+ fclose($v_dest_file);
+
+ // ----- Change the file mtime
+ touch($p_entry['filename'], $p_entry['mtime']);
+
+ } else {
+ // ----- TBC
+ // Need to be finished
+ if (($p_entry['flag'] & 1) == 1) {
+ PclZip::privErrorLog(PCLZIP_ERR_UNSUPPORTED_ENCRYPTION, 'File \'' . $p_entry['filename'] . '\' is encrypted. Encrypted files are not supported.');
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Look for using temporary file to unzip
+ if ((!isset($p_options[PCLZIP_OPT_TEMP_FILE_OFF])) && (isset($p_options[PCLZIP_OPT_TEMP_FILE_ON]) || (isset($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD]) && ($p_options[PCLZIP_OPT_TEMP_FILE_THRESHOLD] <= $p_entry['size'])))) {
+ $v_result = $this->privExtractFileUsingTempFile($p_entry, $p_options);
+ if ($v_result < PCLZIP_ERR_NO_ERROR) {
+ return $v_result;
+ }
+
+ // ----- Look for extract in memory
+ } else {
+
+ // ----- Read the compressed file in a buffer (one shot)
+ $v_buffer = @fread($this->zip_fd, $p_entry['compressed_size']);
+
+ // ----- Decompress the file
+ $v_file_content = @gzinflate($v_buffer);
+ unset($v_buffer);
+ if ($v_file_content === false) {
+
+ // ----- Change the file status
+ // TBC
+ $p_entry['status'] = "error";
+
+ return $v_result;
+ }
+
+ // ----- Opening destination file
+ if (($v_dest_file = @fopen($p_entry['filename'], 'wb')) == 0) {
+
+ // ----- Change the file status
+ $p_entry['status'] = "write_error";
+
+ return $v_result;
+ }
+
+ // ----- Write the uncompressed data
+ @fwrite($v_dest_file, $v_file_content, $p_entry['size']);
+ unset($v_file_content);
+
+ // ----- Closing the destination file
+ @fclose($v_dest_file);
+
+ }
+
+ // ----- Change the file mtime
+ @touch($p_entry['filename'], $p_entry['mtime']);
+ }
+
+ // ----- Look for chmod option
+ if (isset($p_options[PCLZIP_OPT_SET_CHMOD])) {
+
+ // ----- Change the mode of the file
+ @chmod($p_entry['filename'], $p_options[PCLZIP_OPT_SET_CHMOD]);
+ }
+
+ }
+ }
+
+ // ----- Change abort status
+ if ($p_entry['status'] == "aborted") {
+ $p_entry['status'] = "skipped";
+
+ // ----- Look for post-extract callback
+ } elseif (isset($p_options[PCLZIP_CB_POST_EXTRACT])) {
+
+ // ----- Generate a local information
+ $v_local_header = array();
+ $this->privConvertHeader2FileInfo($p_entry, $v_local_header);
+
+ // ----- Call the callback
+ // Here I do not use call_user_func() because I need to send a reference to the
+ // header.
+ // eval('$v_result = '.$p_options[PCLZIP_CB_POST_EXTRACT].'(PCLZIP_CB_POST_EXTRACT, $v_local_header);');
+ $v_result = $p_options[PCLZIP_CB_POST_EXTRACT](PCLZIP_CB_POST_EXTRACT, $v_local_header);
+
+ // ----- Look for abort result
+ if ($v_result == 2) {
+ $v_result = PCLZIP_ERR_USER_ABORTED;
+ }
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privExtractFileUsingTempFile()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privExtractFileUsingTempFile(&$p_entry, &$p_options)
+ {
+ $v_result = 1;
+
+ // ----- Creates a temporary file
+ $v_gzip_temp_name = PCLZIP_TEMPORARY_DIR . uniqid('pclzip-') . '.gz';
+ if (($v_dest_file = @fopen($v_gzip_temp_name, "wb")) == 0) {
+ fclose($v_file);
+ PclZip::privErrorLog(PCLZIP_ERR_WRITE_OPEN_FAIL, 'Unable to open temporary file \'' . $v_gzip_temp_name . '\' in binary write mode');
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Write gz file format header
+ $v_binary_data = pack('va1a1Va1a1', 0x8b1f, chr($p_entry['compression']), chr(0x00), time(), chr(0x00), chr(3));
+ @fwrite($v_dest_file, $v_binary_data, 10);
+
+ // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks
+ $v_size = $p_entry['compressed_size'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @fread($this->zip_fd, $v_read_size);
+ //$v_binary_data = pack('a'.$v_read_size, $v_buffer);
+ @fwrite($v_dest_file, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Write gz file format footer
+ $v_binary_data = pack('VV', $p_entry['crc'], $p_entry['size']);
+ @fwrite($v_dest_file, $v_binary_data, 8);
+
+ // ----- Close the temporary file
+ @fclose($v_dest_file);
+
+ // ----- Opening destination file
+ if (($v_dest_file = @fopen($p_entry['filename'], 'wb')) == 0) {
+ $p_entry['status'] = "write_error";
+
+ return $v_result;
+ }
+
+ // ----- Open the temporary gz file
+ if (($v_src_file = @gzopen($v_gzip_temp_name, 'rb')) == 0) {
+ @fclose($v_dest_file);
+ $p_entry['status'] = "read_error";
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \'' . $v_gzip_temp_name . '\' in binary read mode');
+
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the file by PCLZIP_READ_BLOCK_SIZE octets blocks
+ $v_size = $p_entry['size'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @gzread($v_src_file, $v_read_size);
+ //$v_binary_data = pack('a'.$v_read_size, $v_buffer);
+ @fwrite($v_dest_file, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+ @fclose($v_dest_file);
+ @gzclose($v_src_file);
+
+ // ----- Delete the temporary file
+ @unlink($v_gzip_temp_name);
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privExtractFileInOutput()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privExtractFileInOutput(&$p_entry, &$p_options)
+ {
+ $v_result = 1;
+
+ // ----- Read the file header
+ if (($v_result = $this->privReadFileHeader($v_header)) != 1) {
+ return $v_result;
+ }
+
+ // ----- Check that the file header is coherent with $p_entry info
+ if ($this->privCheckFileHeaders($v_header, $p_entry) != 1) {
+ // TBC
+ }
+
+ // ----- Look for pre-extract callback
+ if (isset($p_options[PCLZIP_CB_PRE_EXTRACT])) {
+
+ // ----- Generate a local information
+ $v_local_header = array();
+ $this->privConvertHeader2FileInfo($p_entry, $v_local_header);
+
+ // ----- Call the callback
+ // Here I do not use call_user_func() because I need to send a reference to the
+ // header.
+ // eval('$v_result = '.$p_options[PCLZIP_CB_PRE_EXTRACT].'(PCLZIP_CB_PRE_EXTRACT, $v_local_header);');
+ $v_result = $p_options[PCLZIP_CB_PRE_EXTRACT](PCLZIP_CB_PRE_EXTRACT, $v_local_header);
+ if ($v_result == 0) {
+ // ----- Change the file status
+ $p_entry['status'] = "skipped";
+ $v_result = 1;
+ }
+
+ // ----- Look for abort result
+ if ($v_result == 2) {
+ // ----- This status is internal and will be changed in 'skipped'
+ $p_entry['status'] = "aborted";
+ $v_result = PCLZIP_ERR_USER_ABORTED;
+ }
+
+ // ----- Update the informations
+ // Only some fields can be modified
+ $p_entry['filename'] = $v_local_header['filename'];
+ }
+
+ // ----- Trace
+
+ // ----- Look if extraction should be done
+ if ($p_entry['status'] == 'ok') {
+
+ // ----- Do the extraction (if not a folder)
+ if (!(($p_entry['external'] & 0x00000010) == 0x00000010)) {
+ // ----- Look for not compressed file
+ if ($p_entry['compressed_size'] == $p_entry['size']) {
+
+ // ----- Read the file in a buffer (one shot)
+ $v_buffer = @fread($this->zip_fd, $p_entry['compressed_size']);
+
+ // ----- Send the file to the output
+ echo $v_buffer;
+ unset($v_buffer);
+ } else {
+
+ // ----- Read the compressed file in a buffer (one shot)
+ $v_buffer = @fread($this->zip_fd, $p_entry['compressed_size']);
+
+ // ----- Decompress the file
+ $v_file_content = gzinflate($v_buffer);
+ unset($v_buffer);
+
+ // ----- Send the file to the output
+ echo $v_file_content;
+ unset($v_file_content);
+ }
+ }
+ }
+
+ // ----- Change abort status
+ if ($p_entry['status'] == "aborted") {
+ $p_entry['status'] = "skipped";
+
+ // ----- Look for post-extract callback
+ } elseif (isset($p_options[PCLZIP_CB_POST_EXTRACT])) {
+
+ // ----- Generate a local information
+ $v_local_header = array();
+ $this->privConvertHeader2FileInfo($p_entry, $v_local_header);
+
+ // ----- Call the callback
+ // Here I do not use call_user_func() because I need to send a reference to the
+ // header.
+ // eval('$v_result = '.$p_options[PCLZIP_CB_POST_EXTRACT].'(PCLZIP_CB_POST_EXTRACT, $v_local_header);');
+ $v_result = $p_options[PCLZIP_CB_POST_EXTRACT](PCLZIP_CB_POST_EXTRACT, $v_local_header);
+
+ // ----- Look for abort result
+ if ($v_result == 2) {
+ $v_result = PCLZIP_ERR_USER_ABORTED;
+ }
+ }
+
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privExtractFileAsString()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privExtractFileAsString(&$p_entry, &$p_string, &$p_options)
+ {
+ $v_result = 1;
+
+ // ----- Read the file header
+ $v_header = array();
+ if (($v_result = $this->privReadFileHeader($v_header)) != 1) {
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Check that the file header is coherent with $p_entry info
+ if ($this->privCheckFileHeaders($v_header, $p_entry) != 1) {
+ // TBC
+ }
+
+ // ----- Look for pre-extract callback
+ if (isset($p_options[PCLZIP_CB_PRE_EXTRACT])) {
+
+ // ----- Generate a local information
+ $v_local_header = array();
+ $this->privConvertHeader2FileInfo($p_entry, $v_local_header);
+
+ // ----- Call the callback
+ // Here I do not use call_user_func() because I need to send a reference to the
+ // header.
+ // eval('$v_result = '.$p_options[PCLZIP_CB_PRE_EXTRACT].'(PCLZIP_CB_PRE_EXTRACT, $v_local_header);');
+ $v_result = $p_options[PCLZIP_CB_PRE_EXTRACT](PCLZIP_CB_PRE_EXTRACT, $v_local_header);
+ if ($v_result == 0) {
+ // ----- Change the file status
+ $p_entry['status'] = "skipped";
+ $v_result = 1;
+ }
+
+ // ----- Look for abort result
+ if ($v_result == 2) {
+ // ----- This status is internal and will be changed in 'skipped'
+ $p_entry['status'] = "aborted";
+ $v_result = PCLZIP_ERR_USER_ABORTED;
+ }
+
+ // ----- Update the informations
+ // Only some fields can be modified
+ $p_entry['filename'] = $v_local_header['filename'];
+ }
+
+ // ----- Look if extraction should be done
+ if ($p_entry['status'] == 'ok') {
+
+ // ----- Do the extraction (if not a folder)
+ if (!(($p_entry['external'] & 0x00000010) == 0x00000010)) {
+ // ----- Look for not compressed file
+ // if ($p_entry['compressed_size'] == $p_entry['size'])
+ if ($p_entry['compression'] == 0) {
+
+ // ----- Reading the file
+ $p_string = @fread($this->zip_fd, $p_entry['compressed_size']);
+ } else {
+
+ // ----- Reading the file
+ $v_data = @fread($this->zip_fd, $p_entry['compressed_size']);
+
+ // ----- Decompress the file
+ if (($p_string = @gzinflate($v_data)) === false) {
+ // TBC
+ }
+ }
+
+ // ----- Trace
+ } else {
+ // TBC : error : can not extract a folder in a string
+ }
+
+ }
+
+ // ----- Change abort status
+ if ($p_entry['status'] == "aborted") {
+ $p_entry['status'] = "skipped";
+
+ // ----- Look for post-extract callback
+ } elseif (isset($p_options[PCLZIP_CB_POST_EXTRACT])) {
+
+ // ----- Generate a local information
+ $v_local_header = array();
+ $this->privConvertHeader2FileInfo($p_entry, $v_local_header);
+
+ // ----- Swap the content to header
+ $v_local_header['content'] = $p_string;
+ $p_string = '';
+
+ // ----- Call the callback
+ // Here I do not use call_user_func() because I need to send a reference to the
+ // header.
+ // eval('$v_result = '.$p_options[PCLZIP_CB_POST_EXTRACT].'(PCLZIP_CB_POST_EXTRACT, $v_local_header);');
+ $v_result = $p_options[PCLZIP_CB_POST_EXTRACT](PCLZIP_CB_POST_EXTRACT, $v_local_header);
+
+ // ----- Swap back the content to header
+ $p_string = $v_local_header['content'];
+ unset($v_local_header['content']);
+
+ // ----- Look for abort result
+ if ($v_result == 2) {
+ $v_result = PCLZIP_ERR_USER_ABORTED;
+ }
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privReadFileHeader()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privReadFileHeader(&$p_header)
+ {
+ $v_result = 1;
+
+ // ----- Read the 4 bytes signature
+ $v_binary_data = @fread($this->zip_fd, 4);
+ $v_data = unpack('Vid', $v_binary_data);
+
+ // ----- Check signature
+ if ($v_data['id'] != 0x04034b50) {
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Invalid archive structure');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the first 42 bytes of the header
+ $v_binary_data = fread($this->zip_fd, 26);
+
+ // ----- Look for invalid block size
+ if (strlen($v_binary_data) != 26) {
+ $p_header['filename'] = "";
+ $p_header['status'] = "invalid_header";
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, "Invalid block size : " . strlen($v_binary_data));
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Extract the values
+ $v_data = unpack('vversion/vflag/vcompression/vmtime/vmdate/Vcrc/Vcompressed_size/Vsize/vfilename_len/vextra_len', $v_binary_data);
+
+ // ----- Get filename
+ $p_header['filename'] = fread($this->zip_fd, $v_data['filename_len']);
+
+ // ----- Get extra_fields
+ if ($v_data['extra_len'] != 0) {
+ $p_header['extra'] = fread($this->zip_fd, $v_data['extra_len']);
+ } else {
+ $p_header['extra'] = '';
+ }
+
+ // ----- Extract properties
+ $p_header['version_extracted'] = $v_data['version'];
+ $p_header['compression'] = $v_data['compression'];
+ $p_header['size'] = $v_data['size'];
+ $p_header['compressed_size'] = $v_data['compressed_size'];
+ $p_header['crc'] = $v_data['crc'];
+ $p_header['flag'] = $v_data['flag'];
+ $p_header['filename_len'] = $v_data['filename_len'];
+
+ // ----- Recuperate date in UNIX format
+ $p_header['mdate'] = $v_data['mdate'];
+ $p_header['mtime'] = $v_data['mtime'];
+ if ($p_header['mdate'] && $p_header['mtime']) {
+ // ----- Extract time
+ $v_hour = ($p_header['mtime'] & 0xF800) >> 11;
+ $v_minute = ($p_header['mtime'] & 0x07E0) >> 5;
+ $v_seconde = ($p_header['mtime'] & 0x001F) * 2;
+
+ // ----- Extract date
+ $v_year = (($p_header['mdate'] & 0xFE00) >> 9) + 1980;
+ $v_month = ($p_header['mdate'] & 0x01E0) >> 5;
+ $v_day = $p_header['mdate'] & 0x001F;
+
+ // ----- Get UNIX date format
+ $p_header['mtime'] = @mktime($v_hour, $v_minute, $v_seconde, $v_month, $v_day, $v_year);
+
+ } else {
+ $p_header['mtime'] = time();
+ }
+
+ // TBC
+ //for (reset($v_data); $key = key($v_data); next($v_data)) {
+ //}
+
+ // ----- Set the stored filename
+ $p_header['stored_filename'] = $p_header['filename'];
+
+ // ----- Set the status field
+ $p_header['status'] = "ok";
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privReadCentralFileHeader()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privReadCentralFileHeader(&$p_header)
+ {
+ $v_result = 1;
+
+ // ----- Read the 4 bytes signature
+ $v_binary_data = @fread($this->zip_fd, 4);
+ $v_data = unpack('Vid', $v_binary_data);
+
+ // ----- Check signature
+ if ($v_data['id'] != 0x02014b50) {
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Invalid archive structure');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the first 42 bytes of the header
+ $v_binary_data = fread($this->zip_fd, 42);
+
+ // ----- Look for invalid block size
+ if (strlen($v_binary_data) != 42) {
+ $p_header['filename'] = "";
+ $p_header['status'] = "invalid_header";
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, "Invalid block size : " . strlen($v_binary_data));
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Extract the values
+ $p_header = unpack('vversion/vversion_extracted/vflag/vcompression/vmtime/vmdate/Vcrc/Vcompressed_size/Vsize/vfilename_len/vextra_len/vcomment_len/vdisk/vinternal/Vexternal/Voffset', $v_binary_data);
+
+ // ----- Get filename
+ if ($p_header['filename_len'] != 0) {
+ $p_header['filename'] = fread($this->zip_fd, $p_header['filename_len']);
+ } else {
+ $p_header['filename'] = '';
+ }
+
+ // ----- Get extra
+ if ($p_header['extra_len'] != 0) {
+ $p_header['extra'] = fread($this->zip_fd, $p_header['extra_len']);
+ } else {
+ $p_header['extra'] = '';
+ }
+
+ // ----- Get comment
+ if ($p_header['comment_len'] != 0) {
+ $p_header['comment'] = fread($this->zip_fd, $p_header['comment_len']);
+ } else {
+ $p_header['comment'] = '';
+ }
+
+ // ----- Extract properties
+
+ // ----- Recuperate date in UNIX format
+ //if ($p_header['mdate'] && $p_header['mtime'])
+ // TBC : bug : this was ignoring time with 0/0/0
+ if (1) {
+ // ----- Extract time
+ $v_hour = ($p_header['mtime'] & 0xF800) >> 11;
+ $v_minute = ($p_header['mtime'] & 0x07E0) >> 5;
+ $v_seconde = ($p_header['mtime'] & 0x001F) * 2;
+
+ // ----- Extract date
+ $v_year = (($p_header['mdate'] & 0xFE00) >> 9) + 1980;
+ $v_month = ($p_header['mdate'] & 0x01E0) >> 5;
+ $v_day = $p_header['mdate'] & 0x001F;
+
+ // ----- Get UNIX date format
+ $p_header['mtime'] = @mktime($v_hour, $v_minute, $v_seconde, $v_month, $v_day, $v_year);
+
+ } else {
+ $p_header['mtime'] = time();
+ }
+
+ // ----- Set the stored filename
+ $p_header['stored_filename'] = $p_header['filename'];
+
+ // ----- Set default status to ok
+ $p_header['status'] = 'ok';
+
+ // ----- Look if it is a directory
+ if (substr($p_header['filename'], -1) == '/') {
+ //$p_header['external'] = 0x41FF0010;
+ $p_header['external'] = 0x00000010;
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privCheckFileHeaders()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // 1 on success,
+ // 0 on error;
+ // --------------------------------------------------------------------------------
+ public function privCheckFileHeaders(&$p_local_header, &$p_central_header)
+ {
+ $v_result = 1;
+
+ // ----- Check the static values
+ // TBC
+ if ($p_local_header['filename'] != $p_central_header['filename']) {
+ }
+ if ($p_local_header['version_extracted'] != $p_central_header['version_extracted']) {
+ }
+ if ($p_local_header['flag'] != $p_central_header['flag']) {
+ }
+ if ($p_local_header['compression'] != $p_central_header['compression']) {
+ }
+ if ($p_local_header['mtime'] != $p_central_header['mtime']) {
+ }
+ if ($p_local_header['filename_len'] != $p_central_header['filename_len']) {
+ }
+
+ // ----- Look for flag bit 3
+ if (($p_local_header['flag'] & 8) == 8) {
+ $p_local_header['size'] = $p_central_header['size'];
+ $p_local_header['compressed_size'] = $p_central_header['compressed_size'];
+ $p_local_header['crc'] = $p_central_header['crc'];
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privReadEndCentralDir()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privReadEndCentralDir(&$p_central_dir)
+ {
+ $v_result = 1;
+
+ // ----- Go to the end of the zip file
+ $v_size = filesize($this->zipname);
+ @fseek($this->zip_fd, $v_size);
+ if (@ftell($this->zip_fd) != $v_size) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Unable to go to the end of the archive \'' . $this->zipname . '\'');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- First try : look if this is an archive with no commentaries (most of the time)
+ // in this case the end of central dir is at 22 bytes of the file end
+ $v_found = 0;
+ if ($v_size > 26) {
+ @fseek($this->zip_fd, $v_size - 22);
+ if (($v_pos = @ftell($this->zip_fd)) != ($v_size - 22)) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Unable to seek back to the middle of the archive \'' . $this->zipname . '\'');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Read for bytes
+ $v_binary_data = @fread($this->zip_fd, 4);
+ $v_data = @unpack('Vid', $v_binary_data);
+
+ // ----- Check signature
+ if ($v_data['id'] == 0x06054b50) {
+ $v_found = 1;
+ }
+
+ $v_pos = ftell($this->zip_fd);
+ }
+
+ // ----- Go back to the maximum possible size of the Central Dir End Record
+ if (!$v_found) {
+ $v_maximum_size = 65557; // 0xFFFF + 22;
+ if ($v_maximum_size > $v_size) {
+ $v_maximum_size = $v_size;
+ }
+ @fseek($this->zip_fd, $v_size - $v_maximum_size);
+ if (@ftell($this->zip_fd) != ($v_size - $v_maximum_size)) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'Unable to seek back to the middle of the archive \'' . $this->zipname . '\'');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Read byte per byte in order to find the signature
+ $v_pos = ftell($this->zip_fd);
+ $v_bytes = 0x00000000;
+ while ($v_pos < $v_size) {
+ // ----- Read a byte
+ $v_byte = @fread($this->zip_fd, 1);
+
+ // ----- Add the byte
+ //$v_bytes = ($v_bytes << 8) | Ord($v_byte);
+ // Note we mask the old value down such that once shifted we can never end up with more than a 32bit number
+ // Otherwise on systems where we have 64bit integers the check below for the magic number will fail.
+ $v_bytes = (($v_bytes & 0xFFFFFF) << 8) | ord($v_byte);
+
+ // ----- Compare the bytes
+ if ($v_bytes == 0x504b0506) {
+ $v_pos++;
+ break;
+ }
+
+ $v_pos++;
+ }
+
+ // ----- Look if not found end of central dir
+ if ($v_pos == $v_size) {
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, "Unable to find End of Central Dir Record signature");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+ }
+
+ // ----- Read the first 18 bytes of the header
+ $v_binary_data = fread($this->zip_fd, 18);
+
+ // ----- Look for invalid block size
+ if (strlen($v_binary_data) != 18) {
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, "Invalid End of Central Dir Record size : " . strlen($v_binary_data));
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Extract the values
+ $v_data = unpack('vdisk/vdisk_start/vdisk_entries/ventries/Vsize/Voffset/vcomment_size', $v_binary_data);
+
+ // ----- Check the global size
+ if (($v_pos + $v_data['comment_size'] + 18) != $v_size) {
+
+ // ----- Removed in release 2.2 see readme file
+ // The check of the file size is a little too strict.
+ // Some bugs where found when a zip is encrypted/decrypted with 'crypt'.
+ // While decrypted, zip has training 0 bytes
+ if (0) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_BAD_FORMAT, 'The central dir is not at the end of the archive.' . ' Some trailing bytes exists after the archive.');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+ }
+
+ // ----- Get comment
+ if ($v_data['comment_size'] != 0) {
+ $p_central_dir['comment'] = fread($this->zip_fd, $v_data['comment_size']);
+ } else {
+ $p_central_dir['comment'] = '';
+ }
+
+ $p_central_dir['entries'] = $v_data['entries'];
+ $p_central_dir['disk_entries'] = $v_data['disk_entries'];
+ $p_central_dir['offset'] = $v_data['offset'];
+ $p_central_dir['size'] = $v_data['size'];
+ $p_central_dir['disk'] = $v_data['disk'];
+ $p_central_dir['disk_start'] = $v_data['disk_start'];
+
+ // TBC
+ //for (reset($p_central_dir); $key = key($p_central_dir); next($p_central_dir)) {
+ //}
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privDeleteByRule()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privDeleteByRule(&$p_result_list, &$p_options)
+ {
+ $v_result = 1;
+ $v_list_detail = array();
+
+ // ----- Open the zip file
+ if (($v_result = $this->privOpenFd('rb')) != 1) {
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Read the central directory informations
+ $v_central_dir = array();
+ if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) {
+ $this->privCloseFd();
+
+ return $v_result;
+ }
+
+ // ----- Go to beginning of File
+ @rewind($this->zip_fd);
+
+ // ----- Scan all the files
+ // ----- Start at beginning of Central Dir
+ $v_pos_entry = $v_central_dir['offset'];
+ @rewind($this->zip_fd);
+ if (@fseek($this->zip_fd, $v_pos_entry)) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Read each entry
+ $v_header_list = array();
+ $j_start = 0;
+ for ($i = 0, $v_nb_extracted = 0; $i < $v_central_dir['entries']; $i++) {
+
+ // ----- Read the file header
+ $v_header_list[$v_nb_extracted] = array();
+ if (($v_result = $this->privReadCentralFileHeader($v_header_list[$v_nb_extracted])) != 1) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+
+ return $v_result;
+ }
+
+ // ----- Store the index
+ $v_header_list[$v_nb_extracted]['index'] = $i;
+
+ // ----- Look for the specific extract rules
+ $v_found = false;
+
+ // ----- Look for extract by name rule
+ if ((isset($p_options[PCLZIP_OPT_BY_NAME])) && ($p_options[PCLZIP_OPT_BY_NAME] != 0)) {
+
+ // ----- Look if the filename is in the list
+ for ($j = 0; ($j < sizeof($p_options[PCLZIP_OPT_BY_NAME])) && (!$v_found); $j++) {
+
+ // ----- Look for a directory
+ if (substr($p_options[PCLZIP_OPT_BY_NAME][$j], -1) == "/") {
+
+ // ----- Look if the directory is in the filename path
+ if ((strlen($v_header_list[$v_nb_extracted]['stored_filename']) > strlen($p_options[PCLZIP_OPT_BY_NAME][$j])) && (substr($v_header_list[$v_nb_extracted]['stored_filename'], 0, strlen($p_options[PCLZIP_OPT_BY_NAME][$j])) == $p_options[PCLZIP_OPT_BY_NAME][$j])) {
+ $v_found = true;
+ } elseif ((($v_header_list[$v_nb_extracted]['external'] & 0x00000010) == 0x00000010) /* Indicates a folder */ && ($v_header_list[$v_nb_extracted]['stored_filename'] . '/' == $p_options[PCLZIP_OPT_BY_NAME][$j])) {
+ $v_found = true;
+ }
+
+ // ----- Look for a filename
+ } elseif ($v_header_list[$v_nb_extracted]['stored_filename'] == $p_options[PCLZIP_OPT_BY_NAME][$j]) {
+ $v_found = true;
+ }
+ }
+
+ // ----- Look for extract by preg rule
+ } elseif ((isset($p_options[PCLZIP_OPT_BY_PREG])) && ($p_options[PCLZIP_OPT_BY_PREG] != "")) {
+
+ if (preg_match($p_options[PCLZIP_OPT_BY_PREG], $v_header_list[$v_nb_extracted]['stored_filename'])) {
+ $v_found = true;
+ }
+
+ // ----- Look for extract by index rule
+ } elseif ((isset($p_options[PCLZIP_OPT_BY_INDEX])) && ($p_options[PCLZIP_OPT_BY_INDEX] != 0)) {
+
+ // ----- Look if the index is in the list
+ for ($j = $j_start; ($j < sizeof($p_options[PCLZIP_OPT_BY_INDEX])) && (!$v_found); $j++) {
+
+ if (($i >= $p_options[PCLZIP_OPT_BY_INDEX][$j]['start']) && ($i <= $p_options[PCLZIP_OPT_BY_INDEX][$j]['end'])) {
+ $v_found = true;
+ }
+ if ($i >= $p_options[PCLZIP_OPT_BY_INDEX][$j]['end']) {
+ $j_start = $j + 1;
+ }
+
+ if ($p_options[PCLZIP_OPT_BY_INDEX][$j]['start'] > $i) {
+ break;
+ }
+ }
+ } else {
+ $v_found = true;
+ }
+
+ // ----- Look for deletion
+ if ($v_found) {
+ unset($v_header_list[$v_nb_extracted]);
+ } else {
+ $v_nb_extracted++;
+ }
+ }
+
+ // ----- Look if something need to be deleted
+ if ($v_nb_extracted > 0) {
+
+ // ----- Creates a temporay file
+ $v_zip_temp_name = PCLZIP_TEMPORARY_DIR . uniqid('pclzip-') . '.tmp';
+
+ // ----- Creates a temporary zip archive
+ $v_temp_zip = new PclZip($v_zip_temp_name);
+
+ // ----- Open the temporary zip file in write mode
+ if (($v_result = $v_temp_zip->privOpenFd('wb')) != 1) {
+ $this->privCloseFd();
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Look which file need to be kept
+ for ($i = 0; $i < sizeof($v_header_list); $i++) {
+
+ // ----- Calculate the position of the header
+ @rewind($this->zip_fd);
+ if (@fseek($this->zip_fd, $v_header_list[$i]['offset'])) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $v_temp_zip->privCloseFd();
+ @unlink($v_zip_temp_name);
+
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_INVALID_ARCHIVE_ZIP, 'Invalid archive size');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Read the file header
+ $v_local_header = array();
+ if (($v_result = $this->privReadFileHeader($v_local_header)) != 1) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $v_temp_zip->privCloseFd();
+ @unlink($v_zip_temp_name);
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Check that local file header is same as central file header
+ if ($this->privCheckFileHeaders($v_local_header, $v_header_list[$i]) != 1) {
+ // TBC
+ }
+ unset($v_local_header);
+
+ // ----- Write the file header
+ if (($v_result = $v_temp_zip->privWriteFileHeader($v_header_list[$i])) != 1) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $v_temp_zip->privCloseFd();
+ @unlink($v_zip_temp_name);
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Read/write the data block
+ if (($v_result = PclZipUtilCopyBlock($this->zip_fd, $v_temp_zip->zip_fd, $v_header_list[$i]['compressed_size'])) != 1) {
+ // ----- Close the zip file
+ $this->privCloseFd();
+ $v_temp_zip->privCloseFd();
+ @unlink($v_zip_temp_name);
+
+ // ----- Return
+ return $v_result;
+ }
+ }
+
+ // ----- Store the offset of the central dir
+ $v_offset = @ftell($v_temp_zip->zip_fd);
+
+ // ----- Re-Create the Central Dir files header
+ for ($i = 0; $i < sizeof($v_header_list); $i++) {
+ // ----- Create the file header
+ if (($v_result = $v_temp_zip->privWriteCentralFileHeader($v_header_list[$i])) != 1) {
+ $v_temp_zip->privCloseFd();
+ $this->privCloseFd();
+ @unlink($v_zip_temp_name);
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Transform the header to a 'usable' info
+ $v_temp_zip->privConvertHeader2FileInfo($v_header_list[$i], $p_result_list[$i]);
+ }
+
+ // ----- Zip file comment
+ $v_comment = '';
+ if (isset($p_options[PCLZIP_OPT_COMMENT])) {
+ $v_comment = $p_options[PCLZIP_OPT_COMMENT];
+ }
+
+ // ----- Calculate the size of the central header
+ $v_size = @ftell($v_temp_zip->zip_fd) - $v_offset;
+
+ // ----- Create the central dir footer
+ if (($v_result = $v_temp_zip->privWriteCentralHeader(sizeof($v_header_list), $v_size, $v_offset, $v_comment)) != 1) {
+ // ----- Reset the file list
+ unset($v_header_list);
+ $v_temp_zip->privCloseFd();
+ $this->privCloseFd();
+ @unlink($v_zip_temp_name);
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Close
+ $v_temp_zip->privCloseFd();
+ $this->privCloseFd();
+
+ // ----- Delete the zip file
+ // TBC : I should test the result ...
+ @unlink($this->zipname);
+
+ // ----- Rename the temporary file
+ // TBC : I should test the result ...
+ //@rename($v_zip_temp_name, $this->zipname);
+ PclZipUtilRename($v_zip_temp_name, $this->zipname);
+
+ // ----- Destroy the temporary archive
+ unset($v_temp_zip);
+
+ // ----- Remove every files : reset the file
+ } elseif ($v_central_dir['entries'] != 0) {
+ $this->privCloseFd();
+
+ if (($v_result = $this->privOpenFd('wb')) != 1) {
+ return $v_result;
+ }
+
+ if (($v_result = $this->privWriteCentralHeader(0, 0, 0, '')) != 1) {
+ return $v_result;
+ }
+
+ $this->privCloseFd();
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privDirCheck()
+ // Description :
+ // Check if a directory exists, if not it creates it and all the parents directory
+ // which may be useful.
+ // Parameters :
+ // $p_dir : Directory path to check.
+ // Return Values :
+ // 1 : OK
+ // -1 : Unable to create directory
+ // --------------------------------------------------------------------------------
+ public function privDirCheck($p_dir, $p_is_dir = false)
+ {
+ $v_result = 1;
+
+ // ----- Remove the final '/'
+ if (($p_is_dir) && (substr($p_dir, -1) == '/')) {
+ $p_dir = substr($p_dir, 0, strlen($p_dir) - 1);
+ }
+
+ // ----- Check the directory availability
+ if ((is_dir($p_dir)) || ($p_dir == "")) {
+ return 1;
+ }
+
+ // ----- Extract parent directory
+ $p_parent_dir = dirname($p_dir);
+
+ // ----- Just a check
+ if ($p_parent_dir != $p_dir) {
+ // ----- Look for parent directory
+ if ($p_parent_dir != "") {
+ if (($v_result = $this->privDirCheck($p_parent_dir)) != 1) {
+ return $v_result;
+ }
+ }
+ }
+
+ // ----- Create the directory
+ if (!@mkdir($p_dir, 0777)) {
+ // ----- Error log
+ PclZip::privErrorLog(PCLZIP_ERR_DIR_CREATE_FAIL, "Unable to create directory '$p_dir'");
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privMerge()
+ // Description :
+ // If $p_archive_to_add does not exist, the function exit with a success result.
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privMerge(&$p_archive_to_add)
+ {
+ $v_result = 1;
+
+ // ----- Look if the archive_to_add exists
+ if (!is_file($p_archive_to_add->zipname)) {
+
+ // ----- Nothing to merge, so merge is a success
+ $v_result = 1;
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Look if the archive exists
+ if (!is_file($this->zipname)) {
+
+ // ----- Do a duplicate
+ $v_result = $this->privDuplicate($p_archive_to_add->zipname);
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Open the zip file
+ if (($v_result = $this->privOpenFd('rb')) != 1) {
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Read the central directory informations
+ $v_central_dir = array();
+ if (($v_result = $this->privReadEndCentralDir($v_central_dir)) != 1) {
+ $this->privCloseFd();
+
+ return $v_result;
+ }
+
+ // ----- Go to beginning of File
+ @rewind($this->zip_fd);
+
+ // ----- Open the archive_to_add file
+ if (($v_result = $p_archive_to_add->privOpenFd('rb')) != 1) {
+ $this->privCloseFd();
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Read the central directory informations
+ $v_central_dir_to_add = array();
+ if (($v_result = $p_archive_to_add->privReadEndCentralDir($v_central_dir_to_add)) != 1) {
+ $this->privCloseFd();
+ $p_archive_to_add->privCloseFd();
+
+ return $v_result;
+ }
+
+ // ----- Go to beginning of File
+ @rewind($p_archive_to_add->zip_fd);
+
+ // ----- Creates a temporay file
+ $v_zip_temp_name = PCLZIP_TEMPORARY_DIR . uniqid('pclzip-') . '.tmp';
+
+ // ----- Open the temporary file in write mode
+ if (($v_zip_temp_fd = @fopen($v_zip_temp_name, 'wb')) == 0) {
+ $this->privCloseFd();
+ $p_archive_to_add->privCloseFd();
+
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open temporary file \'' . $v_zip_temp_name . '\' in binary write mode');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Copy the files from the archive to the temporary file
+ // TBC : Here I should better append the file and go back to erase the central dir
+ $v_size = $v_central_dir['offset'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = fread($this->zip_fd, $v_read_size);
+ @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Copy the files from the archive_to_add into the temporary file
+ $v_size = $v_central_dir_to_add['offset'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = fread($p_archive_to_add->zip_fd, $v_read_size);
+ @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Store the offset of the central dir
+ $v_offset = @ftell($v_zip_temp_fd);
+
+ // ----- Copy the block of file headers from the old archive
+ $v_size = $v_central_dir['size'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @fread($this->zip_fd, $v_read_size);
+ @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Copy the block of file headers from the archive_to_add
+ $v_size = $v_central_dir_to_add['size'];
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @fread($p_archive_to_add->zip_fd, $v_read_size);
+ @fwrite($v_zip_temp_fd, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Merge the file comments
+ $v_comment = $v_central_dir['comment'] . ' ' . $v_central_dir_to_add['comment'];
+
+ // ----- Calculate the size of the (new) central header
+ $v_size = @ftell($v_zip_temp_fd) - $v_offset;
+
+ // ----- Swap the file descriptor
+ // Here is a trick : I swap the temporary fd with the zip fd, in order to use
+ // the following methods on the temporary fil and not the real archive fd
+ $v_swap = $this->zip_fd;
+ $this->zip_fd = $v_zip_temp_fd;
+ $v_zip_temp_fd = $v_swap;
+
+ // ----- Create the central dir footer
+ if (($v_result = $this->privWriteCentralHeader($v_central_dir['entries'] + $v_central_dir_to_add['entries'], $v_size, $v_offset, $v_comment)) != 1) {
+ $this->privCloseFd();
+ $p_archive_to_add->privCloseFd();
+ @fclose($v_zip_temp_fd);
+ $this->zip_fd = null;
+
+ // ----- Reset the file list
+ unset($v_header_list);
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Swap back the file descriptor
+ $v_swap = $this->zip_fd;
+ $this->zip_fd = $v_zip_temp_fd;
+ $v_zip_temp_fd = $v_swap;
+
+ // ----- Close
+ $this->privCloseFd();
+ $p_archive_to_add->privCloseFd();
+
+ // ----- Close the temporary file
+ @fclose($v_zip_temp_fd);
+
+ // ----- Delete the zip file
+ // TBC : I should test the result ...
+ @unlink($this->zipname);
+
+ // ----- Rename the temporary file
+ // TBC : I should test the result ...
+ //@rename($v_zip_temp_name, $this->zipname);
+ PclZipUtilRename($v_zip_temp_name, $this->zipname);
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privDuplicate()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privDuplicate($p_archive_filename)
+ {
+ $v_result = 1;
+
+ // ----- Look if the $p_archive_filename exists
+ if (!is_file($p_archive_filename)) {
+
+ // ----- Nothing to duplicate, so duplicate is a success.
+ $v_result = 1;
+
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Open the zip file
+ if (($v_result = $this->privOpenFd('wb')) != 1) {
+ // ----- Return
+ return $v_result;
+ }
+
+ // ----- Open the temporary file in write mode
+ if (($v_zip_temp_fd = @fopen($p_archive_filename, 'rb')) == 0) {
+ $this->privCloseFd();
+
+ PclZip::privErrorLog(PCLZIP_ERR_READ_OPEN_FAIL, 'Unable to open archive file \'' . $p_archive_filename . '\' in binary write mode');
+
+ // ----- Return
+ return PclZip::errorCode();
+ }
+
+ // ----- Copy the files from the archive to the temporary file
+ // TBC : Here I should better append the file and go back to erase the central dir
+ $v_size = filesize($p_archive_filename);
+ while ($v_size != 0) {
+ $v_read_size = ($v_size < PCLZIP_READ_BLOCK_SIZE ? $v_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = fread($v_zip_temp_fd, $v_read_size);
+ @fwrite($this->zip_fd, $v_buffer, $v_read_size);
+ $v_size -= $v_read_size;
+ }
+
+ // ----- Close
+ $this->privCloseFd();
+
+ // ----- Close the temporary file
+ @fclose($v_zip_temp_fd);
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privErrorLog()
+ // Description :
+ // Parameters :
+ // --------------------------------------------------------------------------------
+ public function privErrorLog($p_error_code = 0, $p_error_string = '')
+ {
+ if (PCLZIP_ERROR_EXTERNAL == 1) {
+ PclError($p_error_code, $p_error_string);
+ } else {
+ $this->error_code = $p_error_code;
+ $this->error_string = $p_error_string;
+ }
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privErrorReset()
+ // Description :
+ // Parameters :
+ // --------------------------------------------------------------------------------
+ public function privErrorReset()
+ {
+ if (PCLZIP_ERROR_EXTERNAL == 1) {
+ PclErrorReset();
+ } else {
+ $this->error_code = 0;
+ $this->error_string = '';
+ }
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privDisableMagicQuotes()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privDisableMagicQuotes()
+ {
+ $v_result = 1;
+
+ // ----- Look if function exists
+ if ((!function_exists("get_magic_quotes_runtime")) || (!function_exists("set_magic_quotes_runtime"))) {
+ return $v_result;
+ }
+
+ // ----- Look if already done
+ if ($this->magic_quotes_status != -1) {
+ return $v_result;
+ }
+
+ // ----- Get and memorize the magic_quote value
+ $this->magic_quotes_status = @get_magic_quotes_runtime();
+
+ // ----- Disable magic_quotes
+ if ($this->magic_quotes_status == 1) {
+ @set_magic_quotes_runtime(0);
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+
+ // --------------------------------------------------------------------------------
+ // Function : privSwapBackMagicQuotes()
+ // Description :
+ // Parameters :
+ // Return Values :
+ // --------------------------------------------------------------------------------
+ public function privSwapBackMagicQuotes()
+ {
+ $v_result = 1;
+
+ // ----- Look if function exists
+ if ((!function_exists("get_magic_quotes_runtime")) || (!function_exists("set_magic_quotes_runtime"))) {
+ return $v_result;
+ }
+
+ // ----- Look if something to do
+ if ($this->magic_quotes_status != -1) {
+ return $v_result;
+ }
+
+ // ----- Swap back magic_quotes
+ if ($this->magic_quotes_status == 1) {
+ @set_magic_quotes_runtime($this->magic_quotes_status);
+ }
+
+ // ----- Return
+ return $v_result;
+ }
+ // --------------------------------------------------------------------------------
+}
+
+// End of class
+// --------------------------------------------------------------------------------
+
+// --------------------------------------------------------------------------------
+// Function : PclZipUtilPathReduction()
+// Description :
+// Parameters :
+// Return Values :
+// --------------------------------------------------------------------------------
+function PclZipUtilPathReduction($p_dir)
+{
+ $v_result = "";
+
+ // ----- Look for not empty path
+ if ($p_dir != "") {
+ // ----- Explode path by directory names
+ $v_list = explode("/", $p_dir);
+
+ // ----- Study directories from last to first
+ $v_skip = 0;
+ for ($i = sizeof($v_list) - 1; $i >= 0; $i--) {
+ // ----- Look for current path
+ if ($v_list[$i] == ".") {
+ // ----- Ignore this directory
+ // Should be the first $i=0, but no check is done
+ } elseif ($v_list[$i] == "..") {
+ $v_skip++;
+ } elseif ($v_list[$i] == "") {
+ // ----- First '/' i.e. root slash
+ if ($i == 0) {
+ $v_result = "/" . $v_result;
+ if ($v_skip > 0) {
+ // ----- It is an invalid path, so the path is not modified
+ // TBC
+ $v_result = $p_dir;
+ $v_skip = 0;
+ }
+
+ // ----- Last '/' i.e. indicates a directory
+ } elseif ($i == (sizeof($v_list) - 1)) {
+ $v_result = $v_list[$i];
+
+ // ----- Double '/' inside the path
+ } else {
+ // ----- Ignore only the double '//' in path,
+ // but not the first and last '/'
+ }
+ } else {
+ // ----- Look for item to skip
+ if ($v_skip > 0) {
+ $v_skip--;
+ } else {
+ $v_result = $v_list[$i] . ($i != (sizeof($v_list) - 1) ? "/" . $v_result : "");
+ }
+ }
+ }
+
+ // ----- Look for skip
+ if ($v_skip > 0) {
+ while ($v_skip > 0) {
+ $v_result = '../' . $v_result;
+ $v_skip--;
+ }
+ }
+ }
+
+ // ----- Return
+ return $v_result;
+}
+// --------------------------------------------------------------------------------
+
+// --------------------------------------------------------------------------------
+// Function : PclZipUtilPathInclusion()
+// Description :
+// This function indicates if the path $p_path is under the $p_dir tree. Or,
+// said in an other way, if the file or sub-dir $p_path is inside the dir
+// $p_dir.
+// The function indicates also if the path is exactly the same as the dir.
+// This function supports path with duplicated '/' like '//', but does not
+// support '.' or '..' statements.
+// Parameters :
+// Return Values :
+// 0 if $p_path is not inside directory $p_dir
+// 1 if $p_path is inside directory $p_dir
+// 2 if $p_path is exactly the same as $p_dir
+// --------------------------------------------------------------------------------
+function PclZipUtilPathInclusion($p_dir, $p_path)
+{
+ $v_result = 1;
+
+ // ----- Look for path beginning by ./
+ if (($p_dir == '.') || ((strlen($p_dir) >= 2) && (substr($p_dir, 0, 2) == './'))) {
+ $p_dir = PclZipUtilTranslateWinPath(getcwd(), false) . '/' . substr($p_dir, 1);
+ }
+ if (($p_path == '.') || ((strlen($p_path) >= 2) && (substr($p_path, 0, 2) == './'))) {
+ $p_path = PclZipUtilTranslateWinPath(getcwd(), false) . '/' . substr($p_path, 1);
+ }
+
+ // ----- Explode dir and path by directory separator
+ $v_list_dir = explode("/", $p_dir);
+ $v_list_dir_size = sizeof($v_list_dir);
+ $v_list_path = explode("/", $p_path);
+ $v_list_path_size = sizeof($v_list_path);
+
+ // ----- Study directories paths
+ $i = 0;
+ $j = 0;
+ while (($i < $v_list_dir_size) && ($j < $v_list_path_size) && ($v_result)) {
+
+ // ----- Look for empty dir (path reduction)
+ if ($v_list_dir[$i] == '') {
+ $i++;
+ continue;
+ }
+ if ($v_list_path[$j] == '') {
+ $j++;
+ continue;
+ }
+
+ // ----- Compare the items
+ if (($v_list_dir[$i] != $v_list_path[$j]) && ($v_list_dir[$i] != '') && ($v_list_path[$j] != '')) {
+ $v_result = 0;
+ }
+
+ // ----- Next items
+ $i++;
+ $j++;
+ }
+
+ // ----- Look if everything seems to be the same
+ if ($v_result) {
+ // ----- Skip all the empty items
+ while (($j < $v_list_path_size) && ($v_list_path[$j] == '')) {
+ $j++;
+ }
+ while (($i < $v_list_dir_size) && ($v_list_dir[$i] == '')) {
+ $i++;
+ }
+
+ if (($i >= $v_list_dir_size) && ($j >= $v_list_path_size)) {
+ // ----- There are exactly the same
+ $v_result = 2;
+ } elseif ($i < $v_list_dir_size) {
+ // ----- The path is shorter than the dir
+ $v_result = 0;
+ }
+ }
+
+ // ----- Return
+ return $v_result;
+}
+// --------------------------------------------------------------------------------
+
+// --------------------------------------------------------------------------------
+// Function : PclZipUtilCopyBlock()
+// Description :
+// Parameters :
+// $p_mode : read/write compression mode
+// 0 : src & dest normal
+// 1 : src gzip, dest normal
+// 2 : src normal, dest gzip
+// 3 : src & dest gzip
+// Return Values :
+// --------------------------------------------------------------------------------
+function PclZipUtilCopyBlock($p_src, $p_dest, $p_size, $p_mode = 0)
+{
+ $v_result = 1;
+
+ if ($p_mode == 0) {
+ while ($p_size != 0) {
+ $v_read_size = ($p_size < PCLZIP_READ_BLOCK_SIZE ? $p_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @fread($p_src, $v_read_size);
+ @fwrite($p_dest, $v_buffer, $v_read_size);
+ $p_size -= $v_read_size;
+ }
+ } elseif ($p_mode == 1) {
+ while ($p_size != 0) {
+ $v_read_size = ($p_size < PCLZIP_READ_BLOCK_SIZE ? $p_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @gzread($p_src, $v_read_size);
+ @fwrite($p_dest, $v_buffer, $v_read_size);
+ $p_size -= $v_read_size;
+ }
+ } elseif ($p_mode == 2) {
+ while ($p_size != 0) {
+ $v_read_size = ($p_size < PCLZIP_READ_BLOCK_SIZE ? $p_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @fread($p_src, $v_read_size);
+ @gzwrite($p_dest, $v_buffer, $v_read_size);
+ $p_size -= $v_read_size;
+ }
+ } elseif ($p_mode == 3) {
+ while ($p_size != 0) {
+ $v_read_size = ($p_size < PCLZIP_READ_BLOCK_SIZE ? $p_size : PCLZIP_READ_BLOCK_SIZE);
+ $v_buffer = @gzread($p_src, $v_read_size);
+ @gzwrite($p_dest, $v_buffer, $v_read_size);
+ $p_size -= $v_read_size;
+ }
+ }
+
+ // ----- Return
+ return $v_result;
+}
+// --------------------------------------------------------------------------------
+
+// --------------------------------------------------------------------------------
+// Function : PclZipUtilRename()
+// Description :
+// This function tries to do a simple rename() function. If it fails, it
+// tries to copy the $p_src file in a new $p_dest file and then unlink the
+// first one.
+// Parameters :
+// $p_src : Old filename
+// $p_dest : New filename
+// Return Values :
+// 1 on success, 0 on failure.
+// --------------------------------------------------------------------------------
+function PclZipUtilRename($p_src, $p_dest)
+{
+ $v_result = 1;
+
+ // ----- Try to rename the files
+ if (!@rename($p_src, $p_dest)) {
+
+ // ----- Try to copy & unlink the src
+ if (!@copy($p_src, $p_dest)) {
+ $v_result = 0;
+ } elseif (!@unlink($p_src)) {
+ $v_result = 0;
+ }
+ }
+
+ // ----- Return
+ return $v_result;
+}
+// --------------------------------------------------------------------------------
+
+// --------------------------------------------------------------------------------
+// Function : PclZipUtilOptionText()
+// Description :
+// Translate option value in text. Mainly for debug purpose.
+// Parameters :
+// $p_option : the option value.
+// Return Values :
+// The option text value.
+// --------------------------------------------------------------------------------
+function PclZipUtilOptionText($p_option)
+{
+
+ $v_list = get_defined_constants();
+ for (reset($v_list); $v_key = key($v_list); next($v_list)) {
+ $v_prefix = substr($v_key, 0, 10);
+ if ((($v_prefix == 'PCLZIP_OPT') || ($v_prefix == 'PCLZIP_CB_') || ($v_prefix == 'PCLZIP_ATT')) && ($v_list[$v_key] == $p_option)) {
+ return $v_key;
+ }
+ }
+
+ $v_result = 'Unknown';
+
+ return $v_result;
+}
+// --------------------------------------------------------------------------------
+
+// --------------------------------------------------------------------------------
+// Function : PclZipUtilTranslateWinPath()
+// Description :
+// Translate windows path by replacing '\' by '/' and optionally removing
+// drive letter.
+// Parameters :
+// $p_path : path to translate.
+// $p_remove_disk_letter : true | false
+// Return Values :
+// The path translated.
+// --------------------------------------------------------------------------------
+function PclZipUtilTranslateWinPath($p_path, $p_remove_disk_letter = true)
+{
+ if (stristr(php_uname(), 'windows')) {
+ // ----- Look for potential disk letter
+ if (($p_remove_disk_letter) && (($v_position = strpos($p_path, ':')) != false)) {
+ $p_path = substr($p_path, $v_position + 1);
+ }
+ // ----- Change potential windows directory separator
+ if ((strpos($p_path, '\\') > 0) || (substr($p_path, 0, 1) == '\\')) {
+ $p_path = strtr($p_path, '\\', '/');
+ }
+ }
+
+ return $p_path;
+}
+// --------------------------------------------------------------------------------
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Shared/Text.php b/vendor/phpoffice/phpword/src/PhpWord/Shared/Text.php
new file mode 100644
index 00000000..b9a8831c
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Shared/Text.php
@@ -0,0 +1,253 @@
+)
+ * element or in the shared string element.
+ *
+ * @param string $value Value to escape
+ *
+ * @return string
+ */
+ public static function controlCharacterPHP2OOXML($value = '')
+ {
+ if (empty(self::$controlCharacters)) {
+ self::buildControlCharacters();
+ }
+
+ return str_replace(array_values(self::$controlCharacters), array_keys(self::$controlCharacters), $value);
+ }
+
+ /**
+ * Return a number formatted for being integrated in xml files.
+ *
+ * @param float $number
+ * @param int $decimals
+ *
+ * @return string
+ */
+ public static function numberFormat($number, $decimals)
+ {
+ return number_format($number, $decimals, '.', '');
+ }
+
+ /**
+ * @param int $dec
+ *
+ * @see http://stackoverflow.com/a/7153133/2235790
+ *
+ * @author velcrow
+ *
+ * @return string
+ */
+ public static function chr($dec)
+ {
+ if ($dec <= 0x7F) {
+ return chr($dec);
+ }
+ if ($dec <= 0x7FF) {
+ return chr(($dec >> 6) + 192) . chr(($dec & 63) + 128);
+ }
+ if ($dec <= 0xFFFF) {
+ return chr(($dec >> 12) + 224) . chr((($dec >> 6) & 63) + 128) . chr(($dec & 63) + 128);
+ }
+ if ($dec <= 0x1FFFFF) {
+ return chr(($dec >> 18) + 240) . chr((($dec >> 12) & 63) + 128) . chr((($dec >> 6) & 63) + 128) . chr(($dec & 63) + 128);
+ }
+
+ return '';
+ }
+
+ /**
+ * Convert from OpenXML escaped control character to PHP control character.
+ *
+ * @param string $value Value to unescape
+ *
+ * @return string
+ */
+ public static function controlCharacterOOXML2PHP($value = '')
+ {
+ if (empty(self::$controlCharacters)) {
+ self::buildControlCharacters();
+ }
+
+ return str_replace(array_keys(self::$controlCharacters), array_values(self::$controlCharacters), $value);
+ }
+
+ /**
+ * Check if a string contains UTF-8 data.
+ *
+ * @param string $value
+ *
+ * @return bool
+ */
+ public static function isUTF8($value = '')
+ {
+ return is_string($value) && ($value === '' || preg_match('/^./su', $value) == 1);
+ }
+
+ /**
+ * Return UTF8 encoded value.
+ *
+ * @param null|string $value
+ *
+ * @return ?string
+ */
+ public static function toUTF8($value = '')
+ {
+ if (null !== $value && !self::isUTF8($value)) {
+ // PHP8.2 : utf8_encode is deprecated, but mb_convert_encoding always usable
+ $value = (function_exists('mb_convert_encoding')) ? mb_convert_encoding($value, 'UTF-8', 'ISO-8859-1') : utf8_encode($value);
+ }
+
+ return $value;
+ }
+
+ /**
+ * Returns unicode from UTF8 text.
+ *
+ * The function is splitted to reduce cyclomatic complexity
+ *
+ * @param string $text UTF8 text
+ *
+ * @return string Unicode text
+ *
+ * @since 0.11.0
+ */
+ public static function toUnicode($text)
+ {
+ return self::unicodeToEntities(self::utf8ToUnicode($text));
+ }
+
+ /**
+ * Returns unicode array from UTF8 text.
+ *
+ * @param string $text UTF8 text
+ *
+ * @return array
+ *
+ * @since 0.11.0
+ * @see http://www.randomchaos.com/documents/?source=php_and_unicode
+ */
+ public static function utf8ToUnicode($text)
+ {
+ $unicode = [];
+ $values = [];
+ $lookingFor = 1;
+
+ // Gets unicode for each character
+ for ($i = 0; $i < strlen($text); ++$i) {
+ $thisValue = ord($text[$i]);
+ if ($thisValue < 128) {
+ $unicode[] = $thisValue;
+ } else {
+ if (count($values) == 0) {
+ $lookingFor = $thisValue < 224 ? 2 : 3;
+ }
+ $values[] = $thisValue;
+ if (count($values) == $lookingFor) {
+ if ($lookingFor == 3) {
+ $number = (($values[0] % 16) * 4096) + (($values[1] % 64) * 64) + ($values[2] % 64);
+ } else {
+ $number = (($values[0] % 32) * 64) + ($values[1] % 64);
+ }
+ $unicode[] = $number;
+ $values = [];
+ $lookingFor = 1;
+ }
+ }
+ }
+
+ return $unicode;
+ }
+
+ /**
+ * Returns entites from unicode array.
+ *
+ * @param array $unicode
+ *
+ * @return string
+ *
+ * @since 0.11.0
+ * @see http://www.randomchaos.com/documents/?source=php_and_unicode
+ */
+ private static function unicodeToEntities($unicode)
+ {
+ $entities = '';
+
+ foreach ($unicode as $value) {
+ if ($value != 65279) {
+ $entities .= $value > 127 ? '\uc0{\u' . $value . '}' : chr($value);
+ }
+ }
+
+ return $entities;
+ }
+
+ /**
+ * Return name without underscore for < 0.10.0 variable name compatibility.
+ *
+ * @param string $value
+ *
+ * @return string
+ */
+ public static function removeUnderscorePrefix($value)
+ {
+ if (null !== $value) {
+ if (substr($value, 0, 1) == '_') {
+ $value = substr($value, 1);
+ }
+ }
+
+ return $value;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Shared/Validate.php b/vendor/phpoffice/phpword/src/PhpWord/Shared/Validate.php
new file mode 100644
index 00000000..0967b569
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Shared/Validate.php
@@ -0,0 +1,76 @@
+open($zipFile);
+ if ($openStatus !== true) {
+ /**
+ * Throw an exception since making further calls on the ZipArchive would cause a fatal error.
+ * This prevents fatal errors on corrupt archives and attempts to open old "doc" files.
+ */
+ throw new Exception("The archive failed to load with the following error code: $openStatus");
+ }
+
+ $content = $zip->getFromName(ltrim($xmlFile, '/'));
+ $zip->close();
+
+ if ($content === false) {
+ return false;
+ }
+
+ return $this->getDomFromString($content);
+ }
+
+ /**
+ * Get DOMDocument from content string.
+ *
+ * @param string $content
+ *
+ * @return DOMDocument
+ */
+ public function getDomFromString($content)
+ {
+ if (\PHP_VERSION_ID < 80000) {
+ $originalLibXMLEntityValue = libxml_disable_entity_loader(true);
+ }
+ $this->dom = new DOMDocument();
+ $this->dom->loadXML($content);
+ if (\PHP_VERSION_ID < 80000) {
+ libxml_disable_entity_loader($originalLibXMLEntityValue);
+ }
+
+ return $this->dom;
+ }
+
+ /**
+ * Get elements.
+ *
+ * @param string $path
+ *
+ * @return DOMNodeList
+ */
+ public function getElements($path, ?DOMElement $contextNode = null)
+ {
+ if ($this->dom === null) {
+ return new DOMNodeList(); // @phpstan-ignore-line
+ }
+ if ($this->xpath === null) {
+ $this->xpath = new DOMXpath($this->dom);
+ }
+
+ $result = @$this->xpath->query($path, $contextNode);
+
+ return empty($result) ? new DOMNodeList() : $result; // @phpstan-ignore-line
+ }
+
+ /**
+ * Registers the namespace with the DOMXPath object.
+ *
+ * @param string $prefix The prefix
+ * @param string $namespaceURI The URI of the namespace
+ *
+ * @return bool true on success or false on failure
+ */
+ public function registerNamespace($prefix, $namespaceURI)
+ {
+ if ($this->dom === null) {
+ throw new InvalidArgumentException('Dom needs to be loaded before registering a namespace');
+ }
+ if ($this->xpath === null) {
+ $this->xpath = new DOMXpath($this->dom);
+ }
+
+ return $this->xpath->registerNamespace($prefix, $namespaceURI);
+ }
+
+ /**
+ * Get element.
+ *
+ * @param string $path
+ *
+ * @return null|DOMElement
+ */
+ public function getElement($path, ?DOMElement $contextNode = null)
+ {
+ $elements = $this->getElements($path, $contextNode);
+ if ($elements->length > 0) {
+ return $elements->item(0);
+ }
+
+ return null;
+ }
+
+ /**
+ * Get element attribute.
+ *
+ * @param string $attribute
+ * @param string $path
+ *
+ * @return null|string
+ */
+ public function getAttribute($attribute, ?DOMElement $contextNode = null, $path = null)
+ {
+ $return = null;
+ if ($path !== null) {
+ $elements = $this->getElements($path, $contextNode);
+ if ($elements->length > 0) {
+ /** @var DOMElement $node Type hint */
+ $node = $elements->item(0);
+ $return = $node->getAttribute($attribute);
+ }
+ } else {
+ if ($contextNode !== null) {
+ $return = $contextNode->getAttribute($attribute);
+ }
+ }
+
+ return ($return == '') ? null : $return;
+ }
+
+ /**
+ * Get element value.
+ *
+ * @param string $path
+ *
+ * @return null|string
+ */
+ public function getValue($path, ?DOMElement $contextNode = null)
+ {
+ $elements = $this->getElements($path, $contextNode);
+ if ($elements->length > 0) {
+ return $elements->item(0)->nodeValue;
+ }
+
+ return null;
+ }
+
+ /**
+ * Count elements.
+ *
+ * @param string $path
+ *
+ * @return int
+ */
+ public function countElements($path, ?DOMElement $contextNode = null)
+ {
+ $elements = $this->getElements($path, $contextNode);
+
+ return $elements->length;
+ }
+
+ /**
+ * Element exists.
+ *
+ * @param string $path
+ *
+ * @return bool
+ */
+ public function elementExists($path, ?DOMElement $contextNode = null)
+ {
+ return $this->getElements($path, $contextNode)->length > 0;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Shared/XMLWriter.php b/vendor/phpoffice/phpword/src/PhpWord/Shared/XMLWriter.php
new file mode 100644
index 00000000..9f51c0e5
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Shared/XMLWriter.php
@@ -0,0 +1,187 @@
+openMemory();
+ } else {
+ if (!$pTemporaryStorageDir || !is_dir($pTemporaryStorageDir)) {
+ $pTemporaryStorageDir = sys_get_temp_dir();
+ }
+ // Create temporary filename
+ $this->tempFileName = @tempnam($pTemporaryStorageDir, 'xml');
+
+ // Open storage
+ $this->openUri($this->tempFileName);
+ }
+
+ if ($compatibility) {
+ $this->setIndent(false);
+ $this->setIndentString('');
+ } else {
+ $this->setIndent(true);
+ $this->setIndentString(' ');
+ }
+ }
+
+ /**
+ * Destructor.
+ */
+ public function __destruct()
+ {
+ // Unlink temporary files
+ if (empty($this->tempFileName)) {
+ return;
+ }
+ if (PHP_OS != 'WINNT' && @unlink($this->tempFileName) === false) {
+ throw new Exception('The file ' . $this->tempFileName . ' could not be deleted.');
+ }
+ }
+
+ /**
+ * Get written data.
+ *
+ * @return string
+ */
+ public function getData()
+ {
+ if ($this->tempFileName == '') {
+ return $this->outputMemory(true);
+ }
+
+ $this->flush();
+
+ return file_get_contents($this->tempFileName);
+ }
+
+ /**
+ * Write simple element and attribute(s) block.
+ *
+ * There are two options:
+ * 1. If the `$attributes` is an array, then it's an associative array of attributes
+ * 2. If not, then it's a simple attribute-value pair
+ *
+ * @param string $element
+ * @param array|string $attributes
+ * @param string $value
+ */
+ public function writeElementBlock($element, $attributes, $value = null): void
+ {
+ $this->startElement($element);
+ if (!is_array($attributes)) {
+ $attributes = [$attributes => $value];
+ }
+ foreach ($attributes as $attribute => $value) {
+ $this->writeAttribute($attribute, $value);
+ }
+ $this->endElement();
+ }
+
+ /**
+ * Write element if ...
+ *
+ * @param bool $condition
+ * @param string $element
+ * @param string $attribute
+ * @param mixed $value
+ */
+ public function writeElementIf($condition, $element, $attribute = null, $value = null): void
+ {
+ if ($condition == true) {
+ if (null === $attribute) {
+ $this->writeElement($element, $value);
+ } else {
+ $this->startElement($element);
+ $this->writeAttribute($attribute, $value);
+ $this->endElement();
+ }
+ }
+ }
+
+ /**
+ * Write attribute if ...
+ *
+ * @param bool $condition
+ * @param string $attribute
+ * @param mixed $value
+ */
+ public function writeAttributeIf($condition, $attribute, $value): void
+ {
+ if ($condition == true) {
+ $this->writeAttribute($attribute, $value);
+ }
+ }
+
+ /**
+ * @param string $name
+ * @param mixed $value
+ *
+ * @return bool
+ */
+ #[ReturnTypeWillChange]
+ public function writeAttribute($name, $value)
+ {
+ if (is_float($value)) {
+ $value = json_encode($value);
+ }
+
+ return parent::writeAttribute($name, $value ?? '');
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Shared/ZipArchive.php b/vendor/phpoffice/phpword/src/PhpWord/Shared/ZipArchive.php
new file mode 100644
index 00000000..f120756d
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Shared/ZipArchive.php
@@ -0,0 +1,423 @@
+usePclzip = (Settings::getZipClass() != 'ZipArchive');
+ if ($this->usePclzip) {
+ if (!defined('PCLZIP_TEMPORARY_DIR')) {
+ define('PCLZIP_TEMPORARY_DIR', Settings::getTempDir() . '/');
+ }
+ require_once 'PCLZip/pclzip.lib.php';
+ }
+ }
+
+ /**
+ * Catch function calls: pass to ZipArchive or PCLZip.
+ *
+ * `call_user_func_array` can only used for public function, hence the `public` in all `pcl...` methods
+ *
+ * @param mixed $function
+ * @param mixed $args
+ *
+ * @return mixed
+ */
+ public function __call($function, $args)
+ {
+ // Set object and function
+ $zipFunction = $function;
+ if (!$this->usePclzip) {
+ $zipObject = $this->zip;
+ } else {
+ $zipObject = $this;
+ $zipFunction = "pclzip{$zipFunction}";
+ }
+
+ // Run function
+ $result = false;
+ if (method_exists($zipObject, $zipFunction)) {
+ $result = @call_user_func_array([$zipObject, $zipFunction], $args);
+ }
+
+ return $result;
+ }
+
+ /**
+ * Open a new zip archive.
+ *
+ * @param string $filename The file name of the ZIP archive to open
+ * @param int $flags The mode to use to open the archive
+ *
+ * @return bool
+ */
+ public function open($filename, $flags = null)
+ {
+ $result = true;
+ $this->filename = $filename;
+ $this->tempDir = Settings::getTempDir();
+
+ if (!$this->usePclzip) {
+ $zip = new \ZipArchive();
+
+ // PHP 8.1 compat - passing null as second arg to \ZipArchive::open() is deprecated
+ // passing 0 achieves the same behaviour
+ if ($flags === null) {
+ $flags = 0;
+ }
+
+ $result = $zip->open($this->filename, $flags);
+
+ // Scrutizer will report the property numFiles does not exist
+ // See https://github.com/scrutinizer-ci/php-analyzer/issues/190
+ $this->numFiles = $zip->numFiles;
+ } else {
+ $zip = new PclZip($this->filename);
+ $zipContent = $zip->listContent();
+ $this->numFiles = is_array($zipContent) ? count($zipContent) : 0;
+ }
+ $this->zip = $zip;
+
+ return $result;
+ }
+
+ /**
+ * Close the active archive.
+ *
+ * @return bool
+ */
+ public function close()
+ {
+ if (!$this->usePclzip) {
+ try {
+ $result = @$this->zip->close();
+ } catch (Throwable $e) {
+ $result = false;
+ }
+ if ($result === false) {
+ throw new Exception("Could not close zip file {$this->filename}: ");
+ }
+ }
+
+ return true;
+ }
+
+ /**
+ * Extract the archive contents (emulate \ZipArchive).
+ *
+ * @param string $destination
+ * @param array|string $entries
+ *
+ * @return bool
+ *
+ * @since 0.10.0
+ */
+ public function extractTo($destination, $entries = null)
+ {
+ if (!is_dir($destination)) {
+ return false;
+ }
+
+ if (!$this->usePclzip) {
+ return $this->zip->extractTo($destination, $entries);
+ }
+
+ return $this->pclzipExtractTo($destination, $entries);
+ }
+
+ /**
+ * Extract file from archive by given file name (emulate \ZipArchive).
+ *
+ * @param string $filename Filename for the file in zip archive
+ *
+ * @return string $contents File string contents
+ */
+ public function getFromName($filename)
+ {
+ if (!$this->usePclzip) {
+ $contents = $this->zip->getFromName($filename);
+ if ($contents === false) {
+ $filename = substr($filename, 1);
+ $contents = $this->zip->getFromName($filename);
+ }
+ } else {
+ $contents = $this->pclzipGetFromName($filename);
+ }
+
+ return $contents;
+ }
+
+ /**
+ * Add a new file to the zip archive (emulate \ZipArchive).
+ *
+ * @param string $filename Directory/Name of the file to add to the zip archive
+ * @param string $localname Directory/Name of the file added to the zip
+ *
+ * @return bool
+ */
+ public function pclzipAddFile($filename, $localname = null)
+ {
+ /** @var PclZip $zip Type hint */
+ $zip = $this->zip;
+
+ // Bugfix GH-261 https://github.com/PHPOffice/PHPWord/pull/261
+ $realpathFilename = realpath($filename);
+ if ($realpathFilename !== false) {
+ $filename = $realpathFilename;
+ }
+
+ $filenameParts = pathinfo($filename);
+ $localnameParts = pathinfo($localname);
+
+ // To Rename the file while adding it to the zip we
+ // need to create a temp file with the correct name
+ $tempFile = false;
+ if ($filenameParts['basename'] != $localnameParts['basename']) {
+ $tempFile = true; // temp file created
+ $temppath = $this->tempDir . DIRECTORY_SEPARATOR . $localnameParts['basename'];
+ copy($filename, $temppath);
+ $filename = $temppath;
+ $filenameParts = pathinfo($temppath);
+ }
+
+ $pathRemoved = $filenameParts['dirname'];
+ $pathAdded = $localnameParts['dirname'];
+
+ if (!$this->usePclzip) {
+ $pathAdded = $pathAdded . '/' . ltrim(str_replace('\\', '/', substr($filename, strlen($pathRemoved))), '/');
+ //$res = $zip->addFile($filename, $pathAdded);
+ $res = $zip->addFromString($pathAdded, file_get_contents($filename)); // addFile can't use subfolders in some cases
+ } else {
+ $res = $zip->add($filename, PCLZIP_OPT_REMOVE_PATH, $pathRemoved, PCLZIP_OPT_ADD_PATH, $pathAdded);
+ }
+
+ if ($tempFile) {
+ // Remove temp file, if created
+ unlink($this->tempDir . DIRECTORY_SEPARATOR . $localnameParts['basename']);
+ }
+
+ return $res != 0;
+ }
+
+ /**
+ * Add a new file to the zip archive from a string of raw data (emulate \ZipArchive).
+ *
+ * @param string $localname Directory/Name of the file to add to the zip archive
+ * @param string $contents String of data to add to the zip archive
+ *
+ * @return bool
+ */
+ public function pclzipAddFromString($localname, $contents)
+ {
+ /** @var PclZip $zip Type hint */
+ $zip = $this->zip;
+ $filenameParts = pathinfo($localname);
+
+ // Write $contents to a temp file
+ $handle = fopen($this->tempDir . DIRECTORY_SEPARATOR . $filenameParts['basename'], 'wb');
+ fwrite($handle, $contents);
+ fclose($handle);
+
+ // Add temp file to zip
+ $filename = $this->tempDir . DIRECTORY_SEPARATOR . $filenameParts['basename'];
+ $pathRemoved = $this->tempDir;
+ $pathAdded = $filenameParts['dirname'];
+
+ $res = $zip->add($filename, PCLZIP_OPT_REMOVE_PATH, $pathRemoved, PCLZIP_OPT_ADD_PATH, $pathAdded);
+
+ // Remove temp file
+ @unlink($this->tempDir . DIRECTORY_SEPARATOR . $filenameParts['basename']);
+
+ return $res != 0;
+ }
+
+ /**
+ * Extract the archive contents (emulate \ZipArchive).
+ *
+ * @param string $destination
+ * @param array|string $entries
+ *
+ * @return bool
+ *
+ * @since 0.10.0
+ */
+ public function pclzipExtractTo($destination, $entries = null)
+ {
+ /** @var PclZip $zip Type hint */
+ $zip = $this->zip;
+
+ // Extract all files
+ if (null === $entries) {
+ $result = $zip->extract(PCLZIP_OPT_PATH, $destination);
+
+ return $result > 0;
+ }
+
+ // Extract by entries
+ if (!is_array($entries)) {
+ $entries = [$entries];
+ }
+ foreach ($entries as $entry) {
+ $entryIndex = $this->locateName($entry);
+ $result = $zip->extractByIndex($entryIndex, PCLZIP_OPT_PATH, $destination);
+ if ($result <= 0) {
+ return false;
+ }
+ }
+
+ return true;
+ }
+
+ /**
+ * Extract file from archive by given file name (emulate \ZipArchive).
+ *
+ * @param string $filename Filename for the file in zip archive
+ *
+ * @return string $contents File string contents
+ */
+ public function pclzipGetFromName($filename)
+ {
+ /** @var PclZip $zip Type hint */
+ $zip = $this->zip;
+ $listIndex = $this->pclzipLocateName($filename);
+ $contents = false;
+
+ if ($listIndex !== false) {
+ $extracted = $zip->extractByIndex($listIndex, PCLZIP_OPT_EXTRACT_AS_STRING);
+ } else {
+ $filename = substr($filename, 1);
+ $listIndex = $this->pclzipLocateName($filename);
+ $extracted = $zip->extractByIndex($listIndex, PCLZIP_OPT_EXTRACT_AS_STRING);
+ }
+ if ((is_array($extracted)) && ($extracted != 0)) {
+ $contents = $extracted[0]['content'];
+ }
+
+ return $contents;
+ }
+
+ /**
+ * Returns the name of an entry using its index (emulate \ZipArchive).
+ *
+ * @param int $index
+ *
+ * @return bool|string
+ *
+ * @since 0.10.0
+ */
+ public function pclzipGetNameIndex($index)
+ {
+ /** @var PclZip $zip Type hint */
+ $zip = $this->zip;
+ $list = $zip->listContent();
+ if (isset($list[$index])) {
+ return $list[$index]['filename'];
+ }
+
+ return false;
+ }
+
+ /**
+ * Returns the index of the entry in the archive (emulate \ZipArchive).
+ *
+ * @param string $filename Filename for the file in zip archive
+ *
+ * @return false|int
+ */
+ public function pclzipLocateName($filename)
+ {
+ /** @var PclZip $zip Type hint */
+ $zip = $this->zip;
+ $list = $zip->listContent();
+ $listCount = count($list);
+ $listIndex = -1;
+ for ($i = 0; $i < $listCount; ++$i) {
+ if (strtolower($list[$i]['filename']) == strtolower($filename) ||
+ strtolower($list[$i]['stored_filename']) == strtolower($filename)) {
+ $listIndex = $i;
+
+ break;
+ }
+ }
+
+ return ($listIndex > -1) ? $listIndex : false;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/SimpleType/Border.php b/vendor/phpoffice/phpword/src/PhpWord/SimpleType/Border.php
new file mode 100644
index 00000000..6cb42f04
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/SimpleType/Border.php
@@ -0,0 +1,57 @@
+setStyleByArray($value);
+ } elseif ($value instanceof AbstractStyle) {
+ if (get_class($style) == get_class($value)) {
+ $style = $value;
+ }
+ }
+ }
+ $style->setStyleName($name);
+ $style->setIndex(self::countStyles() + 1); // One based index
+ self::$styles[$name] = $style;
+ }
+
+ return self::getStyle($name);
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/AbstractStyle.php b/vendor/phpoffice/phpword/src/PhpWord/Style/AbstractStyle.php
new file mode 100644
index 00000000..4e5def61
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/AbstractStyle.php
@@ -0,0 +1,358 @@
+styleName;
+ }
+
+ /**
+ * Set style name.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setStyleName($value)
+ {
+ $this->styleName = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get index number.
+ *
+ * @return null|int
+ */
+ public function getIndex()
+ {
+ return $this->index;
+ }
+
+ /**
+ * Set index number.
+ *
+ * @param null|int $value
+ *
+ * @return self
+ */
+ public function setIndex($value = null)
+ {
+ $this->index = $this->setIntVal($value, $this->index);
+
+ return $this;
+ }
+
+ /**
+ * Get is automatic style flag.
+ *
+ * @return bool
+ */
+ public function isAuto()
+ {
+ return $this->isAuto;
+ }
+
+ /**
+ * Set is automatic style flag.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setAuto($value = true)
+ {
+ $this->isAuto = $this->setBoolVal($value, $this->isAuto);
+
+ return $this;
+ }
+
+ /**
+ * Return style value of child style object, e.g. `left` from `Indentation` child style of `Paragraph`.
+ *
+ * @param \PhpOffice\PhpWord\Style\AbstractStyle $substyleObject
+ * @param string $substyleProperty
+ *
+ * @return mixed
+ *
+ * @since 0.12.0
+ */
+ public function getChildStyleValue($substyleObject, $substyleProperty)
+ {
+ if ($substyleObject !== null) {
+ $method = "get{$substyleProperty}";
+
+ return $substyleObject->$method();
+ }
+
+ return null;
+ }
+
+ /**
+ * Set style value template method.
+ *
+ * Some child classes have their own specific overrides.
+ * Backward compability check for versions < 0.10.0 which use underscore
+ * prefix for their private properties.
+ * Check if the set method is exists. Throws an exception?
+ *
+ * @param string $key
+ * @param array|int|string $value
+ *
+ * @return self
+ */
+ public function setStyleValue($key, $value)
+ {
+ if (isset($this->aliases[$key])) {
+ $key = $this->aliases[$key];
+ }
+
+ if ($key === 'align') {
+ $key = 'alignment';
+ }
+
+ $method = 'set' . Text::removeUnderscorePrefix($key);
+ if (method_exists($this, $method)) {
+ $this->$method($value);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set style by using associative array.
+ *
+ * @param array $values
+ *
+ * @return self
+ */
+ public function setStyleByArray($values = [])
+ {
+ foreach ($values as $key => $value) {
+ $this->setStyleValue($key, $value);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Set default for null and empty value.
+ *
+ * @param ?string $value
+ * @param string $default
+ *
+ * @return string
+ */
+ protected function setNonEmptyVal($value, $default)
+ {
+ if ($value === null || $value == '') {
+ $value = $default;
+ }
+
+ return $value;
+ }
+
+ /**
+ * Set bool value.
+ *
+ * @param bool $value
+ * @param bool $default
+ *
+ * @return bool
+ */
+ protected function setBoolVal($value, $default)
+ {
+ if (!is_bool($value)) {
+ $value = $default;
+ }
+
+ return $value;
+ }
+
+ /**
+ * Set numeric value.
+ *
+ * @param mixed $value
+ * @param null|float|int $default
+ *
+ * @return null|float|int
+ */
+ protected function setNumericVal($value, $default = null)
+ {
+ if (!is_numeric($value)) {
+ $value = $default;
+ }
+
+ return $value;
+ }
+
+ /**
+ * Set integer value: Convert string that contains only numeric into integer.
+ *
+ * @param null|float|int|string $value
+ * @param null|int $default
+ *
+ * @return null|int
+ */
+ protected function setIntVal($value, $default = null)
+ {
+ if (is_string($value) && (preg_match('/[^\d]/', $value) == 0)) {
+ $value = (int) $value;
+ }
+ if (!is_numeric($value)) {
+ $value = $default;
+ } else {
+ $value = (int) $value;
+ }
+
+ return $value;
+ }
+
+ /**
+ * Set float value: Convert string that contains only numeric into float.
+ *
+ * @param mixed $value
+ * @param null|float $default
+ *
+ * @return null|float
+ */
+ protected function setFloatVal($value, $default = null)
+ {
+ if (is_string($value) && (preg_match('/[^\d\.\,]/', $value) == 0)) {
+ $value = (float) $value;
+ }
+ if (!is_numeric($value)) {
+ $value = $default;
+ }
+
+ return $value;
+ }
+
+ /**
+ * Set enum value.
+ *
+ * @param mixed $value
+ * @param array $enum
+ * @param mixed $default
+ *
+ * @return mixed
+ */
+ protected function setEnumVal($value = null, $enum = [], $default = null)
+ {
+ if ($value != null && trim($value) != '' && !empty($enum) && !in_array($value, $enum)) {
+ throw new InvalidArgumentException("Invalid style value: {$value} Options:" . implode(',', $enum));
+ } elseif ($value === null || trim($value) == '') {
+ $value = $default;
+ }
+
+ return $value;
+ }
+
+ /**
+ * Set object value.
+ *
+ * @param mixed $value
+ * @param string $styleName
+ * @param mixed &$style
+ *
+ * @return mixed
+ */
+ protected function setObjectVal($value, $styleName, &$style)
+ {
+ $styleClass = substr(static::class, 0, strrpos(static::class, '\\')) . '\\' . $styleName;
+ if (is_array($value)) {
+ /** @var \PhpOffice\PhpWord\Style\AbstractStyle $style Type hint */
+ if (!$style instanceof $styleClass) {
+ $style = new $styleClass();
+ }
+ $style->setStyleByArray($value);
+ } else {
+ $style = $value;
+ }
+
+ return $style;
+ }
+
+ /**
+ * Set $property value and set $pairProperty = false when $value = true.
+ *
+ * @param bool &$property
+ * @param bool &$pairProperty
+ * @param bool $value
+ *
+ * @return self
+ */
+ protected function setPairedVal(&$property, &$pairProperty, $value)
+ {
+ $property = $this->setBoolVal($value, $property);
+ if ($value === true) {
+ $pairProperty = false;
+ }
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Border.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Border.php
new file mode 100644
index 00000000..e2a56c5d
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Border.php
@@ -0,0 +1,630 @@
+getBorderTopSize(),
+ $this->getBorderLeftSize(),
+ $this->getBorderRightSize(),
+ $this->getBorderBottomSize(),
+ ];
+ }
+
+ /**
+ * Set border size.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setBorderSize($value = null)
+ {
+ $this->setBorderTopSize($value);
+ $this->setBorderLeftSize($value);
+ $this->setBorderRightSize($value);
+ $this->setBorderBottomSize($value);
+
+ return $this;
+ }
+
+ /**
+ * Get border color.
+ *
+ * @return array
+ */
+ public function getBorderColor()
+ {
+ return [
+ $this->getBorderTopColor(),
+ $this->getBorderLeftColor(),
+ $this->getBorderRightColor(),
+ $this->getBorderBottomColor(),
+ ];
+ }
+
+ /**
+ * Set border color.
+ *
+ * @param null|string $value
+ *
+ * @return self
+ */
+ public function setBorderColor($value = null)
+ {
+ $this->setBorderTopColor($value);
+ $this->setBorderLeftColor($value);
+ $this->setBorderRightColor($value);
+ $this->setBorderBottomColor($value);
+
+ return $this;
+ }
+
+ /**
+ * Get border style.
+ *
+ * @return string[]
+ */
+ public function getBorderStyle()
+ {
+ return [
+ $this->getBorderTopStyle(),
+ $this->getBorderLeftStyle(),
+ $this->getBorderRightStyle(),
+ $this->getBorderBottomStyle(),
+ ];
+ }
+
+ /**
+ * Set border style.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBorderStyle($value = null)
+ {
+ $this->setBorderTopStyle($value);
+ $this->setBorderLeftStyle($value);
+ $this->setBorderRightStyle($value);
+ $this->setBorderBottomStyle($value);
+
+ return $this;
+ }
+
+ /**
+ * Get border top size.
+ *
+ * @return float|int
+ */
+ public function getBorderTopSize()
+ {
+ return $this->borderTopSize;
+ }
+
+ /**
+ * Set border top size.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setBorderTopSize($value = null)
+ {
+ $this->borderTopSize = $this->setNumericVal($value, $this->borderTopSize);
+
+ return $this;
+ }
+
+ /**
+ * Get border top color.
+ *
+ * @return null|string
+ */
+ public function getBorderTopColor()
+ {
+ return $this->borderTopColor;
+ }
+
+ /**
+ * Set border top color.
+ *
+ * @param null|string $value
+ *
+ * @return self
+ */
+ public function setBorderTopColor($value = null)
+ {
+ $this->borderTopColor = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get border top style.
+ *
+ * @return string
+ */
+ public function getBorderTopStyle()
+ {
+ return $this->borderTopStyle;
+ }
+
+ /**
+ * Set border top Style.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBorderTopStyle($value = null)
+ {
+ $this->borderTopStyle = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get border left size.
+ *
+ * @return float|int
+ */
+ public function getBorderLeftSize()
+ {
+ return $this->borderLeftSize;
+ }
+
+ /**
+ * Set border left size.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setBorderLeftSize($value = null)
+ {
+ $this->borderLeftSize = $this->setNumericVal($value, $this->borderLeftSize);
+
+ return $this;
+ }
+
+ /**
+ * Get border left color.
+ *
+ * @return null|string
+ */
+ public function getBorderLeftColor()
+ {
+ return $this->borderLeftColor;
+ }
+
+ /**
+ * Set border left color.
+ *
+ * @param null|string $value
+ *
+ * @return self
+ */
+ public function setBorderLeftColor($value = null)
+ {
+ $this->borderLeftColor = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get border left style.
+ *
+ * @return string
+ */
+ public function getBorderLeftStyle()
+ {
+ return $this->borderLeftStyle;
+ }
+
+ /**
+ * Set border left style.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBorderLeftStyle($value = null)
+ {
+ $this->borderLeftStyle = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get border right size.
+ *
+ * @return float|int
+ */
+ public function getBorderRightSize()
+ {
+ return $this->borderRightSize;
+ }
+
+ /**
+ * Set border right size.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setBorderRightSize($value = null)
+ {
+ $this->borderRightSize = $this->setNumericVal($value, $this->borderRightSize);
+
+ return $this;
+ }
+
+ /**
+ * Get border right color.
+ *
+ * @return null|string
+ */
+ public function getBorderRightColor()
+ {
+ return $this->borderRightColor;
+ }
+
+ /**
+ * Set border right color.
+ *
+ * @param null|string $value
+ *
+ * @return self
+ */
+ public function setBorderRightColor($value = null)
+ {
+ $this->borderRightColor = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get border right style.
+ *
+ * @return string
+ */
+ public function getBorderRightStyle()
+ {
+ return $this->borderRightStyle;
+ }
+
+ /**
+ * Set border right style.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBorderRightStyle($value = null)
+ {
+ $this->borderRightStyle = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get border bottom size.
+ *
+ * @return float|int
+ */
+ public function getBorderBottomSize()
+ {
+ return $this->borderBottomSize;
+ }
+
+ /**
+ * Set border bottom size.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setBorderBottomSize($value = null)
+ {
+ $this->borderBottomSize = $this->setNumericVal($value, $this->borderBottomSize);
+
+ return $this;
+ }
+
+ /**
+ * Get border bottom color.
+ *
+ * @return null|string
+ */
+ public function getBorderBottomColor()
+ {
+ return $this->borderBottomColor;
+ }
+
+ /**
+ * Set border bottom color.
+ *
+ * @param null|string $value
+ *
+ * @return self
+ */
+ public function setBorderBottomColor($value = null)
+ {
+ $this->borderBottomColor = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get border bottom style.
+ *
+ * @return string
+ */
+ public function getBorderBottomStyle()
+ {
+ return $this->borderBottomStyle;
+ }
+
+ /**
+ * Set border bottom style.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBorderBottomStyle($value = null)
+ {
+ $this->borderBottomStyle = $value;
+
+ return $this;
+ }
+
+ /**
+ * Check if any of the border is not null.
+ *
+ * @return bool
+ */
+ public function hasBorder()
+ {
+ $borders = $this->getBorderSize();
+
+ return $borders !== array_filter($borders, 'is_null');
+ }
+
+ /**
+ * Get Margin Top.
+ *
+ * @return float|int
+ */
+ public function getMarginTop()
+ {
+ return $this->marginTop;
+ }
+
+ /**
+ * Set Margin Top.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setMarginTop($value = null)
+ {
+ $this->marginTop = $this->setNumericVal($value, self::DEFAULT_MARGIN);
+
+ return $this;
+ }
+
+ /**
+ * Get Margin Left.
+ *
+ * @return float|int
+ */
+ public function getMarginLeft()
+ {
+ return $this->marginLeft;
+ }
+
+ /**
+ * Set Margin Left.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setMarginLeft($value = null)
+ {
+ $this->marginLeft = $this->setNumericVal($value, self::DEFAULT_MARGIN);
+
+ return $this;
+ }
+
+ /**
+ * Get Margin Right.
+ *
+ * @return float|int
+ */
+ public function getMarginRight()
+ {
+ return $this->marginRight;
+ }
+
+ /**
+ * Set Margin Right.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setMarginRight($value = null)
+ {
+ $this->marginRight = $this->setNumericVal($value, self::DEFAULT_MARGIN);
+
+ return $this;
+ }
+
+ /**
+ * Get Margin Bottom.
+ *
+ * @return float|int
+ */
+ public function getMarginBottom()
+ {
+ return $this->marginBottom;
+ }
+
+ /**
+ * Set Margin Bottom.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setMarginBottom($value = null)
+ {
+ $this->marginBottom = $this->setNumericVal($value, self::DEFAULT_MARGIN);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Cell.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Cell.php
new file mode 100644
index 00000000..3246471f
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Cell.php
@@ -0,0 +1,347 @@
+vAlign;
+ }
+
+ /**
+ * Set vertical align.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setVAlign($value = null)
+ {
+ VerticalJc::validate($value);
+ $this->vAlign = $this->setEnumVal($value, VerticalJc::values(), $this->vAlign);
+
+ return $this;
+ }
+
+ /**
+ * Get text direction.
+ *
+ * @return string
+ */
+ public function getTextDirection()
+ {
+ return $this->textDirection;
+ }
+
+ /**
+ * Set text direction.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setTextDirection($value = null)
+ {
+ $enum = [
+ self::TEXT_DIR_BTLR,
+ self::TEXT_DIR_TBRL,
+ self::TEXT_DIR_LRTB,
+ self::TEXT_DIR_LRTBV,
+ self::TEXT_DIR_TBRLV,
+ self::TEXT_DIR_TBLRV,
+ ];
+ $this->textDirection = $this->setEnumVal($value, $enum, $this->textDirection);
+
+ return $this;
+ }
+
+ /**
+ * Get background.
+ *
+ * @return string
+ */
+ public function getBgColor()
+ {
+ if ($this->shading !== null) {
+ return $this->shading->getFill();
+ }
+
+ return null;
+ }
+
+ /**
+ * Set background.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBgColor($value = null)
+ {
+ return $this->setShading(['fill' => $value]);
+ }
+
+ /**
+ * Get grid span (colspan).
+ *
+ * @return int
+ */
+ public function getGridSpan()
+ {
+ return $this->gridSpan;
+ }
+
+ /**
+ * Set grid span (colspan).
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setGridSpan($value = null)
+ {
+ $this->gridSpan = $this->setIntVal($value, $this->gridSpan);
+
+ return $this;
+ }
+
+ /**
+ * Get vertical merge (rowspan).
+ *
+ * @return string
+ */
+ public function getVMerge()
+ {
+ return $this->vMerge;
+ }
+
+ /**
+ * Set vertical merge (rowspan).
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setVMerge($value = null)
+ {
+ $enum = [self::VMERGE_RESTART, self::VMERGE_CONTINUE];
+ $this->vMerge = $this->setEnumVal($value, $enum, $this->vMerge);
+
+ return $this;
+ }
+
+ /**
+ * Get shading.
+ *
+ * @return \PhpOffice\PhpWord\Style\Shading
+ */
+ public function getShading()
+ {
+ return $this->shading;
+ }
+
+ /**
+ * Set shading.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setShading($value = null)
+ {
+ $this->setObjectVal($value, 'Shading', $this->shading);
+
+ return $this;
+ }
+
+ /**
+ * Get cell width.
+ *
+ * @return ?int
+ */
+ public function getWidth()
+ {
+ return $this->width;
+ }
+
+ /**
+ * Set cell width.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setWidth($value)
+ {
+ $this->width = $this->setIntVal($value);
+
+ return $this;
+ }
+
+ /**
+ * Get width unit.
+ *
+ * @return string
+ */
+ public function getUnit()
+ {
+ return $this->unit;
+ }
+
+ /**
+ * Set width unit.
+ *
+ * @param string $value
+ */
+ public function setUnit($value)
+ {
+ $this->unit = $this->setEnumVal($value, [TblWidth::AUTO, TblWidth::PERCENT, TblWidth::TWIP], TblWidth::TWIP);
+
+ return $this;
+ }
+
+ /**
+ * Set noWrap.
+ */
+ public function setNoWrap(bool $value): self
+ {
+ $this->noWrap = $this->setBoolVal($value, true);
+
+ return $this;
+ }
+
+ /**
+ * Get noWrap.
+ */
+ public function getNoWrap(): bool
+ {
+ return $this->noWrap;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Chart.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Chart.php
new file mode 100644
index 00000000..9dbc8db0
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Chart.php
@@ -0,0 +1,553 @@
+ true, // value
+ 'showCatName' => true, // category name
+ 'showLegendKey' => false, //show the cart legend
+ 'showSerName' => false, // series name
+ 'showPercent' => false,
+ 'showLeaderLines' => false,
+ 'showBubbleSize' => false,
+ ];
+
+ /**
+ * A string that tells the writer where to write chart labels or to skip
+ * "nextTo" - sets labels next to the axis (bar graphs on the left) (default)
+ * "low" - labels on the left side of the graph
+ * "high" - labels on the right side of the graph.
+ *
+ * @var string
+ */
+ private $categoryLabelPosition = 'nextTo';
+
+ /**
+ * A string that tells the writer where to write chart labels or to skip
+ * "nextTo" - sets labels next to the axis (bar graphs on the bottom) (default)
+ * "low" - labels are below the graph
+ * "high" - labels above the graph.
+ *
+ * @var string
+ */
+ private $valueLabelPosition = 'nextTo';
+
+ /**
+ * @var string
+ */
+ private $categoryAxisTitle;
+
+ /**
+ * @var string
+ */
+ private $valueAxisTitle;
+
+ /**
+ * The position for major tick marks
+ * Possible values are 'in', 'out', 'cross', 'none'.
+ *
+ * @var string
+ */
+ private $majorTickMarkPos = 'none';
+
+ /**
+ * Show labels for axis.
+ *
+ * @var bool
+ */
+ private $showAxisLabels = false;
+
+ /**
+ * Show Gridlines for Y-Axis.
+ *
+ * @var bool
+ */
+ private $gridY = false;
+
+ /**
+ * Show Gridlines for X-Axis.
+ *
+ * @var bool
+ */
+ private $gridX = false;
+
+ /**
+ * Create a new instance.
+ *
+ * @param array $style
+ */
+ public function __construct($style = [])
+ {
+ $this->setStyleByArray($style);
+ }
+
+ /**
+ * Get width.
+ *
+ * @return int
+ */
+ public function getWidth()
+ {
+ return $this->width;
+ }
+
+ /**
+ * Set width.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setWidth($value = null)
+ {
+ $this->width = $this->setIntVal($value, $this->width);
+
+ return $this;
+ }
+
+ /**
+ * Get height.
+ *
+ * @return int
+ */
+ public function getHeight()
+ {
+ return $this->height;
+ }
+
+ /**
+ * Set height.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setHeight($value = null)
+ {
+ $this->height = $this->setIntVal($value, $this->height);
+
+ return $this;
+ }
+
+ /**
+ * Is 3D.
+ *
+ * @return bool
+ */
+ public function is3d()
+ {
+ return $this->is3d;
+ }
+
+ /**
+ * Set 3D.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function set3d($value = true)
+ {
+ $this->is3d = $this->setBoolVal($value, $this->is3d);
+
+ return $this;
+ }
+
+ /**
+ * Get the list of colors to use in a chart.
+ *
+ * @return array
+ */
+ public function getColors()
+ {
+ return $this->colors;
+ }
+
+ /**
+ * Set the colors to use in a chart.
+ *
+ * @param array $value a list of colors to use in the chart
+ *
+ * @return self
+ */
+ public function setColors($value = [])
+ {
+ $this->colors = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get the chart title.
+ *
+ * @return string
+ */
+ public function getTitle()
+ {
+ return $this->title;
+ }
+
+ /**
+ * Set the chart title.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setTitle($value = null)
+ {
+ $this->title = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get chart legend visibility.
+ *
+ * @return bool
+ */
+ public function isShowLegend()
+ {
+ return $this->showLegend;
+ }
+
+ /**
+ * Set chart legend visibility.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setShowLegend($value = false)
+ {
+ $this->showLegend = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get chart legend position.
+ *
+ * @return string
+ */
+ public function getLegendPosition()
+ {
+ return $this->legendPosition;
+ }
+
+ /**
+ * Set chart legend position. choices:
+ * "r" - right of chart
+ * "b" - bottom of chart
+ * "t" - top of chart
+ * "l" - left of chart
+ * "tr" - top right of chart.
+ *
+ * default: right
+ *
+ * @param string $legendPosition
+ *
+ * @return self
+ */
+ public function setLegendPosition($legendPosition = 'r')
+ {
+ $enum = ['r', 'b', 't', 'l', 'tr'];
+ $this->legendPosition = $this->setEnumVal($legendPosition, $enum, $this->legendPosition);
+
+ return $this;
+ }
+
+ /*
+ * Show labels for axis
+ *
+ * @return bool
+ */
+ public function showAxisLabels()
+ {
+ return $this->showAxisLabels;
+ }
+
+ /**
+ * Set show Gridlines for Y-Axis.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setShowAxisLabels($value = true)
+ {
+ $this->showAxisLabels = $this->setBoolVal($value, $this->showAxisLabels);
+
+ return $this;
+ }
+
+ /**
+ * get the list of options for data labels.
+ *
+ * @return array
+ */
+ public function getDataLabelOptions()
+ {
+ return $this->dataLabelOptions;
+ }
+
+ /**
+ * Set values for data label options.
+ * This will only change values for options defined in $this->dataLabelOptions, and cannot create new ones.
+ *
+ * @param array $values [description]
+ */
+ public function setDataLabelOptions($values = []): void
+ {
+ foreach (array_keys($this->dataLabelOptions) as $option) {
+ if (isset($values[$option])) {
+ $this->dataLabelOptions[$option] = $this->setBoolVal(
+ $values[$option],
+ $this->dataLabelOptions[$option]
+ );
+ }
+ }
+ }
+
+ /*
+ * Show Gridlines for Y-Axis
+ *
+ * @return bool
+ */
+ public function showGridY()
+ {
+ return $this->gridY;
+ }
+
+ /**
+ * Set show Gridlines for Y-Axis.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setShowGridY($value = true)
+ {
+ $this->gridY = $this->setBoolVal($value, $this->gridY);
+
+ return $this;
+ }
+
+ /**
+ * Get the categoryLabelPosition setting.
+ *
+ * @return string
+ */
+ public function getCategoryLabelPosition()
+ {
+ return $this->categoryLabelPosition;
+ }
+
+ /**
+ * Set the categoryLabelPosition setting
+ * "none" - skips writing labels
+ * "nextTo" - sets labels next to the (bar graphs on the left)
+ * "low" - labels on the left side of the graph
+ * "high" - labels on the right side of the graph.
+ *
+ * @param mixed $labelPosition
+ *
+ * @return self
+ */
+ public function setCategoryLabelPosition($labelPosition)
+ {
+ $enum = ['nextTo', 'low', 'high'];
+ $this->categoryLabelPosition = $this->setEnumVal($labelPosition, $enum, $this->categoryLabelPosition);
+
+ return $this;
+ }
+
+ /**
+ * Get the valueAxisLabelPosition setting.
+ *
+ * @return string
+ */
+ public function getValueLabelPosition()
+ {
+ return $this->valueLabelPosition;
+ }
+
+ /**
+ * Set the valueLabelPosition setting
+ * "none" - skips writing labels
+ * "nextTo" - sets labels next to the value
+ * "low" - sets labels are below the graph
+ * "high" - sets labels above the graph.
+ *
+ * @param string
+ * @param mixed $labelPosition
+ */
+ public function setValueLabelPosition($labelPosition)
+ {
+ $enum = ['nextTo', 'low', 'high'];
+ $this->valueLabelPosition = $this->setEnumVal($labelPosition, $enum, $this->valueLabelPosition);
+
+ return $this;
+ }
+
+ /**
+ * Get the categoryAxisTitle.
+ *
+ * @return string
+ */
+ public function getCategoryAxisTitle()
+ {
+ return $this->categoryAxisTitle;
+ }
+
+ /**
+ * Set the title that appears on the category side of the chart.
+ *
+ * @param string $axisTitle
+ */
+ public function setCategoryAxisTitle($axisTitle)
+ {
+ $this->categoryAxisTitle = $axisTitle;
+
+ return $this;
+ }
+
+ /**
+ * Get the valueAxisTitle.
+ *
+ * @return string
+ */
+ public function getValueAxisTitle()
+ {
+ return $this->valueAxisTitle;
+ }
+
+ /**
+ * Set the title that appears on the value side of the chart.
+ *
+ * @param string $axisTitle
+ */
+ public function setValueAxisTitle($axisTitle)
+ {
+ $this->valueAxisTitle = $axisTitle;
+
+ return $this;
+ }
+
+ public function getMajorTickPosition()
+ {
+ return $this->majorTickMarkPos;
+ }
+
+ /**
+ * Set the position for major tick marks.
+ *
+ * @param string $position
+ */
+ public function setMajorTickPosition($position): void
+ {
+ $enum = ['in', 'out', 'cross', 'none'];
+ $this->majorTickMarkPos = $this->setEnumVal($position, $enum, $this->majorTickMarkPos);
+ }
+
+ /**
+ * Show Gridlines for X-Axis.
+ *
+ * @return bool
+ */
+ public function showGridX()
+ {
+ return $this->gridX;
+ }
+
+ /**
+ * Set show Gridlines for X-Axis.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setShowGridX($value = true)
+ {
+ $this->gridX = $this->setBoolVal($value, $this->gridX);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Extrusion.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Extrusion.php
new file mode 100644
index 00000000..dd002312
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Extrusion.php
@@ -0,0 +1,108 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get type.
+ *
+ * @return string
+ */
+ public function getType()
+ {
+ return $this->type;
+ }
+
+ /**
+ * Set pattern.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setType($value = null)
+ {
+ $enum = [self::EXTRUSION_PARALLEL, self::EXTRUSION_PERSPECTIVE];
+ $this->type = $this->setEnumVal($value, $enum, null);
+
+ return $this;
+ }
+
+ /**
+ * Get color.
+ *
+ * @return string
+ */
+ public function getColor()
+ {
+ return $this->color;
+ }
+
+ /**
+ * Set color.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setColor($value = null)
+ {
+ $this->color = $value;
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Fill.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Fill.php
new file mode 100644
index 00000000..af0149d0
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Fill.php
@@ -0,0 +1,70 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get color.
+ *
+ * @return string
+ */
+ public function getColor()
+ {
+ return $this->color;
+ }
+
+ /**
+ * Set color.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setColor($value = null)
+ {
+ $this->color = $value;
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Font.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Font.php
new file mode 100644
index 00000000..a4580bc8
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Font.php
@@ -0,0 +1,998 @@
+ 'lineHeight', 'letter-spacing' => 'spacing'];
+
+ /**
+ * Font style type.
+ *
+ * @var string
+ */
+ private $type;
+
+ /**
+ * Font name.
+ *
+ * @var string
+ */
+ private $name;
+
+ /**
+ * Font Content Type.
+ *
+ * @var string
+ */
+ private $hint;
+
+ /**
+ * Font size.
+ *
+ * @var float|int
+ */
+ private $size;
+
+ /**
+ * Font color.
+ *
+ * @var string
+ */
+ private $color;
+
+ /**
+ * Bold.
+ *
+ * @var bool
+ */
+ private $bold;
+
+ /**
+ * Italic.
+ *
+ * @var bool
+ */
+ private $italic;
+
+ /**
+ * Undeline.
+ *
+ * @var string
+ */
+ private $underline = self::UNDERLINE_NONE;
+
+ /**
+ * Superscript.
+ *
+ * @var bool
+ */
+ private $superScript = false;
+
+ /**
+ * Subscript.
+ *
+ * @var bool
+ */
+ private $subScript = false;
+
+ /**
+ * Strikethrough.
+ *
+ * @var bool
+ */
+ private $strikethrough;
+
+ /**
+ * Double strikethrough.
+ *
+ * @var bool
+ */
+ private $doubleStrikethrough;
+
+ /**
+ * Small caps.
+ *
+ * @var bool
+ *
+ * @see http://www.schemacentral.com/sc/ooxml/e-w_smallCaps-1.html
+ */
+ private $smallCaps;
+
+ /**
+ * All caps.
+ *
+ * @var bool
+ *
+ * @see http://www.schemacentral.com/sc/ooxml/e-w_caps-1.html
+ */
+ private $allCaps;
+
+ /**
+ * Foreground/highlight.
+ *
+ * @var string
+ */
+ private $fgColor;
+
+ /**
+ * Expanded/compressed text: 0-600 (percent).
+ *
+ * @var int
+ *
+ * @since 0.12.0
+ * @see http://www.schemacentral.com/sc/ooxml/e-w_w-1.html
+ */
+ private $scale;
+
+ /**
+ * Character spacing adjustment: twip.
+ *
+ * @var float|int
+ *
+ * @since 0.12.0
+ * @see http://www.schemacentral.com/sc/ooxml/e-w_spacing-2.html
+ */
+ private $spacing;
+
+ /**
+ * Font kerning: halfpoint.
+ *
+ * @var float|int
+ *
+ * @since 0.12.0
+ * @see http://www.schemacentral.com/sc/ooxml/e-w_kern-1.html
+ */
+ private $kerning;
+
+ /**
+ * Paragraph style.
+ *
+ * @var \PhpOffice\PhpWord\Style\Paragraph
+ */
+ private $paragraph;
+
+ /**
+ * Shading.
+ *
+ * @var \PhpOffice\PhpWord\Style\Shading
+ */
+ private $shading;
+
+ /**
+ * Right to left languages.
+ *
+ * @var ?bool
+ */
+ private $rtl;
+
+ /**
+ * noProof (disables AutoCorrect).
+ *
+ * @var bool
+ * http://www.datypic.com/sc/ooxml/e-w_noProof-1.html
+ */
+ private $noProof;
+
+ /**
+ * Languages.
+ *
+ * @var null|\PhpOffice\PhpWord\Style\Language
+ */
+ private $lang;
+
+ /**
+ * Hidden text.
+ *
+ * @var bool
+ *
+ * @see http://www.datypic.com/sc/ooxml/e-w_vanish-1.html
+ */
+ private $hidden;
+
+ /**
+ * Vertically Raised or Lowered Text.
+ *
+ * @var int Signed Half-Point Measurement
+ *
+ * @see http://www.datypic.com/sc/ooxml/e-w_position-1.html
+ */
+ private $position;
+
+ /**
+ * Preservation of white space in html.
+ *
+ * @var string Value used for css white-space
+ */
+ private $whiteSpace = '';
+
+ /**
+ * Generic font as fallback for html.
+ *
+ * @var string generic font name
+ */
+ private $fallbackFont = '';
+
+ /**
+ * Create new font style.
+ *
+ * @param string $type Type of font
+ * @param array|\PhpOffice\PhpWord\Style\AbstractStyle|string $paragraph Paragraph styles definition
+ */
+ public function __construct($type = 'text', $paragraph = null)
+ {
+ $this->type = $type;
+ $this->setParagraph($paragraph);
+ }
+
+ /**
+ * Get style values.
+ *
+ * @return array
+ *
+ * @since 0.12.0
+ */
+ public function getStyleValues()
+ {
+ return [
+ 'name' => $this->getStyleName(),
+ 'basic' => [
+ 'name' => $this->getName(),
+ 'size' => $this->getSize(),
+ 'color' => $this->getColor(),
+ 'hint' => $this->getHint(),
+ ],
+ 'style' => [
+ 'bold' => $this->isBold(),
+ 'italic' => $this->isItalic(),
+ 'underline' => $this->getUnderline(),
+ 'strike' => $this->isStrikethrough(),
+ 'dStrike' => $this->isDoubleStrikethrough(),
+ 'super' => $this->isSuperScript(),
+ 'sub' => $this->isSubScript(),
+ 'smallCaps' => $this->isSmallCaps(),
+ 'allCaps' => $this->isAllCaps(),
+ 'fgColor' => $this->getFgColor(),
+ 'hidden' => $this->isHidden(),
+ ],
+ 'spacing' => [
+ 'scale' => $this->getScale(),
+ 'spacing' => $this->getSpacing(),
+ 'kerning' => $this->getKerning(),
+ 'position' => $this->getPosition(),
+ ],
+ 'paragraph' => $this->getParagraph(),
+ 'rtl' => $this->isRTL(),
+ 'shading' => $this->getShading(),
+ 'lang' => $this->getLang(),
+ 'whiteSpace' => $this->getWhiteSpace(),
+ 'fallbackFont' => $this->getFallbackFont(),
+ ];
+ }
+
+ /**
+ * Get style type.
+ *
+ * @return string
+ */
+ public function getStyleType()
+ {
+ return $this->type;
+ }
+
+ /**
+ * Get font name.
+ *
+ * @return string
+ */
+ public function getName()
+ {
+ return $this->name;
+ }
+
+ /**
+ * Set font name.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setName($value = null)
+ {
+ $this->name = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get Font Content Type.
+ *
+ * @return string
+ */
+ public function getHint()
+ {
+ return $this->hint;
+ }
+
+ /**
+ * Set Font Content Type.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setHint($value = null)
+ {
+ $this->hint = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get font size.
+ *
+ * @return float|int
+ */
+ public function getSize()
+ {
+ return $this->size;
+ }
+
+ /**
+ * Set font size.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setSize($value = null)
+ {
+ $this->size = $this->setNumericVal($value, $this->size);
+
+ return $this;
+ }
+
+ /**
+ * Get font color.
+ *
+ * @return string
+ */
+ public function getColor()
+ {
+ return $this->color;
+ }
+
+ /**
+ * Set font color.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setColor($value = null)
+ {
+ $this->color = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get bold.
+ *
+ * @return bool
+ */
+ public function isBold()
+ {
+ return $this->bold;
+ }
+
+ /**
+ * Set bold.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setBold($value = true)
+ {
+ $this->bold = $this->setBoolVal($value, $this->bold);
+
+ return $this;
+ }
+
+ /**
+ * Get italic.
+ *
+ * @return bool
+ */
+ public function isItalic()
+ {
+ return $this->italic;
+ }
+
+ /**
+ * Set italic.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setItalic($value = true)
+ {
+ $this->italic = $this->setBoolVal($value, $this->italic);
+
+ return $this;
+ }
+
+ /**
+ * Get underline.
+ *
+ * @return string
+ */
+ public function getUnderline()
+ {
+ return $this->underline;
+ }
+
+ /**
+ * Set underline.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setUnderline($value = self::UNDERLINE_NONE)
+ {
+ $this->underline = $this->setNonEmptyVal($value, self::UNDERLINE_NONE);
+
+ return $this;
+ }
+
+ /**
+ * Get superscript.
+ *
+ * @return bool
+ */
+ public function isSuperScript()
+ {
+ return $this->superScript;
+ }
+
+ /**
+ * Set superscript.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setSuperScript($value = true)
+ {
+ return $this->setPairedVal($this->superScript, $this->subScript, $value);
+ }
+
+ /**
+ * Get subscript.
+ *
+ * @return bool
+ */
+ public function isSubScript()
+ {
+ return $this->subScript;
+ }
+
+ /**
+ * Set subscript.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setSubScript($value = true)
+ {
+ return $this->setPairedVal($this->subScript, $this->superScript, $value);
+ }
+
+ /**
+ * Get strikethrough.
+ */
+ public function isStrikethrough(): ?bool
+ {
+ return $this->strikethrough;
+ }
+
+ /**
+ * Set strikethrough.
+ *
+ * @param bool $value
+ */
+ public function setStrikethrough($value = true): self
+ {
+ return $this->setPairedVal($this->strikethrough, $this->doubleStrikethrough, $value);
+ }
+
+ /**
+ * Get double strikethrough.
+ */
+ public function isDoubleStrikethrough(): ?bool
+ {
+ return $this->doubleStrikethrough;
+ }
+
+ /**
+ * Set double strikethrough.
+ *
+ * @param bool $value
+ */
+ public function setDoubleStrikethrough($value = true): self
+ {
+ return $this->setPairedVal($this->doubleStrikethrough, $this->strikethrough, $value);
+ }
+
+ /**
+ * Get small caps.
+ *
+ * @return bool
+ */
+ public function isSmallCaps()
+ {
+ return $this->smallCaps;
+ }
+
+ /**
+ * Set small caps.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setSmallCaps($value = true)
+ {
+ return $this->setPairedVal($this->smallCaps, $this->allCaps, $value);
+ }
+
+ /**
+ * Get all caps.
+ *
+ * @return bool
+ */
+ public function isAllCaps()
+ {
+ return $this->allCaps;
+ }
+
+ /**
+ * Set all caps.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setAllCaps($value = true)
+ {
+ return $this->setPairedVal($this->allCaps, $this->smallCaps, $value);
+ }
+
+ /**
+ * Get foreground/highlight color.
+ *
+ * @return string
+ */
+ public function getFgColor()
+ {
+ return $this->fgColor;
+ }
+
+ /**
+ * Set foreground/highlight color.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setFgColor($value = null)
+ {
+ $this->fgColor = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get background.
+ *
+ * @return string
+ */
+ public function getBgColor()
+ {
+ return $this->getChildStyleValue($this->shading, 'fill');
+ }
+
+ /**
+ * Set background.
+ *
+ * @param string $value
+ *
+ * @return \PhpOffice\PhpWord\Style\Table
+ */
+ public function setBgColor($value = null)
+ {
+ $this->setShading(['fill' => $value]);
+ }
+
+ /**
+ * Get scale.
+ *
+ * @return int
+ */
+ public function getScale()
+ {
+ return $this->scale;
+ }
+
+ /**
+ * Set scale.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setScale($value = null)
+ {
+ $this->scale = $this->setIntVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get font spacing.
+ *
+ * @return float|int
+ */
+ public function getSpacing()
+ {
+ return $this->spacing;
+ }
+
+ /**
+ * Set font spacing.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setSpacing($value = null)
+ {
+ $this->spacing = $this->setNumericVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get font kerning.
+ *
+ * @return float|int
+ */
+ public function getKerning()
+ {
+ return $this->kerning;
+ }
+
+ /**
+ * Set font kerning.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setKerning($value = null)
+ {
+ $this->kerning = $this->setNumericVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get noProof (disables autocorrect).
+ *
+ * @return bool
+ */
+ public function isNoProof()
+ {
+ return $this->noProof;
+ }
+
+ /**
+ * Set noProof (disables autocorrect).
+ *
+ * @param bool $value
+ *
+ * @return $this
+ */
+ public function setNoProof($value = false)
+ {
+ $this->noProof = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get line height.
+ *
+ * @return float|int
+ */
+ public function getLineHeight()
+ {
+ return $this->getParagraph()->getLineHeight();
+ }
+
+ /**
+ * Set lineheight.
+ *
+ * @param float|int|string $value
+ *
+ * @return self
+ */
+ public function setLineHeight($value)
+ {
+ $this->setParagraph(['lineHeight' => $value]);
+
+ return $this;
+ }
+
+ /**
+ * Get paragraph style.
+ *
+ * @return \PhpOffice\PhpWord\Style\Paragraph
+ */
+ public function getParagraph()
+ {
+ return $this->paragraph;
+ }
+
+ /**
+ * Set Paragraph.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setParagraph($value = null)
+ {
+ $this->setObjectVal($value, 'Paragraph', $this->paragraph);
+
+ return $this;
+ }
+
+ /**
+ * Get rtl.
+ *
+ * @return ?bool
+ */
+ public function isRTL()
+ {
+ return $this->rtl ?? Settings::isDefaultRtl();
+ }
+
+ /**
+ * Set rtl.
+ *
+ * @param ?bool $value
+ *
+ * @return self
+ */
+ public function setRTL($value = true)
+ {
+ $this->rtl = $this->setBoolVal($value, $this->rtl);
+
+ return $this;
+ }
+
+ /**
+ * Get shading.
+ *
+ * @return \PhpOffice\PhpWord\Style\Shading
+ */
+ public function getShading()
+ {
+ return $this->shading;
+ }
+
+ /**
+ * Set shading.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setShading($value = null)
+ {
+ $this->setObjectVal($value, 'Shading', $this->shading);
+
+ return $this;
+ }
+
+ /**
+ * Get language.
+ *
+ * @return null|\PhpOffice\PhpWord\Style\Language
+ */
+ public function getLang()
+ {
+ return $this->lang;
+ }
+
+ /**
+ * Set language.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setLang($value = null)
+ {
+ if (is_string($value) && $value != '') {
+ $value = new Language($value);
+ }
+ $this->setObjectVal($value, 'Language', $this->lang);
+
+ return $this;
+ }
+
+ /**
+ * Get hidden text.
+ *
+ * @return bool
+ */
+ public function isHidden()
+ {
+ return $this->hidden;
+ }
+
+ /**
+ * Set hidden text.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setHidden($value = true)
+ {
+ $this->hidden = $this->setBoolVal($value, $this->hidden);
+
+ return $this;
+ }
+
+ /**
+ * Get position.
+ *
+ * @return int
+ */
+ public function getPosition()
+ {
+ return $this->position;
+ }
+
+ /**
+ * Set position.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setPosition($value = null)
+ {
+ $this->position = $this->setIntVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Set html css white-space value. It is expected that only pre-wrap and normal (default) are useful.
+ *
+ * @param null|string $value Should be one of pre-wrap, normal, nowrap, pre, pre-line, initial, inherit
+ */
+ public function setWhiteSpace(?string $value): self
+ {
+ $this->whiteSpace = Validate::validateCSSWhiteSpace($value);
+
+ return $this;
+ }
+
+ /**
+ * Get html css white-space value.
+ */
+ public function getWhiteSpace(): string
+ {
+ return $this->whiteSpace;
+ }
+
+ /**
+ * Set generic font for fallback for html.
+ *
+ * @param string $value generic font name
+ */
+ public function setFallbackFont(?string $value): self
+ {
+ $this->fallbackFont = Validate::validateCSSGenericFont($value);
+
+ return $this;
+ }
+
+ /**
+ * Get html fallback generic font.
+ */
+ public function getFallbackFont(): string
+ {
+ return $this->fallbackFont;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Frame.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Frame.php
new file mode 100644
index 00000000..45fc583e
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Frame.php
@@ -0,0 +1,684 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * @since 0.13.0
+ *
+ * @return string
+ */
+ public function getAlignment()
+ {
+ return $this->alignment;
+ }
+
+ /**
+ * @since 0.13.0
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setAlignment($value)
+ {
+ if (Jc::isValid($value)) {
+ $this->alignment = $value;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get unit.
+ *
+ * @return string
+ */
+ public function getUnit()
+ {
+ return $this->unit;
+ }
+
+ /**
+ * Set unit.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setUnit($value)
+ {
+ $this->unit = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get width.
+ *
+ * @return float|int
+ */
+ public function getWidth()
+ {
+ return $this->width;
+ }
+
+ /**
+ * Set width.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setWidth($value = null)
+ {
+ $this->width = $this->setNumericVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get height.
+ *
+ * @return float|int
+ */
+ public function getHeight()
+ {
+ return $this->height;
+ }
+
+ /**
+ * Set height.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setHeight($value = null)
+ {
+ $this->height = $this->setNumericVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get left.
+ *
+ * @return float|int
+ */
+ public function getLeft()
+ {
+ return $this->left;
+ }
+
+ /**
+ * Set left.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setLeft($value = 0)
+ {
+ $this->left = $this->setNumericVal($value, 0);
+
+ return $this;
+ }
+
+ /**
+ * Get topmost position.
+ *
+ * @return float|int
+ */
+ public function getTop()
+ {
+ return $this->top;
+ }
+
+ /**
+ * Set topmost position.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setTop($value = 0)
+ {
+ $this->top = $this->setNumericVal($value, 0);
+
+ return $this;
+ }
+
+ /**
+ * Get position type.
+ *
+ * @return string
+ */
+ public function getPos()
+ {
+ return $this->pos;
+ }
+
+ /**
+ * Set position type.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setPos($value)
+ {
+ $enum = [
+ self::POS_ABSOLUTE,
+ self::POS_RELATIVE,
+ ];
+ $this->pos = $this->setEnumVal($value, $enum, $this->pos);
+
+ return $this;
+ }
+
+ /**
+ * Get horizontal position.
+ *
+ * @return string
+ */
+ public function getHPos()
+ {
+ return $this->hPos;
+ }
+
+ /**
+ * Set horizontal position.
+ *
+ * @since 0.12.0 "absolute" option is available.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setHPos($value)
+ {
+ $enum = [
+ self::POS_ABSOLUTE,
+ self::POS_LEFT,
+ self::POS_CENTER,
+ self::POS_RIGHT,
+ self::POS_INSIDE,
+ self::POS_OUTSIDE,
+ ];
+ $this->hPos = $this->setEnumVal($value, $enum, $this->hPos);
+
+ return $this;
+ }
+
+ /**
+ * Get vertical position.
+ *
+ * @return string
+ */
+ public function getVPos()
+ {
+ return $this->vPos;
+ }
+
+ /**
+ * Set vertical position.
+ *
+ * @since 0.12.0 "absolute" option is available.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setVPos($value)
+ {
+ $enum = [
+ self::POS_ABSOLUTE,
+ self::POS_TOP,
+ self::POS_CENTER,
+ self::POS_BOTTOM,
+ self::POS_INSIDE,
+ self::POS_OUTSIDE,
+ ];
+ $this->vPos = $this->setEnumVal($value, $enum, $this->vPos);
+
+ return $this;
+ }
+
+ /**
+ * Get horizontal position relative to.
+ *
+ * @return string
+ */
+ public function getHPosRelTo()
+ {
+ return $this->hPosRelTo;
+ }
+
+ /**
+ * Set horizontal position relative to.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setHPosRelTo($value)
+ {
+ $enum = [
+ self::POS_RELTO_MARGIN,
+ self::POS_RELTO_PAGE,
+ self::POS_RELTO_COLUMN,
+ self::POS_RELTO_CHAR,
+ self::POS_RELTO_LMARGIN,
+ self::POS_RELTO_RMARGIN,
+ self::POS_RELTO_IMARGIN,
+ self::POS_RELTO_OMARGIN,
+ ];
+ $this->hPosRelTo = $this->setEnumVal($value, $enum, $this->hPosRelTo);
+
+ return $this;
+ }
+
+ /**
+ * Get vertical position relative to.
+ *
+ * @return string
+ */
+ public function getVPosRelTo()
+ {
+ return $this->vPosRelTo;
+ }
+
+ /**
+ * Set vertical position relative to.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setVPosRelTo($value)
+ {
+ $enum = [
+ self::POS_RELTO_MARGIN,
+ self::POS_RELTO_PAGE,
+ self::POS_RELTO_TEXT,
+ self::POS_RELTO_LINE,
+ self::POS_RELTO_TMARGIN,
+ self::POS_RELTO_BMARGIN,
+ self::POS_RELTO_IMARGIN,
+ self::POS_RELTO_OMARGIN,
+ ];
+ $this->vPosRelTo = $this->setEnumVal($value, $enum, $this->vPosRelTo);
+
+ return $this;
+ }
+
+ /**
+ * Get wrap type.
+ *
+ * @return string
+ */
+ public function getWrap()
+ {
+ return $this->wrap;
+ }
+
+ /**
+ * Set wrap type.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setWrap($value)
+ {
+ $enum = [
+ self::WRAP_INLINE,
+ self::WRAP_SQUARE,
+ self::WRAP_TIGHT,
+ self::WRAP_THROUGH,
+ self::WRAP_TOPBOTTOM,
+ self::WRAP_BEHIND,
+ self::WRAP_INFRONT,
+ ];
+ $this->wrap = $this->setEnumVal($value, $enum, $this->wrap);
+
+ return $this;
+ }
+
+ /**
+ * Get top distance from text wrap.
+ *
+ * @return float
+ */
+ public function getWrapDistanceTop()
+ {
+ return $this->wrapDistanceTop;
+ }
+
+ /**
+ * Set top distance from text wrap.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setWrapDistanceTop($value = null)
+ {
+ $this->wrapDistanceTop = $this->setFloatVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get bottom distance from text wrap.
+ *
+ * @return float
+ */
+ public function getWrapDistanceBottom()
+ {
+ return $this->wrapDistanceBottom;
+ }
+
+ /**
+ * Set bottom distance from text wrap.
+ *
+ * @param float $value
+ *
+ * @return self
+ */
+ public function setWrapDistanceBottom($value = null)
+ {
+ $this->wrapDistanceBottom = $this->setFloatVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get left distance from text wrap.
+ *
+ * @return float
+ */
+ public function getWrapDistanceLeft()
+ {
+ return $this->wrapDistanceLeft;
+ }
+
+ /**
+ * Set left distance from text wrap.
+ *
+ * @param float $value
+ *
+ * @return self
+ */
+ public function setWrapDistanceLeft($value = null)
+ {
+ $this->wrapDistanceLeft = $this->setFloatVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get right distance from text wrap.
+ *
+ * @return float
+ */
+ public function getWrapDistanceRight()
+ {
+ return $this->wrapDistanceRight;
+ }
+
+ /**
+ * Set right distance from text wrap.
+ *
+ * @param float $value
+ *
+ * @return self
+ */
+ public function setWrapDistanceRight($value = null)
+ {
+ $this->wrapDistanceRight = $this->setFloatVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get position.
+ *
+ * @return int
+ */
+ public function getPosition()
+ {
+ return $this->position;
+ }
+
+ /**
+ * Set position.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setPosition($value = null)
+ {
+ $this->position = $this->setIntVal($value, null);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Image.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Image.php
new file mode 100644
index 00000000..dbb8572f
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Image.php
@@ -0,0 +1,270 @@
+setUnit(self::UNIT_PT);
+
+ // Backward compatibility setting
+ // @todo Remove on 1.0.0
+ $this->setWrap(self::WRAPPING_STYLE_INLINE);
+ $this->setHPos(self::POSITION_HORIZONTAL_LEFT);
+ $this->setHPosRelTo(self::POSITION_RELATIVE_TO_CHAR);
+ $this->setVPos(self::POSITION_VERTICAL_TOP);
+ $this->setVPosRelTo(self::POSITION_RELATIVE_TO_LINE);
+ }
+
+ /**
+ * Get margin top.
+ *
+ * @return float|int
+ */
+ public function getMarginTop()
+ {
+ return $this->getTop();
+ }
+
+ /**
+ * Set margin top.
+ *
+ * @ignoreScrutinizerPatch
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setMarginTop($value = 0)
+ {
+ $this->setTop($value);
+
+ return $this;
+ }
+
+ /**
+ * Get margin left.
+ *
+ * @return float|int
+ */
+ public function getMarginLeft()
+ {
+ return $this->getLeft();
+ }
+
+ /**
+ * Set margin left.
+ *
+ * @ignoreScrutinizerPatch
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setMarginLeft($value = 0)
+ {
+ $this->setLeft($value);
+
+ return $this;
+ }
+
+ /**
+ * Get wrapping style.
+ *
+ * @return string
+ */
+ public function getWrappingStyle()
+ {
+ return $this->getWrap();
+ }
+
+ /**
+ * Set wrapping style.
+ *
+ * @param string $wrappingStyle
+ *
+ * @return self
+ */
+ public function setWrappingStyle($wrappingStyle)
+ {
+ $this->setWrap($wrappingStyle);
+
+ return $this;
+ }
+
+ /**
+ * Get positioning type.
+ *
+ * @return string
+ */
+ public function getPositioning()
+ {
+ return $this->getPos();
+ }
+
+ /**
+ * Set positioning type.
+ *
+ * @param string $positioning
+ *
+ * @return self
+ */
+ public function setPositioning($positioning)
+ {
+ $this->setPos($positioning);
+
+ return $this;
+ }
+
+ /**
+ * Get horizontal alignment.
+ *
+ * @return string
+ */
+ public function getPosHorizontal()
+ {
+ return $this->getHPos();
+ }
+
+ /**
+ * Set horizontal alignment.
+ *
+ * @param string $alignment
+ *
+ * @return self
+ */
+ public function setPosHorizontal($alignment)
+ {
+ $this->setHPos($alignment);
+
+ return $this;
+ }
+
+ /**
+ * Get vertical alignment.
+ *
+ * @return string
+ */
+ public function getPosVertical()
+ {
+ return $this->getVPos();
+ }
+
+ /**
+ * Set vertical alignment.
+ *
+ * @param string $alignment
+ *
+ * @return self
+ */
+ public function setPosVertical($alignment)
+ {
+ $this->setVPos($alignment);
+
+ return $this;
+ }
+
+ /**
+ * Get horizontal relation.
+ *
+ * @return string
+ */
+ public function getPosHorizontalRel()
+ {
+ return $this->getHPosRelTo();
+ }
+
+ /**
+ * Set horizontal relation.
+ *
+ * @param string $relto
+ *
+ * @return self
+ */
+ public function setPosHorizontalRel($relto)
+ {
+ $this->setHPosRelTo($relto);
+
+ return $this;
+ }
+
+ /**
+ * Get vertical relation.
+ *
+ * @return string
+ */
+ public function getPosVerticalRel()
+ {
+ return $this->getVPosRelTo();
+ }
+
+ /**
+ * Set vertical relation.
+ *
+ * @param string $relto
+ *
+ * @return self
+ */
+ public function setPosVerticalRel($relto)
+ {
+ $this->setVPosRelTo($relto);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Indentation.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Indentation.php
new file mode 100644
index 00000000..42c6e118
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Indentation.php
@@ -0,0 +1,161 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get left.
+ *
+ * @return float|int
+ */
+ public function getLeft()
+ {
+ return $this->left;
+ }
+
+ /**
+ * Set left.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setLeft($value)
+ {
+ $this->left = $this->setNumericVal($value, $this->left);
+
+ return $this;
+ }
+
+ /**
+ * Get right.
+ *
+ * @return float|int
+ */
+ public function getRight()
+ {
+ return $this->right;
+ }
+
+ /**
+ * Set right.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setRight($value)
+ {
+ $this->right = $this->setNumericVal($value, $this->right);
+
+ return $this;
+ }
+
+ /**
+ * Get first line.
+ *
+ * @return float|int
+ */
+ public function getFirstLine()
+ {
+ return $this->firstLine;
+ }
+
+ /**
+ * Set first line.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setFirstLine($value)
+ {
+ $this->firstLine = $this->setNumericVal($value, $this->firstLine);
+
+ return $this;
+ }
+
+ /**
+ * Get hanging.
+ *
+ * @return float|int
+ */
+ public function getHanging()
+ {
+ return $this->hanging;
+ }
+
+ /**
+ * Set hanging.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setHanging($value = null)
+ {
+ $this->hanging = $this->setNumericVal($value, $this->hanging);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Language.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Language.php
new file mode 100644
index 00000000..18e7f76e
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Language.php
@@ -0,0 +1,268 @@
+setLatin($latin);
+ }
+ if (!empty($eastAsia)) {
+ $this->setEastAsia($eastAsia);
+ }
+ if (!empty($bidirectional)) {
+ $this->setBidirectional($bidirectional);
+ }
+ }
+
+ /**
+ * Set the Latin Language.
+ *
+ * @param string $latin
+ * The value for the latin language
+ *
+ * @return self
+ */
+ public function setLatin($latin)
+ {
+ $this->latin = $this->validateLocale($latin);
+
+ return $this;
+ }
+
+ /**
+ * Get the Latin Language.
+ *
+ * @return null|string
+ */
+ public function getLatin()
+ {
+ return $this->latin;
+ }
+
+ /**
+ * Set the Language ID.
+ *
+ * @param int $langId
+ * The value for the language ID
+ *
+ * @return self
+ *
+ * @see https://technet.microsoft.com/en-us/library/cc287874(v=office.12).aspx
+ */
+ public function setLangId($langId)
+ {
+ $this->langId = $langId;
+
+ return $this;
+ }
+
+ /**
+ * Get the Language ID.
+ *
+ * @return int
+ */
+ public function getLangId()
+ {
+ return $this->langId;
+ }
+
+ /**
+ * Set the East Asian Language.
+ *
+ * @param string $eastAsia
+ * The value for the east asian language
+ *
+ * @return self
+ */
+ public function setEastAsia($eastAsia)
+ {
+ $this->eastAsia = $this->validateLocale($eastAsia);
+
+ return $this;
+ }
+
+ /**
+ * Get the East Asian Language.
+ *
+ * @return null|string
+ */
+ public function getEastAsia()
+ {
+ return $this->eastAsia;
+ }
+
+ /**
+ * Set the Complex Script Language.
+ *
+ * @param string $bidirectional
+ * The value for the complex script language
+ *
+ * @return self
+ */
+ public function setBidirectional($bidirectional)
+ {
+ $this->bidirectional = $this->validateLocale($bidirectional);
+
+ return $this;
+ }
+
+ /**
+ * Get the Complex Script Language.
+ *
+ * @return null|string
+ */
+ public function getBidirectional()
+ {
+ return $this->bidirectional;
+ }
+
+ /**
+ * Validates that the language passed is in the format xx-xx.
+ *
+ * @param string $locale
+ *
+ * @return string
+ */
+ private function validateLocale($locale)
+ {
+ if ($locale !== null) {
+ $locale = str_replace('_', '-', $locale);
+ }
+
+ if ($locale !== null && strlen($locale) === 2) {
+ return strtolower($locale) . '-' . strtoupper($locale);
+ }
+ if ($locale === 'und') {
+ return 'en-EN';
+ }
+ if ($locale !== null && $locale !== 'zxx' && strstr($locale, '-') === false) {
+ throw new InvalidArgumentException($locale . ' is not a valid language code');
+ }
+
+ return $locale;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Line.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Line.php
new file mode 100644
index 00000000..2aeefa5a
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Line.php
@@ -0,0 +1,288 @@
+flip;
+ }
+
+ /**
+ * Set flip.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setFlip($value = false)
+ {
+ $this->flip = $this->setBoolVal($value, $this->flip);
+
+ return $this;
+ }
+
+ /**
+ * Get connectorType.
+ *
+ * @return string
+ */
+ public function getConnectorType()
+ {
+ return $this->connectorType;
+ }
+
+ /**
+ * Set connectorType.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setConnectorType($value = null)
+ {
+ $enum = [
+ self::CONNECTOR_TYPE_STRAIGHT,
+ ];
+ $this->connectorType = $this->setEnumVal($value, $enum, $this->connectorType);
+
+ return $this;
+ }
+
+ /**
+ * Get weight.
+ *
+ * @return int
+ */
+ public function getWeight()
+ {
+ return $this->weight;
+ }
+
+ /**
+ * Set weight.
+ *
+ * @param int $value Weight in points
+ *
+ * @return self
+ */
+ public function setWeight($value = null)
+ {
+ $this->weight = $this->setNumericVal($value, $this->weight);
+
+ return $this;
+ }
+
+ /**
+ * Get color.
+ *
+ * @return string
+ */
+ public function getColor()
+ {
+ return $this->color;
+ }
+
+ /**
+ * Set color.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setColor($value = null)
+ {
+ $this->color = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get beginArrow.
+ *
+ * @return string
+ */
+ public function getBeginArrow()
+ {
+ return $this->beginArrow;
+ }
+
+ /**
+ * Set beginArrow.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBeginArrow($value = null)
+ {
+ $enum = [
+ self::ARROW_STYLE_BLOCK, self::ARROW_STYLE_CLASSIC, self::ARROW_STYLE_DIAMOND,
+ self::ARROW_STYLE_OPEN, self::ARROW_STYLE_OVAL,
+ ];
+ $this->beginArrow = $this->setEnumVal($value, $enum, $this->beginArrow);
+
+ return $this;
+ }
+
+ /**
+ * Get endArrow.
+ *
+ * @return string
+ */
+ public function getEndArrow()
+ {
+ return $this->endArrow;
+ }
+
+ /**
+ * Set endArrow.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setEndArrow($value = null)
+ {
+ $enum = [
+ self::ARROW_STYLE_BLOCK, self::ARROW_STYLE_CLASSIC, self::ARROW_STYLE_DIAMOND,
+ self::ARROW_STYLE_OPEN, self::ARROW_STYLE_OVAL,
+ ];
+ $this->endArrow = $this->setEnumVal($value, $enum, $this->endArrow);
+
+ return $this;
+ }
+
+ /**
+ * Get Dash.
+ *
+ * @return string
+ */
+ public function getDash()
+ {
+ return $this->dash;
+ }
+
+ /**
+ * Set Dash.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setDash($value = null)
+ {
+ $enum = [
+ self::DASH_STYLE_DASH, self::DASH_STYLE_DASH_DOT, self::DASH_STYLE_LONG_DASH,
+ self::DASH_STYLE_LONG_DASH_DOT, self::DASH_STYLE_LONG_DASH_DOT_DOT, self::DASH_STYLE_ROUND_DOT,
+ self::DASH_STYLE_SQUARE_DOT,
+ ];
+ $this->dash = $this->setEnumVal($value, $enum, $this->dash);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/LineNumbering.php b/vendor/phpoffice/phpword/src/PhpWord/Style/LineNumbering.php
new file mode 100644
index 00000000..61a98dc8
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/LineNumbering.php
@@ -0,0 +1,169 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get start.
+ *
+ * @return int
+ */
+ public function getStart()
+ {
+ return $this->start;
+ }
+
+ /**
+ * Set start.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setStart($value = null)
+ {
+ $this->start = $this->setIntVal($value, $this->start);
+
+ return $this;
+ }
+
+ /**
+ * Get increment.
+ *
+ * @return int
+ */
+ public function getIncrement()
+ {
+ return $this->increment;
+ }
+
+ /**
+ * Set increment.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setIncrement($value = null)
+ {
+ $this->increment = $this->setIntVal($value, $this->increment);
+
+ return $this;
+ }
+
+ /**
+ * Get distance.
+ *
+ * @return float|int
+ */
+ public function getDistance()
+ {
+ return $this->distance;
+ }
+
+ /**
+ * Set distance.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setDistance($value = null)
+ {
+ $this->distance = $this->setNumericVal($value, $this->distance);
+
+ return $this;
+ }
+
+ /**
+ * Get restart.
+ *
+ * @return string
+ */
+ public function getRestart()
+ {
+ return $this->restart;
+ }
+
+ /**
+ * Set distance.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setRestart($value = null)
+ {
+ $enum = [self::LINE_NUMBERING_CONTINUOUS, self::LINE_NUMBERING_NEW_PAGE, self::LINE_NUMBERING_NEW_SECTION];
+ $this->restart = $this->setEnumVal($value, $enum, $this->restart);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/ListItem.php b/vendor/phpoffice/phpword/src/PhpWord/Style/ListItem.php
new file mode 100644
index 00000000..28d3fb1b
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/ListItem.php
@@ -0,0 +1,286 @@
+setNumStyle($numStyle);
+ } else {
+ $this->setListType();
+ }
+ }
+
+ /**
+ * Get List Type.
+ *
+ * @return int
+ */
+ public function getListType()
+ {
+ return $this->listType;
+ }
+
+ /**
+ * Set legacy list type for version < 0.10.0.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setListType($value = self::TYPE_BULLET_FILLED)
+ {
+ $enum = [
+ self::TYPE_SQUARE_FILLED, self::TYPE_BULLET_FILLED,
+ self::TYPE_BULLET_EMPTY, self::TYPE_NUMBER,
+ self::TYPE_NUMBER_NESTED, self::TYPE_ALPHANUM,
+ ];
+ $this->listType = $this->setEnumVal($value, $enum, $this->listType);
+ $this->getListTypeStyle();
+
+ return $this;
+ }
+
+ /**
+ * Get numbering style name.
+ *
+ * @return string
+ */
+ public function getNumStyle()
+ {
+ return $this->numStyle;
+ }
+
+ /**
+ * Set numbering style name.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setNumStyle($value)
+ {
+ $this->numStyle = $value;
+ $numStyleObject = Style::getStyle($this->numStyle);
+ if ($numStyleObject instanceof Numbering) {
+ $this->numId = $numStyleObject->getIndex();
+ $numStyleObject->setNumId($this->numId);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get numbering Id.
+ *
+ * @return int
+ */
+ public function getNumId()
+ {
+ return $this->numId;
+ }
+
+ /**
+ * Set numbering Id. Same numId means same list.
+ *
+ * @param mixed $numInt
+ */
+ public function setNumId($numInt): void
+ {
+ $this->numId = $numInt;
+ $this->getListTypeStyle();
+ }
+
+ /**
+ * Get legacy numbering definition.
+ *
+ * @return array
+ *
+ * @since 0.10.0
+ */
+ private function getListTypeStyle()
+ {
+ // Check if legacy style already registered in global Style collection
+ $numStyle = 'PHPWordListType' . $this->listType;
+
+ if ($this->numId) {
+ $numStyle .= 'NumId' . $this->numId;
+ }
+
+ if (Style::getStyle($numStyle) !== null) {
+ $this->setNumStyle($numStyle);
+
+ return;
+ }
+
+ // Property mapping for numbering level information
+ $properties = ['start', 'format', 'text', 'alignment', 'tabPos', 'left', 'hanging', 'font', 'hint'];
+
+ // Legacy level information
+ $listTypeStyles = [
+ self::TYPE_SQUARE_FILLED => [
+ 'type' => 'hybridMultilevel',
+ 'levels' => [
+ 0 => '1, bullet, , left, 720, 720, 360, Wingdings, default',
+ 1 => '1, bullet, o, left, 1440, 1440, 360, Courier New, default',
+ 2 => '1, bullet, , left, 2160, 2160, 360, Wingdings, default',
+ 3 => '1, bullet, , left, 2880, 2880, 360, Symbol, default',
+ 4 => '1, bullet, o, left, 3600, 3600, 360, Courier New, default',
+ 5 => '1, bullet, , left, 4320, 4320, 360, Wingdings, default',
+ 6 => '1, bullet, , left, 5040, 5040, 360, Symbol, default',
+ 7 => '1, bullet, o, left, 5760, 5760, 360, Courier New, default',
+ 8 => '1, bullet, , left, 6480, 6480, 360, Wingdings, default',
+ ],
+ ],
+ self::TYPE_BULLET_FILLED => [
+ 'type' => 'hybridMultilevel',
+ 'levels' => [
+ 0 => '1, bullet, , left, 720, 720, 360, Symbol, default',
+ 1 => '1, bullet, o, left, 1440, 1440, 360, Courier New, default',
+ 2 => '1, bullet, , left, 2160, 2160, 360, Wingdings, default',
+ 3 => '1, bullet, , left, 2880, 2880, 360, Symbol, default',
+ 4 => '1, bullet, o, left, 3600, 3600, 360, Courier New, default',
+ 5 => '1, bullet, , left, 4320, 4320, 360, Wingdings, default',
+ 6 => '1, bullet, , left, 5040, 5040, 360, Symbol, default',
+ 7 => '1, bullet, o, left, 5760, 5760, 360, Courier New, default',
+ 8 => '1, bullet, , left, 6480, 6480, 360, Wingdings, default',
+ ],
+ ],
+ self::TYPE_BULLET_EMPTY => [
+ 'type' => 'hybridMultilevel',
+ 'levels' => [
+ 0 => '1, bullet, o, left, 720, 720, 360, Courier New, default',
+ 1 => '1, bullet, o, left, 1440, 1440, 360, Courier New, default',
+ 2 => '1, bullet, , left, 2160, 2160, 360, Wingdings, default',
+ 3 => '1, bullet, , left, 2880, 2880, 360, Symbol, default',
+ 4 => '1, bullet, o, left, 3600, 3600, 360, Courier New, default',
+ 5 => '1, bullet, , left, 4320, 4320, 360, Wingdings, default',
+ 6 => '1, bullet, , left, 5040, 5040, 360, Symbol, default',
+ 7 => '1, bullet, o, left, 5760, 5760, 360, Courier New, default',
+ 8 => '1, bullet, , left, 6480, 6480, 360, Wingdings, default',
+ ],
+ ],
+ self::TYPE_NUMBER => [
+ 'type' => 'hybridMultilevel',
+ 'levels' => [
+ 0 => '1, decimal, %1., left, 720, 720, 360, , default',
+ 1 => '1, bullet, o, left, 1440, 1440, 360, Courier New, default',
+ 2 => '1, bullet, , left, 2160, 2160, 360, Wingdings, default',
+ 3 => '1, bullet, , left, 2880, 2880, 360, Symbol, default',
+ 4 => '1, bullet, o, left, 3600, 3600, 360, Courier New, default',
+ 5 => '1, bullet, , left, 4320, 4320, 360, Wingdings, default',
+ 6 => '1, bullet, , left, 5040, 5040, 360, Symbol, default',
+ 7 => '1, bullet, o, left, 5760, 5760, 360, Courier New, default',
+ 8 => '1, bullet, , left, 6480, 6480, 360, Wingdings, default',
+ ],
+ ],
+ self::TYPE_NUMBER_NESTED => [
+ 'type' => 'multilevel',
+ 'levels' => [
+ 0 => '1, decimal, %1., left, 360, 360, 360, , ',
+ 1 => '1, decimal, %1.%2., left, 792, 792, 432, , ',
+ 2 => '1, decimal, %1.%2.%3., left, 1224, 1224, 504, , ',
+ 3 => '1, decimal, %1.%2.%3.%4., left, 1800, 1728, 648, , ',
+ 4 => '1, decimal, %1.%2.%3.%4.%5., left, 2520, 2232, 792, , ',
+ 5 => '1, decimal, %1.%2.%3.%4.%5.%6., left, 2880, 2736, 936, , ',
+ 6 => '1, decimal, %1.%2.%3.%4.%5.%6.%7., left, 3600, 3240, 1080, , ',
+ 7 => '1, decimal, %1.%2.%3.%4.%5.%6.%7.%8., left, 3960, 3744, 1224, , ',
+ 8 => '1, decimal, %1.%2.%3.%4.%5.%6.%7.%8.%9., left, 4680, 4320, 1440, , ',
+ ],
+ ],
+ self::TYPE_ALPHANUM => [
+ 'type' => 'multilevel',
+ 'levels' => [
+ 0 => '1, decimal, %1., left, 720, 720, 360, , ',
+ 1 => '1, lowerLetter, %2., left, 1440, 1440, 360, , ',
+ 2 => '1, lowerRoman, %3., right, 2160, 2160, 180, , ',
+ 3 => '1, decimal, %4., left, 2880, 2880, 360, , ',
+ 4 => '1, lowerLetter, %5., left, 3600, 3600, 360, , ',
+ 5 => '1, lowerRoman, %6., right, 4320, 4320, 180, , ',
+ 6 => '1, decimal, %7., left, 5040, 5040, 360, , ',
+ 7 => '1, lowerLetter, %8., left, 5760, 5760, 360, , ',
+ 8 => '1, lowerRoman, %9., right, 6480, 6480, 180, , ',
+ ],
+ ],
+ ];
+
+ // Populate style and register to global Style register
+ $style = $listTypeStyles[$this->listType];
+ $numProperties = count($properties);
+ foreach ($style['levels'] as $key => $value) {
+ $level = [];
+ $levelProperties = explode(', ', $value);
+ $level['level'] = $key;
+ for ($i = 0; $i < $numProperties; ++$i) {
+ $property = $properties[$i];
+ $level[$property] = $levelProperties[$i];
+ }
+ $style['levels'][$key] = $level;
+ }
+ Style::addNumberingStyle($numStyle, $style);
+ $this->setNumStyle($numStyle);
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Numbering.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Numbering.php
new file mode 100644
index 00000000..0efb088d
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Numbering.php
@@ -0,0 +1,136 @@
+numId;
+ }
+
+ /**
+ * Set Id.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setNumId($value)
+ {
+ $this->numId = $this->setIntVal($value, $this->numId);
+
+ return $this;
+ }
+
+ /**
+ * Get multilevel type.
+ *
+ * @return string
+ */
+ public function getType()
+ {
+ return $this->type;
+ }
+
+ /**
+ * Set multilevel type.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setType($value)
+ {
+ $enum = ['singleLevel', 'multilevel', 'hybridMultilevel'];
+ $this->type = $this->setEnumVal($value, $enum, $this->type);
+
+ return $this;
+ }
+
+ /**
+ * Get levels.
+ *
+ * @return NumberingLevel[]
+ */
+ public function getLevels()
+ {
+ return $this->levels;
+ }
+
+ /**
+ * Set multilevel type.
+ *
+ * @param array $values
+ *
+ * @return self
+ */
+ public function setLevels($values)
+ {
+ if (is_array($values)) {
+ foreach ($values as $key => $value) {
+ $numberingLevel = new NumberingLevel();
+ if (is_array($value)) {
+ $numberingLevel->setStyleByArray($value);
+ $numberingLevel->setLevel($key);
+ }
+ $this->levels[$key] = $numberingLevel;
+ }
+ }
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/NumberingLevel.php b/vendor/phpoffice/phpword/src/PhpWord/Style/NumberingLevel.php
new file mode 100644
index 00000000..39c0d839
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/NumberingLevel.php
@@ -0,0 +1,451 @@
+level;
+ }
+
+ /**
+ * Set level.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setLevel($value)
+ {
+ $this->level = $this->setIntVal($value, $this->level);
+
+ return $this;
+ }
+
+ /**
+ * Get start.
+ *
+ * @return int
+ */
+ public function getStart()
+ {
+ return $this->start;
+ }
+
+ /**
+ * Set start.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setStart($value)
+ {
+ $this->start = $this->setIntVal($value, $this->start);
+
+ return $this;
+ }
+
+ /**
+ * Get format.
+ *
+ * @return string
+ */
+ public function getFormat()
+ {
+ return $this->format;
+ }
+
+ /**
+ * Set format.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setFormat($value)
+ {
+ $this->format = $this->setEnumVal($value, NumberFormat::values(), $this->format);
+
+ return $this;
+ }
+
+ /**
+ * Get restart.
+ *
+ * @return int
+ */
+ public function getRestart()
+ {
+ return $this->restart;
+ }
+
+ /**
+ * Set restart.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setRestart($value)
+ {
+ $this->restart = $this->setIntVal($value, $this->restart);
+
+ return $this;
+ }
+
+ /**
+ * Get related paragraph style.
+ *
+ * @return string
+ */
+ public function getPStyle()
+ {
+ return $this->pStyle;
+ }
+
+ /**
+ * Set related paragraph style.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setPStyle($value)
+ {
+ $this->pStyle = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get suffix.
+ *
+ * @return string
+ */
+ public function getSuffix()
+ {
+ return $this->suffix;
+ }
+
+ /**
+ * Set suffix.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setSuffix($value)
+ {
+ $enum = ['tab', 'space', 'nothing'];
+ $this->suffix = $this->setEnumVal($value, $enum, $this->suffix);
+
+ return $this;
+ }
+
+ /**
+ * Get text.
+ *
+ * @return string
+ */
+ public function getText()
+ {
+ return $this->text;
+ }
+
+ /**
+ * Set text.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setText($value)
+ {
+ $this->text = $value;
+
+ return $this;
+ }
+
+ /**
+ * @since 0.13.0
+ *
+ * @return string
+ */
+ public function getAlignment()
+ {
+ return $this->alignment;
+ }
+
+ /**
+ * @since 0.13.0
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setAlignment($value)
+ {
+ if (Jc::isValid($value)) {
+ $this->alignment = $value;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get left.
+ *
+ * @return int
+ */
+ public function getLeft()
+ {
+ return $this->left;
+ }
+
+ /**
+ * Set left.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setLeft($value)
+ {
+ $this->left = $this->setIntVal($value, $this->left);
+
+ return $this;
+ }
+
+ /**
+ * Get hanging.
+ *
+ * @return int
+ */
+ public function getHanging()
+ {
+ return $this->hanging;
+ }
+
+ /**
+ * Set hanging.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setHanging($value)
+ {
+ $this->hanging = $this->setIntVal($value, $this->hanging);
+
+ return $this;
+ }
+
+ /**
+ * Get tab.
+ *
+ * @return int
+ */
+ public function getTabPos()
+ {
+ return $this->tabPos;
+ }
+
+ /**
+ * Set tab.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setTabPos($value)
+ {
+ $this->tabPos = $this->setIntVal($value, $this->tabPos);
+
+ return $this;
+ }
+
+ /**
+ * Get font.
+ *
+ * @return string
+ */
+ public function getFont()
+ {
+ return $this->font;
+ }
+
+ /**
+ * Set font.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setFont($value)
+ {
+ $this->font = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get hint.
+ *
+ * @return string
+ */
+ public function getHint()
+ {
+ return $this->hint;
+ }
+
+ /**
+ * Set hint.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setHint($value = null)
+ {
+ $enum = ['default', 'eastAsia', 'cs'];
+ $this->hint = $this->setEnumVal($value, $enum, $this->hint);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Outline.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Outline.php
new file mode 100644
index 00000000..6d83f037
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Outline.php
@@ -0,0 +1,319 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get unit.
+ *
+ * @return string
+ */
+ public function getUnit()
+ {
+ return $this->unit;
+ }
+
+ /**
+ * Get weight.
+ *
+ * @return float|int
+ */
+ public function getWeight()
+ {
+ return $this->weight;
+ }
+
+ /**
+ * Set weight.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setWeight($value = null)
+ {
+ $this->weight = $this->setNumericVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get color.
+ *
+ * @return string
+ */
+ public function getColor()
+ {
+ return $this->color;
+ }
+
+ /**
+ * Set color.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setColor($value = null)
+ {
+ $this->color = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get dash type.
+ *
+ * @return string
+ */
+ public function getDash()
+ {
+ return $this->dash;
+ }
+
+ /**
+ * Set dash type.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setDash($value = null)
+ {
+ $this->dash = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get line style.
+ *
+ * @return string
+ */
+ public function getLine()
+ {
+ return $this->line;
+ }
+
+ /**
+ * Set line style.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setLine($value = null)
+ {
+ $enum = [self::LINE_SINGLE, self::LINE_THIN_THIN, self::LINE_THIN_THICK,
+ self::LINE_THICK_THIN, self::LINE_THICK_BETWEEN_THIN, ];
+ $this->line = $this->setEnumVal($value, $enum, null);
+
+ return $this;
+ }
+
+ /**
+ * Get endCap style.
+ *
+ * @return string
+ */
+ public function getEndCap()
+ {
+ return $this->endCap;
+ }
+
+ /**
+ * Set endCap style.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setEndCap($value = null)
+ {
+ $enum = [self::ENDCAP_FLAT, self::ENDCAP_SQUARE, self::ENDCAP_ROUND];
+ $this->endCap = $this->setEnumVal($value, $enum, null);
+
+ return $this;
+ }
+
+ /**
+ * Get startArrow.
+ *
+ * @return string
+ */
+ public function getStartArrow()
+ {
+ return $this->startArrow;
+ }
+
+ /**
+ * Set pattern.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setStartArrow($value = null)
+ {
+ $enum = [self::ARROW_NONE, self::ARROW_BLOCK, self::ARROW_CLASSIC,
+ self::ARROW_OVAL, self::ARROW_DIAMOND, self::ARROW_OPEN, ];
+ $this->startArrow = $this->setEnumVal($value, $enum, null);
+
+ return $this;
+ }
+
+ /**
+ * Get endArrow.
+ *
+ * @return string
+ */
+ public function getEndArrow()
+ {
+ return $this->endArrow;
+ }
+
+ /**
+ * Set pattern.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setEndArrow($value = null)
+ {
+ $enum = [self::ARROW_NONE, self::ARROW_BLOCK, self::ARROW_CLASSIC,
+ self::ARROW_OVAL, self::ARROW_DIAMOND, self::ARROW_OPEN, ];
+ $this->endArrow = $this->setEnumVal($value, $enum, null);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Paper.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Paper.php
new file mode 100644
index 00000000..3a340bda
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Paper.php
@@ -0,0 +1,195 @@
+ [297, 420, 'mm'],
+ 'A4' => [210, 297, 'mm'],
+ 'A5' => [148, 210, 'mm'],
+ 'B5' => [176, 250, 'mm'],
+ 'Folio' => [8.5, 13, 'in'],
+ 'Legal' => [8.5, 14, 'in'],
+ 'Letter' => [8.5, 11, 'in'],
+ ];
+
+ /**
+ * Paper size.
+ *
+ * @var string
+ */
+ private $size = 'A4';
+
+ /**
+ * Width.
+ *
+ * @var float (twip)
+ */
+ private $width;
+
+ /**
+ * Height.
+ *
+ * @var float (twip)
+ */
+ private $height;
+
+ /**
+ * Create a new instance.
+ *
+ * @param string $size
+ */
+ public function __construct($size = 'A4')
+ {
+ $this->setSize($size);
+ }
+
+ /**
+ * Get size.
+ *
+ * @return string
+ */
+ public function getSize()
+ {
+ return $this->size;
+ }
+
+ /**
+ * Set size.
+ *
+ * @param string $size
+ *
+ * @return self
+ */
+ public function setSize($size)
+ {
+ $this->size = $this->setEnumVal($size, array_keys($this->sizes), $this->size);
+
+ [$width, $height, $unit] = $this->sizes[$this->size];
+
+ if ($unit == 'mm') {
+ $this->width = Converter::cmToTwip($width / 10);
+ $this->height = Converter::cmToTwip($height / 10);
+ } else {
+ $this->width = Converter::inchToTwip($width);
+ $this->height = Converter::inchToTwip($height);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get width.
+ *
+ * @return float
+ */
+ public function getWidth()
+ {
+ return $this->width;
+ }
+
+ /**
+ * Get height.
+ *
+ * @return float
+ */
+ public function getHeight()
+ {
+ return $this->height;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Paragraph.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Paragraph.php
new file mode 100644
index 00000000..c7761740
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Paragraph.php
@@ -0,0 +1,825 @@
+ 'lineHeight', 'line-spacing' => 'spacing'];
+
+ /**
+ * Parent style.
+ *
+ * @var string
+ */
+ private $basedOn = 'Normal';
+
+ /**
+ * Style for next paragraph.
+ *
+ * @var string
+ */
+ private $next;
+
+ /**
+ * @var string
+ */
+ private $alignment = '';
+
+ /**
+ * Indentation.
+ *
+ * @var null|\PhpOffice\PhpWord\Style\Indentation
+ */
+ private $indentation;
+
+ /**
+ * Spacing.
+ *
+ * @var \PhpOffice\PhpWord\Style\Spacing
+ */
+ private $spacing;
+
+ /**
+ * Text line height.
+ *
+ * @var null|float|int
+ */
+ private $lineHeight;
+
+ /**
+ * Allow first/last line to display on a separate page.
+ *
+ * @var bool
+ */
+ private $widowControl = true;
+
+ /**
+ * Keep paragraph with next paragraph.
+ *
+ * @var bool
+ */
+ private $keepNext = false;
+
+ /**
+ * Keep all lines on one page.
+ *
+ * @var bool
+ */
+ private $keepLines = false;
+
+ /**
+ * Start paragraph on next page.
+ *
+ * @var bool
+ */
+ private $pageBreakBefore = false;
+
+ /**
+ * Numbering style name.
+ *
+ * @var string
+ */
+ private $numStyle;
+
+ /**
+ * Numbering level.
+ *
+ * @var int
+ */
+ private $numLevel = 0;
+
+ /**
+ * Set of Custom Tab Stops.
+ *
+ * @var \PhpOffice\PhpWord\Style\Tab[]
+ */
+ private $tabs = [];
+
+ /**
+ * Shading.
+ *
+ * @var \PhpOffice\PhpWord\Style\Shading
+ */
+ private $shading;
+
+ /**
+ * Ignore Spacing Above and Below When Using Identical Styles.
+ *
+ * @var bool
+ */
+ private $contextualSpacing = false;
+
+ /**
+ * Right to Left Paragraph Layout.
+ *
+ * @var ?bool
+ */
+ private $bidi;
+
+ /**
+ * Vertical Character Alignment on Line.
+ *
+ * @var string
+ */
+ private $textAlignment;
+
+ /**
+ * Suppress hyphenation for paragraph.
+ *
+ * @var bool
+ */
+ private $suppressAutoHyphens = false;
+
+ /**
+ * Set Style value.
+ *
+ * @param string $key
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setStyleValue($key, $value)
+ {
+ $key = Text::removeUnderscorePrefix($key);
+ if ('indent' == $key || 'hanging' == $key) {
+ $value = $value * 720; // 720 twips is 0.5 inch
+ }
+
+ return parent::setStyleValue($key, $value);
+ }
+
+ /**
+ * Get style values.
+ *
+ * An experiment to retrieve all style values in one function. This will
+ * reduce function call and increase cohesion between functions. Should be
+ * implemented in all styles.
+ *
+ * @ignoreScrutinizerPatch
+ *
+ * @return array
+ */
+ public function getStyleValues()
+ {
+ $styles = [
+ 'name' => $this->getStyleName(),
+ 'basedOn' => $this->getBasedOn(),
+ 'next' => $this->getNext(),
+ 'alignment' => $this->getAlignment(),
+ 'indentation' => $this->getIndentation(),
+ 'spacing' => $this->getSpace(),
+ 'pagination' => [
+ 'widowControl' => $this->hasWidowControl(),
+ 'keepNext' => $this->isKeepNext(),
+ 'keepLines' => $this->isKeepLines(),
+ 'pageBreak' => $this->hasPageBreakBefore(),
+ ],
+ 'numbering' => [
+ 'style' => $this->getNumStyle(),
+ 'level' => $this->getNumLevel(),
+ ],
+ 'tabs' => $this->getTabs(),
+ 'shading' => $this->getShading(),
+ 'contextualSpacing' => $this->hasContextualSpacing(),
+ 'bidi' => $this->isBidi(),
+ 'textAlignment' => $this->getTextAlignment(),
+ 'suppressAutoHyphens' => $this->hasSuppressAutoHyphens(),
+ ];
+
+ return $styles;
+ }
+
+ /**
+ * @since 0.13.0
+ *
+ * @return string
+ */
+ public function getAlignment()
+ {
+ return $this->alignment;
+ }
+
+ /**
+ * @since 0.13.0
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setAlignment($value)
+ {
+ if (Jc::isValid($value)) {
+ $this->alignment = $value;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get parent style ID.
+ *
+ * @return string
+ */
+ public function getBasedOn()
+ {
+ return $this->basedOn;
+ }
+
+ /**
+ * Set parent style ID.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBasedOn($value = 'Normal')
+ {
+ $this->basedOn = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get style for next paragraph.
+ *
+ * @return string
+ */
+ public function getNext()
+ {
+ return $this->next;
+ }
+
+ /**
+ * Set style for next paragraph.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setNext($value = null)
+ {
+ $this->next = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get indentation.
+ *
+ * @return null|\PhpOffice\PhpWord\Style\Indentation
+ */
+ public function getIndentation()
+ {
+ return $this->indentation;
+ }
+
+ /**
+ * Set shading.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setIndentation($value = null)
+ {
+ $this->setObjectVal($value, 'Indentation', $this->indentation);
+
+ return $this;
+ }
+
+ /**
+ * Get indentation.
+ *
+ * @return int
+ */
+ public function getIndent()
+ {
+ return $this->getChildStyleValue($this->indentation, 'left');
+ }
+
+ /**
+ * Set indentation.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setIndent($value = null)
+ {
+ return $this->setIndentation(['left' => $value]);
+ }
+
+ /**
+ * Get hanging.
+ *
+ * @return int
+ */
+ public function getHanging()
+ {
+ return $this->getChildStyleValue($this->indentation, 'hanging');
+ }
+
+ /**
+ * Set hanging.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setHanging($value = null)
+ {
+ return $this->setIndentation(['hanging' => $value]);
+ }
+
+ /**
+ * Get spacing.
+ *
+ * @return \PhpOffice\PhpWord\Style\Spacing
+ *
+ * @todo Rename to getSpacing in 1.0
+ */
+ public function getSpace()
+ {
+ return $this->spacing;
+ }
+
+ /**
+ * Set spacing.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ *
+ * @todo Rename to setSpacing in 1.0
+ */
+ public function setSpace($value = null)
+ {
+ $this->setObjectVal($value, 'Spacing', $this->spacing);
+
+ return $this;
+ }
+
+ /**
+ * Get space before paragraph.
+ *
+ * @return null|float|int
+ */
+ public function getSpaceBefore()
+ {
+ return $this->getChildStyleValue($this->spacing, 'before');
+ }
+
+ /**
+ * Set space before paragraph.
+ *
+ * @param null|float|int $value
+ *
+ * @return self
+ */
+ public function setSpaceBefore($value = null)
+ {
+ return $this->setSpace(['before' => $value]);
+ }
+
+ /**
+ * Get space after paragraph.
+ *
+ * @return null|float|int
+ */
+ public function getSpaceAfter()
+ {
+ return $this->getChildStyleValue($this->spacing, 'after');
+ }
+
+ /**
+ * Set space after paragraph.
+ *
+ * @param null|float|int $value
+ *
+ * @return self
+ */
+ public function setSpaceAfter($value = null)
+ {
+ return $this->setSpace(['after' => $value]);
+ }
+
+ /**
+ * Get spacing between lines.
+ *
+ * @return null|float|int
+ */
+ public function getSpacing()
+ {
+ return $this->getChildStyleValue($this->spacing, 'line');
+ }
+
+ /**
+ * Set spacing between lines.
+ *
+ * @param null|float|int $value
+ *
+ * @return self
+ */
+ public function setSpacing($value = null)
+ {
+ return $this->setSpace(['line' => $value]);
+ }
+
+ /**
+ * Get spacing line rule.
+ *
+ * @return string
+ */
+ public function getSpacingLineRule()
+ {
+ return $this->getChildStyleValue($this->spacing, 'lineRule');
+ }
+
+ /**
+ * Set the spacing line rule.
+ *
+ * @param string $value Possible values are defined in LineSpacingRule
+ *
+ * @return \PhpOffice\PhpWord\Style\Paragraph
+ */
+ public function setSpacingLineRule($value)
+ {
+ return $this->setSpace(['lineRule' => $value]);
+ }
+
+ /**
+ * Get line height.
+ *
+ * @return null|float|int
+ */
+ public function getLineHeight()
+ {
+ return $this->lineHeight;
+ }
+
+ /**
+ * Set the line height.
+ *
+ * @param float|int|string $lineHeight
+ *
+ * @return self
+ */
+ public function setLineHeight($lineHeight)
+ {
+ if (is_string($lineHeight)) {
+ $lineHeight = (float) (preg_replace('/[^0-9\.\,]/', '', $lineHeight));
+ }
+
+ if ((!is_int($lineHeight) && !is_float($lineHeight)) || !$lineHeight) {
+ throw new InvalidStyleException('Line height must be a valid number');
+ }
+
+ $this->lineHeight = $lineHeight;
+ $this->setSpacing(($lineHeight - 1) * self::LINE_HEIGHT);
+ $this->setSpacingLineRule(\PhpOffice\PhpWord\SimpleType\LineSpacingRule::AUTO);
+
+ return $this;
+ }
+
+ /**
+ * Get allow first/last line to display on a separate page setting.
+ *
+ * @return bool
+ */
+ public function hasWidowControl()
+ {
+ return $this->widowControl;
+ }
+
+ /**
+ * Set keep paragraph with next paragraph setting.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setWidowControl($value = true)
+ {
+ $this->widowControl = $this->setBoolVal($value, $this->widowControl);
+
+ return $this;
+ }
+
+ /**
+ * Get keep paragraph with next paragraph setting.
+ *
+ * @return bool
+ */
+ public function isKeepNext()
+ {
+ return $this->keepNext;
+ }
+
+ /**
+ * Set keep paragraph with next paragraph setting.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setKeepNext($value = true)
+ {
+ $this->keepNext = $this->setBoolVal($value, $this->keepNext);
+
+ return $this;
+ }
+
+ /**
+ * Get keep all lines on one page setting.
+ *
+ * @return bool
+ */
+ public function isKeepLines()
+ {
+ return $this->keepLines;
+ }
+
+ /**
+ * Set keep all lines on one page setting.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setKeepLines($value = true)
+ {
+ $this->keepLines = $this->setBoolVal($value, $this->keepLines);
+
+ return $this;
+ }
+
+ /**
+ * Get start paragraph on next page setting.
+ *
+ * @return bool
+ */
+ public function hasPageBreakBefore()
+ {
+ return $this->pageBreakBefore;
+ }
+
+ /**
+ * Set start paragraph on next page setting.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setPageBreakBefore($value = true)
+ {
+ $this->pageBreakBefore = $this->setBoolVal($value, $this->pageBreakBefore);
+
+ return $this;
+ }
+
+ /**
+ * Get numbering style name.
+ *
+ * @return string
+ */
+ public function getNumStyle()
+ {
+ return $this->numStyle;
+ }
+
+ /**
+ * Set numbering style name.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setNumStyle($value)
+ {
+ $this->numStyle = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get numbering level.
+ *
+ * @return int
+ */
+ public function getNumLevel()
+ {
+ return $this->numLevel;
+ }
+
+ /**
+ * Set numbering level.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setNumLevel($value = 0)
+ {
+ $this->numLevel = $this->setIntVal($value, $this->numLevel);
+
+ return $this;
+ }
+
+ /**
+ * Get tabs.
+ *
+ * @return \PhpOffice\PhpWord\Style\Tab[]
+ */
+ public function getTabs()
+ {
+ return $this->tabs;
+ }
+
+ /**
+ * Set tabs.
+ *
+ * @param array $value
+ *
+ * @return self
+ */
+ public function setTabs($value = null)
+ {
+ if (is_array($value)) {
+ $this->tabs = $value;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get shading.
+ *
+ * @return \PhpOffice\PhpWord\Style\Shading
+ */
+ public function getShading()
+ {
+ return $this->shading;
+ }
+
+ /**
+ * Set shading.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setShading($value = null)
+ {
+ $this->setObjectVal($value, 'Shading', $this->shading);
+
+ return $this;
+ }
+
+ /**
+ * Get contextualSpacing.
+ *
+ * @return bool
+ */
+ public function hasContextualSpacing()
+ {
+ return $this->contextualSpacing;
+ }
+
+ /**
+ * Set contextualSpacing.
+ *
+ * @param bool $contextualSpacing
+ *
+ * @return self
+ */
+ public function setContextualSpacing($contextualSpacing)
+ {
+ $this->contextualSpacing = $contextualSpacing;
+
+ return $this;
+ }
+
+ /**
+ * Get bidirectional.
+ *
+ * @return ?bool
+ */
+ public function isBidi()
+ {
+ return $this->bidi ?? Settings::isDefaultRtl();
+ }
+
+ /**
+ * Set bidi.
+ *
+ * @param ?bool $bidi
+ * Set to true to write from right to left
+ *
+ * @return self
+ */
+ public function setBidi($bidi)
+ {
+ $this->bidi = $bidi;
+
+ return $this;
+ }
+
+ /**
+ * Get textAlignment.
+ *
+ * @return string
+ */
+ public function getTextAlignment()
+ {
+ return $this->textAlignment;
+ }
+
+ /**
+ * Set textAlignment.
+ *
+ * @param string $textAlignment
+ *
+ * @return self
+ */
+ public function setTextAlignment($textAlignment)
+ {
+ TextAlignment::validate($textAlignment);
+ $this->textAlignment = $textAlignment;
+
+ return $this;
+ }
+
+ /**
+ * @return bool
+ */
+ public function hasSuppressAutoHyphens()
+ {
+ return $this->suppressAutoHyphens;
+ }
+
+ /**
+ * @param bool $suppressAutoHyphens
+ */
+ public function setSuppressAutoHyphens($suppressAutoHyphens): void
+ {
+ $this->suppressAutoHyphens = (bool) $suppressAutoHyphens;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Row.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Row.php
new file mode 100644
index 00000000..765c54f8
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Row.php
@@ -0,0 +1,126 @@
+tblHeader;
+ }
+
+ /**
+ * Is tblHeader.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setTblHeader($value = true)
+ {
+ $this->tblHeader = $this->setBoolVal($value, $this->tblHeader);
+
+ return $this;
+ }
+
+ /**
+ * Is cantSplit.
+ *
+ * @return bool
+ */
+ public function isCantSplit()
+ {
+ return $this->cantSplit;
+ }
+
+ /**
+ * Is cantSplit.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setCantSplit($value = true)
+ {
+ $this->cantSplit = $this->setBoolVal($value, $this->cantSplit);
+
+ return $this;
+ }
+
+ /**
+ * Is exactHeight.
+ *
+ * @return bool
+ */
+ public function isExactHeight()
+ {
+ return $this->exactHeight;
+ }
+
+ /**
+ * Set exactHeight.
+ *
+ * @param bool $value
+ *
+ * @return self
+ */
+ public function setExactHeight($value = true)
+ {
+ $this->exactHeight = $this->setBoolVal($value, $this->exactHeight);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Section.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Section.php
new file mode 100644
index 00000000..3b08aa5f
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Section.php
@@ -0,0 +1,534 @@
+setPaperSize();
+ }
+
+ /**
+ * Get paper size.
+ *
+ * @return string
+ */
+ public function getPaperSize()
+ {
+ return $this->paper->getSize();
+ }
+
+ /**
+ * Set paper size.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setPaperSize($value = '')
+ {
+ if (!$value) {
+ $value = Settings::getDefaultPaper();
+ }
+ if ($this->paper === null) {
+ $this->paper = new Paper();
+ }
+ $this->paper->setSize($value);
+ $this->pageSizeW = $this->paper->getWidth();
+ $this->pageSizeH = $this->paper->getHeight();
+
+ return $this;
+ }
+
+ /**
+ * Set Setting Value.
+ *
+ * @param string $key
+ * @param array|int|string $value
+ *
+ * @return self
+ */
+ public function setSettingValue($key, $value)
+ {
+ return $this->setStyleValue($key, $value);
+ }
+
+ /**
+ * Set orientation.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setOrientation($value = null)
+ {
+ $enum = [self::ORIENTATION_PORTRAIT, self::ORIENTATION_LANDSCAPE];
+ $this->orientation = $this->setEnumVal($value, $enum, $this->orientation);
+
+ /** @var float|int $longSide Type hint */
+ $longSide = $this->pageSizeW >= $this->pageSizeH ? $this->pageSizeW : $this->pageSizeH;
+
+ /** @var float|int $shortSide Type hint */
+ $shortSide = $this->pageSizeW < $this->pageSizeH ? $this->pageSizeW : $this->pageSizeH;
+
+ if ($this->orientation == self::ORIENTATION_PORTRAIT) {
+ $this->pageSizeW = $shortSide;
+ $this->pageSizeH = $longSide;
+ } else {
+ $this->pageSizeW = $longSide;
+ $this->pageSizeH = $shortSide;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get Page Orientation.
+ *
+ * @return string
+ */
+ public function getOrientation()
+ {
+ return $this->orientation;
+ }
+
+ /**
+ * Set Portrait Orientation.
+ *
+ * @return self
+ */
+ public function setPortrait()
+ {
+ return $this->setOrientation(self::ORIENTATION_PORTRAIT);
+ }
+
+ /**
+ * Set Landscape Orientation.
+ *
+ * @return self
+ */
+ public function setLandscape()
+ {
+ return $this->setOrientation(self::ORIENTATION_LANDSCAPE);
+ }
+
+ /**
+ * Get Page Size Width.
+ *
+ * @return null|float|int
+ *
+ * @since 0.12.0
+ */
+ public function getPageSizeW()
+ {
+ return $this->pageSizeW;
+ }
+
+ /**
+ * @param null|float|int $value
+ *
+ * @return \PhpOffice\PhpWord\Style\Section
+ *
+ * @since 0.12.0
+ */
+ public function setPageSizeW($value = null)
+ {
+ $this->pageSizeW = $this->setNumericVal($value, self::DEFAULT_WIDTH);
+
+ return $this;
+ }
+
+ /**
+ * Get Page Size Height.
+ *
+ * @return null|float|int
+ *
+ * @since 0.12.0
+ */
+ public function getPageSizeH()
+ {
+ return $this->pageSizeH;
+ }
+
+ /**
+ * @param null|float|int $value
+ *
+ * @return \PhpOffice\PhpWord\Style\Section
+ *
+ * @since 0.12.0
+ */
+ public function setPageSizeH($value = null)
+ {
+ $this->pageSizeH = $this->setNumericVal($value, self::DEFAULT_HEIGHT);
+
+ return $this;
+ }
+
+ /**
+ * Get gutter.
+ *
+ * @return float|int
+ */
+ public function getGutter()
+ {
+ return $this->gutter;
+ }
+
+ /**
+ * Set gutter.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setGutter($value = null)
+ {
+ $this->gutter = $this->setNumericVal($value, self::DEFAULT_GUTTER);
+
+ return $this;
+ }
+
+ /**
+ * Get Header Height.
+ *
+ * @return float|int
+ */
+ public function getHeaderHeight()
+ {
+ return $this->headerHeight;
+ }
+
+ /**
+ * Set Header Height.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setHeaderHeight($value = null)
+ {
+ $this->headerHeight = $this->setNumericVal($value, self::DEFAULT_HEADER_HEIGHT);
+
+ return $this;
+ }
+
+ /**
+ * Get Footer Height.
+ *
+ * @return float|int
+ */
+ public function getFooterHeight()
+ {
+ return $this->footerHeight;
+ }
+
+ /**
+ * Set Footer Height.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setFooterHeight($value = null)
+ {
+ $this->footerHeight = $this->setNumericVal($value, self::DEFAULT_FOOTER_HEIGHT);
+
+ return $this;
+ }
+
+ /**
+ * Get page numbering start.
+ *
+ * @return null|int
+ */
+ public function getPageNumberingStart()
+ {
+ return $this->pageNumberingStart;
+ }
+
+ /**
+ * Set page numbering start.
+ *
+ * @param null|int $pageNumberingStart
+ *
+ * @return self
+ */
+ public function setPageNumberingStart($pageNumberingStart = null)
+ {
+ $this->pageNumberingStart = $pageNumberingStart;
+
+ return $this;
+ }
+
+ /**
+ * Get Section Columns Count.
+ *
+ * @return int
+ */
+ public function getColsNum()
+ {
+ return $this->colsNum;
+ }
+
+ /**
+ * Set Section Columns Count.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setColsNum($value = null)
+ {
+ $this->colsNum = $this->setIntVal($value, self::DEFAULT_COLUMN_COUNT);
+
+ return $this;
+ }
+
+ /**
+ * Get Section Space Between Columns.
+ *
+ * @return float|int
+ */
+ public function getColsSpace()
+ {
+ return $this->colsSpace;
+ }
+
+ /**
+ * Set Section Space Between Columns.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setColsSpace($value = null)
+ {
+ $this->colsSpace = $this->setNumericVal($value, self::DEFAULT_COLUMN_SPACING);
+
+ return $this;
+ }
+
+ /**
+ * Get Break Type.
+ *
+ * @return ?string
+ */
+ public function getBreakType()
+ {
+ return $this->breakType;
+ }
+
+ /**
+ * Set Break Type.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBreakType($value = null)
+ {
+ $this->breakType = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get line numbering.
+ *
+ * @return \PhpOffice\PhpWord\Style\LineNumbering
+ */
+ public function getLineNumbering()
+ {
+ return $this->lineNumbering;
+ }
+
+ /**
+ * Set line numbering.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setLineNumbering($value = null)
+ {
+ $this->setObjectVal($value, 'LineNumbering', $this->lineNumbering);
+
+ return $this;
+ }
+
+ /**
+ * Get vertical alignment.
+ *
+ * @return ?string
+ */
+ public function getVAlign()
+ {
+ return $this->vAlign;
+ }
+
+ /**
+ * Set vertical alignment.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setVAlign($value = null)
+ {
+ VerticalJc::validate($value);
+ $this->vAlign = $value;
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Shading.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Shading.php
new file mode 100644
index 00000000..81d69e31
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Shading.php
@@ -0,0 +1,151 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get pattern.
+ *
+ * @return string
+ */
+ public function getPattern()
+ {
+ return $this->pattern;
+ }
+
+ /**
+ * Set pattern.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setPattern($value = null)
+ {
+ $enum = [
+ self::PATTERN_CLEAR, self::PATTERN_SOLID, self::PATTERN_HSTRIPE,
+ self::PATTERN_VSTRIPE, self::PATTERN_DSTRIPE, self::PATTERN_HCROSS, self::PATTERN_DCROSS,
+ ];
+ $this->pattern = $this->setEnumVal($value, $enum, $this->pattern);
+
+ return $this;
+ }
+
+ /**
+ * Get color.
+ *
+ * @return string
+ */
+ public function getColor()
+ {
+ return $this->color;
+ }
+
+ /**
+ * Set pattern.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setColor($value = null)
+ {
+ $this->color = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get fill.
+ *
+ * @return string
+ */
+ public function getFill()
+ {
+ return $this->fill;
+ }
+
+ /**
+ * Set fill.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setFill($value = null)
+ {
+ $this->fill = $value;
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Shadow.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Shadow.php
new file mode 100644
index 00000000..3f6252d4
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Shadow.php
@@ -0,0 +1,99 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get color.
+ *
+ * @return string
+ */
+ public function getColor()
+ {
+ return $this->color;
+ }
+
+ /**
+ * Set color.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setColor($value = null)
+ {
+ $this->color = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get offset.
+ *
+ * @return string
+ */
+ public function getOffset()
+ {
+ return $this->offset;
+ }
+
+ /**
+ * Set offset.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setOffset($value = null)
+ {
+ $this->offset = $value;
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Shape.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Shape.php
new file mode 100644
index 00000000..7dd62a1f
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Shape.php
@@ -0,0 +1,263 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get points.
+ *
+ * @return string
+ */
+ public function getPoints()
+ {
+ return $this->points;
+ }
+
+ /**
+ * Set points.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setPoints($value = null)
+ {
+ $this->points = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get roundness.
+ *
+ * @return float|int
+ */
+ public function getRoundness()
+ {
+ return $this->roundness;
+ }
+
+ /**
+ * Set roundness.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setRoundness($value = null)
+ {
+ $this->roundness = $this->setNumericVal($value, null);
+
+ return $this;
+ }
+
+ /**
+ * Get frame.
+ *
+ * @return \PhpOffice\PhpWord\Style\Frame
+ */
+ public function getFrame()
+ {
+ return $this->frame;
+ }
+
+ /**
+ * Set frame.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setFrame($value = null)
+ {
+ $this->setObjectVal($value, 'Frame', $this->frame);
+
+ return $this;
+ }
+
+ /**
+ * Get fill.
+ *
+ * @return \PhpOffice\PhpWord\Style\Fill
+ */
+ public function getFill()
+ {
+ return $this->fill;
+ }
+
+ /**
+ * Set fill.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setFill($value = null)
+ {
+ $this->setObjectVal($value, 'Fill', $this->fill);
+
+ return $this;
+ }
+
+ /**
+ * Get outline.
+ *
+ * @return \PhpOffice\PhpWord\Style\Outline
+ */
+ public function getOutline()
+ {
+ return $this->outline;
+ }
+
+ /**
+ * Set outline.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setOutline($value = null)
+ {
+ $this->setObjectVal($value, 'Outline', $this->outline);
+
+ return $this;
+ }
+
+ /**
+ * Get shadow.
+ *
+ * @return \PhpOffice\PhpWord\Style\Shadow
+ */
+ public function getShadow()
+ {
+ return $this->shadow;
+ }
+
+ /**
+ * Set shadow.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setShadow($value = null)
+ {
+ $this->setObjectVal($value, 'Shadow', $this->shadow);
+
+ return $this;
+ }
+
+ /**
+ * Get 3D extrusion.
+ *
+ * @return \PhpOffice\PhpWord\Style\Extrusion
+ */
+ public function getExtrusion()
+ {
+ return $this->extrusion;
+ }
+
+ /**
+ * Set 3D extrusion.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setExtrusion($value = null)
+ {
+ $this->setObjectVal($value, 'Extrusion', $this->extrusion);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Spacing.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Spacing.php
new file mode 100644
index 00000000..196ad8da
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Spacing.php
@@ -0,0 +1,164 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get before.
+ *
+ * @return null|float|int
+ */
+ public function getBefore()
+ {
+ return $this->before;
+ }
+
+ /**
+ * Set before.
+ *
+ * @param null|float|int $value
+ *
+ * @return self
+ */
+ public function setBefore($value = null)
+ {
+ $this->before = $this->setNumericVal($value, $this->before);
+
+ return $this;
+ }
+
+ /**
+ * Get after.
+ *
+ * @return null|float|int
+ */
+ public function getAfter()
+ {
+ return $this->after;
+ }
+
+ /**
+ * Set after.
+ *
+ * @param null|float|int $value
+ *
+ * @return self
+ */
+ public function setAfter($value = null)
+ {
+ $this->after = $this->setNumericVal($value, $this->after);
+
+ return $this;
+ }
+
+ /**
+ * Get line.
+ *
+ * @return null|float|int
+ */
+ public function getLine()
+ {
+ return $this->line;
+ }
+
+ /**
+ * Set distance.
+ *
+ * @param null|float|int $value
+ *
+ * @return self
+ */
+ public function setLine($value = null)
+ {
+ $this->line = $this->setNumericVal($value, $this->line);
+
+ return $this;
+ }
+
+ /**
+ * Get line rule.
+ *
+ * @return string
+ */
+ public function getLineRule()
+ {
+ return $this->lineRule;
+ }
+
+ /**
+ * Set line rule.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setLineRule($value = null)
+ {
+ LineSpacingRule::validate($value);
+ $this->lineRule = $value;
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/TOC.php b/vendor/phpoffice/phpword/src/PhpWord/Style/TOC.php
new file mode 100644
index 00000000..bd0d9069
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/TOC.php
@@ -0,0 +1,107 @@
+getPosition();
+ }
+
+ /**
+ * Set Tab Position.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setTabPos($value)
+ {
+ return $this->setPosition($value);
+ }
+
+ /**
+ * Get Tab Leader.
+ *
+ * @return string
+ */
+ public function getTabLeader()
+ {
+ return $this->getLeader();
+ }
+
+ /**
+ * Set Tab Leader.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setTabLeader($value = self::TAB_LEADER_DOT)
+ {
+ return $this->setLeader($value);
+ }
+
+ /**
+ * Get Indent.
+ *
+ * @return float|int
+ */
+ public function getIndent()
+ {
+ return $this->indent;
+ }
+
+ /**
+ * Set Indent.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setIndent($value)
+ {
+ $this->indent = $this->setNumericVal($value, $this->indent);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Tab.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Tab.php
new file mode 100644
index 00000000..02158fd4
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Tab.php
@@ -0,0 +1,176 @@
+type = $this->setEnumVal($type, $stopTypes, $this->type);
+ $this->position = $this->setNumericVal($position, $this->position);
+ $this->leader = $this->setEnumVal($leader, $leaderTypes, $this->leader);
+ }
+
+ /**
+ * Get stop type.
+ *
+ * @return string
+ */
+ public function getType()
+ {
+ return $this->type;
+ }
+
+ /**
+ * Set stop type.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setType($value)
+ {
+ $enum = [
+ self::TAB_STOP_CLEAR, self::TAB_STOP_LEFT, self::TAB_STOP_CENTER,
+ self::TAB_STOP_RIGHT, self::TAB_STOP_DECIMAL, self::TAB_STOP_BAR,
+ self::TAB_STOP_NUM,
+ ];
+ $this->type = $this->setEnumVal($value, $enum, $this->type);
+
+ return $this;
+ }
+
+ /**
+ * Get leader.
+ *
+ * @return string
+ */
+ public function getLeader()
+ {
+ return $this->leader;
+ }
+
+ /**
+ * Set leader.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setLeader($value)
+ {
+ $enum = [
+ self::TAB_LEADER_NONE, self::TAB_LEADER_DOT, self::TAB_LEADER_HYPHEN,
+ self::TAB_LEADER_UNDERSCORE, self::TAB_LEADER_HEAVY, self::TAB_LEADER_MIDDLEDOT,
+ ];
+ $this->leader = $this->setEnumVal($value, $enum, $this->leader);
+
+ return $this;
+ }
+
+ /**
+ * Get position.
+ *
+ * @return float|int
+ */
+ public function getPosition()
+ {
+ return $this->position;
+ }
+
+ /**
+ * Set position.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setPosition($value)
+ {
+ $this->position = $this->setNumericVal($value, $this->position);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/Table.php b/vendor/phpoffice/phpword/src/PhpWord/Style/Table.php
new file mode 100644
index 00000000..3adb1a38
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/Table.php
@@ -0,0 +1,794 @@
+firstRowStyle = clone $this;
+ $this->firstRowStyle->isFirstRow = true;
+ unset($this->firstRowStyle->firstRowStyle, $this->firstRowStyle->borderInsideHSize, $this->firstRowStyle->borderInsideHColor, $this->firstRowStyle->borderInsideVSize, $this->firstRowStyle->borderInsideVColor, $this->firstRowStyle->cellMarginTop, $this->firstRowStyle->cellMarginLeft, $this->firstRowStyle->cellMarginRight, $this->firstRowStyle->cellMarginBottom, $this->firstRowStyle->cellSpacing);
+ $this->firstRowStyle->setStyleByArray($firstRowStyle);
+ }
+
+ if ($tableStyle !== null && is_array($tableStyle)) {
+ $this->setStyleByArray($tableStyle);
+ }
+ }
+
+ /**
+ * @param null|float|int $cellSpacing
+ */
+ public function setCellSpacing($cellSpacing = null): void
+ {
+ $this->cellSpacing = $cellSpacing;
+ }
+
+ /**
+ * @return null|float|int
+ */
+ public function getCellSpacing()
+ {
+ return $this->cellSpacing;
+ }
+
+ /**
+ * Set first row.
+ *
+ * @return \PhpOffice\PhpWord\Style\Table
+ */
+ public function getFirstRow()
+ {
+ return $this->firstRowStyle;
+ }
+
+ /**
+ * Get background.
+ *
+ * @return ?string
+ */
+ public function getBgColor()
+ {
+ if ($this->shading !== null) {
+ return $this->shading->getFill();
+ }
+
+ return null;
+ }
+
+ /**
+ * Set background.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBgColor($value = null)
+ {
+ $this->setShading(['fill' => $value]);
+
+ return $this;
+ }
+
+ /**
+ * Get TLRBHV Border Size.
+ *
+ * @return int[]
+ */
+ public function getBorderSize()
+ {
+ return [
+ $this->getBorderTopSize(),
+ $this->getBorderLeftSize(),
+ $this->getBorderRightSize(),
+ $this->getBorderBottomSize(),
+ $this->getBorderInsideHSize(),
+ $this->getBorderInsideVSize(),
+ ];
+ }
+
+ /**
+ * Set TLRBHV Border Size.
+ *
+ * @param int $value Border size in eighths of a point (1/8 point)
+ *
+ * @return self
+ */
+ public function setBorderSize($value = null)
+ {
+ $this->setBorderTopSize($value);
+ $this->setBorderLeftSize($value);
+ $this->setBorderRightSize($value);
+ $this->setBorderBottomSize($value);
+ $this->setBorderInsideHSize($value);
+ $this->setBorderInsideVSize($value);
+
+ return $this;
+ }
+
+ /**
+ * Get TLRBHV Border Color.
+ *
+ * @return string[]
+ */
+ public function getBorderColor()
+ {
+ return [
+ $this->getBorderTopColor(),
+ $this->getBorderLeftColor(),
+ $this->getBorderRightColor(),
+ $this->getBorderBottomColor(),
+ $this->getBorderInsideHColor(),
+ $this->getBorderInsideVColor(),
+ ];
+ }
+
+ /**
+ * Set TLRBHV Border Color.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBorderColor($value = null)
+ {
+ $this->setBorderTopColor($value);
+ $this->setBorderLeftColor($value);
+ $this->setBorderRightColor($value);
+ $this->setBorderBottomColor($value);
+ $this->setBorderInsideHColor($value);
+ $this->setBorderInsideVColor($value);
+
+ return $this;
+ }
+
+ /**
+ * Get border size inside horizontal.
+ *
+ * @return int
+ */
+ public function getBorderInsideHSize()
+ {
+ return $this->getTableOnlyProperty('borderInsideHSize');
+ }
+
+ /**
+ * Set border size inside horizontal.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setBorderInsideHSize($value = null)
+ {
+ return $this->setTableOnlyProperty('borderInsideHSize', $value);
+ }
+
+ /**
+ * Get border color inside horizontal.
+ *
+ * @return string
+ */
+ public function getBorderInsideHColor()
+ {
+ return $this->getTableOnlyProperty('borderInsideHColor');
+ }
+
+ /**
+ * Set border color inside horizontal.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBorderInsideHColor($value = null)
+ {
+ return $this->setTableOnlyProperty('borderInsideHColor', $value, false);
+ }
+
+ /**
+ * Get border size inside vertical.
+ *
+ * @return int
+ */
+ public function getBorderInsideVSize()
+ {
+ return $this->getTableOnlyProperty('borderInsideVSize');
+ }
+
+ /**
+ * Set border size inside vertical.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setBorderInsideVSize($value = null)
+ {
+ return $this->setTableOnlyProperty('borderInsideVSize', $value);
+ }
+
+ /**
+ * Get border color inside vertical.
+ *
+ * @return string
+ */
+ public function getBorderInsideVColor()
+ {
+ return $this->getTableOnlyProperty('borderInsideVColor');
+ }
+
+ /**
+ * Set border color inside vertical.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setBorderInsideVColor($value = null)
+ {
+ return $this->setTableOnlyProperty('borderInsideVColor', $value, false);
+ }
+
+ /**
+ * Get cell margin top.
+ *
+ * @return int
+ */
+ public function getCellMarginTop()
+ {
+ return $this->getTableOnlyProperty('cellMarginTop');
+ }
+
+ /**
+ * Set cell margin top.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setCellMarginTop($value = null)
+ {
+ return $this->setTableOnlyProperty('cellMarginTop', $value);
+ }
+
+ /**
+ * Get cell margin left.
+ *
+ * @return int
+ */
+ public function getCellMarginLeft()
+ {
+ return $this->getTableOnlyProperty('cellMarginLeft');
+ }
+
+ /**
+ * Set cell margin left.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setCellMarginLeft($value = null)
+ {
+ return $this->setTableOnlyProperty('cellMarginLeft', $value);
+ }
+
+ /**
+ * Get cell margin right.
+ *
+ * @return int
+ */
+ public function getCellMarginRight()
+ {
+ return $this->getTableOnlyProperty('cellMarginRight');
+ }
+
+ /**
+ * Set cell margin right.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setCellMarginRight($value = null)
+ {
+ return $this->setTableOnlyProperty('cellMarginRight', $value);
+ }
+
+ /**
+ * Get cell margin bottom.
+ *
+ * @return int
+ */
+ public function getCellMarginBottom()
+ {
+ return $this->getTableOnlyProperty('cellMarginBottom');
+ }
+
+ /**
+ * Set cell margin bottom.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setCellMarginBottom($value = null)
+ {
+ return $this->setTableOnlyProperty('cellMarginBottom', $value);
+ }
+
+ /**
+ * Get cell margin.
+ *
+ * @return int[]
+ */
+ public function getCellMargin()
+ {
+ return [
+ $this->cellMarginTop,
+ $this->cellMarginLeft,
+ $this->cellMarginRight,
+ $this->cellMarginBottom,
+ ];
+ }
+
+ /**
+ * Set TLRB cell margin.
+ *
+ * @param int $value Margin in twips
+ *
+ * @return self
+ */
+ public function setCellMargin($value = null)
+ {
+ $this->setCellMarginTop($value);
+ $this->setCellMarginLeft($value);
+ $this->setCellMarginRight($value);
+ $this->setCellMarginBottom($value);
+
+ return $this;
+ }
+
+ /**
+ * Check if any of the margin is not null.
+ *
+ * @return bool
+ */
+ public function hasMargin()
+ {
+ $margins = $this->getCellMargin();
+
+ return $margins !== array_filter($margins, 'is_null');
+ }
+
+ /**
+ * Get shading.
+ *
+ * @return \PhpOffice\PhpWord\Style\Shading
+ */
+ public function getShading()
+ {
+ return $this->shading;
+ }
+
+ /**
+ * Set shading.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setShading($value = null)
+ {
+ $this->setObjectVal($value, 'Shading', $this->shading);
+
+ return $this;
+ }
+
+ /**
+ * @since 0.13.0
+ *
+ * @return string
+ */
+ public function getAlignment()
+ {
+ return $this->alignment;
+ }
+
+ /**
+ * @since 0.13.0
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setAlignment($value)
+ {
+ if (JcTable::isValid($value) || Jc::isValid($value)) {
+ $this->alignment = $value;
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get width.
+ *
+ * @return float|int
+ */
+ public function getWidth()
+ {
+ return $this->width;
+ }
+
+ /**
+ * Set width.
+ *
+ * @param float|int $value
+ *
+ * @return self
+ */
+ public function setWidth($value = null)
+ {
+ $this->width = $this->setNumericVal($value, $this->width);
+
+ return $this;
+ }
+
+ /**
+ * Get width unit.
+ *
+ * @return string
+ */
+ public function getUnit()
+ {
+ return $this->unit;
+ }
+
+ /**
+ * Set width unit.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setUnit($value = null)
+ {
+ TblWidth::validate($value);
+ $this->unit = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get layout.
+ *
+ * @return string
+ */
+ public function getLayout()
+ {
+ return $this->layout;
+ }
+
+ /**
+ * Set layout.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setLayout($value = null)
+ {
+ $enum = [self::LAYOUT_AUTO, self::LAYOUT_FIXED];
+ $this->layout = $this->setEnumVal($value, $enum, $this->layout);
+
+ return $this;
+ }
+
+ /**
+ * Get table style only property by checking if it's a firstRow.
+ *
+ * This is necessary since firstRow style is cloned from table style but
+ * without certain properties activated, e.g. margins
+ *
+ * @param string $property
+ *
+ * @return null|int|string
+ */
+ private function getTableOnlyProperty($property)
+ {
+ if (false === $this->isFirstRow) {
+ return $this->$property;
+ }
+
+ return null;
+ }
+
+ /**
+ * Set table style only property by checking if it's a firstRow.
+ *
+ * This is necessary since firstRow style is cloned from table style but
+ * without certain properties activated, e.g. margins
+ *
+ * @param string $property
+ * @param int|string $value
+ * @param bool $isNumeric
+ *
+ * @return self
+ */
+ private function setTableOnlyProperty($property, $value, $isNumeric = true)
+ {
+ if (false === $this->isFirstRow) {
+ if (true === $isNumeric) {
+ $this->$property = $this->setNumericVal($value, $this->$property);
+ } else {
+ $this->$property = $value;
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get position.
+ *
+ * @return ?\PhpOffice\PhpWord\Style\TablePosition
+ */
+ public function getPosition()
+ {
+ return $this->position;
+ }
+
+ /**
+ * Set position.
+ *
+ * @param mixed $value
+ *
+ * @return self
+ */
+ public function setPosition($value = null)
+ {
+ $this->setObjectVal($value, 'TablePosition', $this->position);
+
+ return $this;
+ }
+
+ /**
+ * @return ?TblWidthComplexType
+ */
+ public function getIndent()
+ {
+ return $this->indent;
+ }
+
+ /**
+ * @return self
+ *
+ * @see http://www.datypic.com/sc/ooxml/e-w_tblInd-1.html
+ */
+ public function setIndent(TblWidthComplexType $indent)
+ {
+ $this->indent = $indent;
+
+ return $this;
+ }
+
+ /**
+ * Get the columnWidths.
+ *
+ * @return null|int[]
+ */
+ public function getColumnWidths()
+ {
+ return $this->columnWidths;
+ }
+
+ /**
+ * The column widths.
+ *
+ * @param int[] $value
+ */
+ public function setColumnWidths(?array $value = null): void
+ {
+ $this->columnWidths = $value;
+ }
+
+ /**
+ * Get bidiVisual.
+ *
+ * @return ?bool
+ */
+ public function isBidiVisual()
+ {
+ return $this->bidiVisual ?? Settings::isDefaultRtl();
+ }
+
+ /**
+ * Set bidiVisual.
+ *
+ * @param ?bool $bidi
+ * Set to true to visually present table as Right to Left
+ *
+ * @return self
+ */
+ public function setBidiVisual($bidi)
+ {
+ $this->bidiVisual = $bidi;
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/TablePosition.php b/vendor/phpoffice/phpword/src/PhpWord/Style/TablePosition.php
new file mode 100644
index 00000000..a61926b8
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/TablePosition.php
@@ -0,0 +1,428 @@
+setStyleByArray($style);
+ }
+
+ /**
+ * Get distance from left of table to text.
+ *
+ * @return int
+ */
+ public function getLeftFromText()
+ {
+ return $this->leftFromText;
+ }
+
+ /**
+ * Set distance from left of table to text.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setLeftFromText($value = null)
+ {
+ $this->leftFromText = $this->setNumericVal($value, $this->leftFromText);
+
+ return $this;
+ }
+
+ /**
+ * Get distance from right of table to text.
+ *
+ * @return int
+ */
+ public function getRightFromText()
+ {
+ return $this->rightFromText;
+ }
+
+ /**
+ * Set distance from right of table to text.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setRightFromText($value = null)
+ {
+ $this->rightFromText = $this->setNumericVal($value, $this->rightFromText);
+
+ return $this;
+ }
+
+ /**
+ * Get distance from top of table to text.
+ *
+ * @return int
+ */
+ public function getTopFromText()
+ {
+ return $this->topFromText;
+ }
+
+ /**
+ * Set distance from top of table to text.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setTopFromText($value = null)
+ {
+ $this->topFromText = $this->setNumericVal($value, $this->topFromText);
+
+ return $this;
+ }
+
+ /**
+ * Get distance from bottom of table to text.
+ *
+ * @return int
+ */
+ public function getBottomFromText()
+ {
+ return $this->bottomFromText;
+ }
+
+ /**
+ * Set distance from bottom of table to text.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setBottomFromText($value = null)
+ {
+ $this->bottomFromText = $this->setNumericVal($value, $this->bottomFromText);
+
+ return $this;
+ }
+
+ /**
+ * Get table vertical anchor.
+ *
+ * @return string
+ */
+ public function getVertAnchor()
+ {
+ return $this->vertAnchor;
+ }
+
+ /**
+ * Set table vertical anchor.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setVertAnchor($value = null)
+ {
+ $enum = [
+ self::VANCHOR_TEXT,
+ self::VANCHOR_MARGIN,
+ self::VANCHOR_PAGE,
+ ];
+ $this->vertAnchor = $this->setEnumVal($value, $enum, $this->vertAnchor);
+
+ return $this;
+ }
+
+ /**
+ * Get table horizontal anchor.
+ *
+ * @return string
+ */
+ public function getHorzAnchor()
+ {
+ return $this->horzAnchor;
+ }
+
+ /**
+ * Set table horizontal anchor.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setHorzAnchor($value = null)
+ {
+ $enum = [
+ self::HANCHOR_TEXT,
+ self::HANCHOR_MARGIN,
+ self::HANCHOR_PAGE,
+ ];
+ $this->horzAnchor = $this->setEnumVal($value, $enum, $this->horzAnchor);
+
+ return $this;
+ }
+
+ /**
+ * Get relative horizontal alignment from anchor.
+ *
+ * @return string
+ */
+ public function getTblpXSpec()
+ {
+ return $this->tblpXSpec;
+ }
+
+ /**
+ * Set relative horizontal alignment from anchor.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setTblpXSpec($value = null)
+ {
+ $enum = [
+ self::XALIGN_LEFT,
+ self::XALIGN_CENTER,
+ self::XALIGN_RIGHT,
+ self::XALIGN_INSIDE,
+ self::XALIGN_OUTSIDE,
+ ];
+ $this->tblpXSpec = $this->setEnumVal($value, $enum, $this->tblpXSpec);
+
+ return $this;
+ }
+
+ /**
+ * Get absolute horizontal distance from anchor.
+ *
+ * @return int
+ */
+ public function getTblpX()
+ {
+ return $this->tblpX;
+ }
+
+ /**
+ * Set absolute horizontal distance from anchor.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setTblpX($value = null)
+ {
+ $this->tblpX = $this->setNumericVal($value, $this->tblpX);
+
+ return $this;
+ }
+
+ /**
+ * Get relative vertical alignment from anchor.
+ *
+ * @return string
+ */
+ public function getTblpYSpec()
+ {
+ return $this->tblpYSpec;
+ }
+
+ /**
+ * Set relative vertical alignment from anchor.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setTblpYSpec($value = null)
+ {
+ $enum = [
+ self::YALIGN_INLINE,
+ self::YALIGN_TOP,
+ self::YALIGN_CENTER,
+ self::YALIGN_BOTTOM,
+ self::YALIGN_INSIDE,
+ self::YALIGN_OUTSIDE,
+ ];
+ $this->tblpYSpec = $this->setEnumVal($value, $enum, $this->tblpYSpec);
+
+ return $this;
+ }
+
+ /**
+ * Get absolute vertical distance from anchor.
+ *
+ * @return int
+ */
+ public function getTblpY()
+ {
+ return $this->tblpY;
+ }
+
+ /**
+ * Set absolute vertical distance from anchor.
+ *
+ * @param int $value
+ *
+ * @return self
+ */
+ public function setTblpY($value = null)
+ {
+ $this->tblpY = $this->setNumericVal($value, $this->tblpY);
+
+ return $this;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Style/TextBox.php b/vendor/phpoffice/phpword/src/PhpWord/Style/TextBox.php
new file mode 100644
index 00000000..341d9306
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Style/TextBox.php
@@ -0,0 +1,227 @@
+bgColor = $value;
+ }
+
+ /**
+ * Get background color.
+ */
+ public function getBgColor(): ?string
+ {
+ return $this->bgColor;
+ }
+
+ /**
+ * Set margin top.
+ */
+ public function setInnerMarginTop(?int $value = null): void
+ {
+ $this->innerMarginTop = $value;
+ }
+
+ /**
+ * Get margin top.
+ */
+ public function getInnerMarginTop(): ?int
+ {
+ return $this->innerMarginTop;
+ }
+
+ /**
+ * Set margin left.
+ */
+ public function setInnerMarginLeft(?int $value = null): void
+ {
+ $this->innerMarginLeft = $value;
+ }
+
+ /**
+ * Get margin left.
+ */
+ public function getInnerMarginLeft(): ?int
+ {
+ return $this->innerMarginLeft;
+ }
+
+ /**
+ * Set margin right.
+ */
+ public function setInnerMarginRight(?int $value = null): void
+ {
+ $this->innerMarginRight = $value;
+ }
+
+ /**
+ * Get margin right.
+ */
+ public function getInnerMarginRight(): ?int
+ {
+ return $this->innerMarginRight;
+ }
+
+ /**
+ * Set margin bottom.
+ */
+ public function setInnerMarginBottom(?int $value = null): void
+ {
+ $this->innerMarginBottom = $value;
+ }
+
+ /**
+ * Get margin bottom.
+ */
+ public function getInnerMarginBottom(): ?int
+ {
+ return $this->innerMarginBottom;
+ }
+
+ /**
+ * Set TLRB cell margin.
+ *
+ * @param null|int $value Margin in twips
+ */
+ public function setInnerMargin(?int $value = null): void
+ {
+ $this->setInnerMarginTop($value);
+ $this->setInnerMarginLeft($value);
+ $this->setInnerMarginRight($value);
+ $this->setInnerMarginBottom($value);
+ }
+
+ /**
+ * Get cell margin.
+ *
+ * @return int[]
+ */
+ public function getInnerMargin(): array
+ {
+ return [$this->innerMarginLeft, $this->innerMarginTop, $this->innerMarginRight, $this->innerMarginBottom];
+ }
+
+ /**
+ * Has inner margin?
+ */
+ public function hasInnerMargins(): bool
+ {
+ $hasInnerMargins = false;
+ $margins = $this->getInnerMargin();
+ $numMargins = count($margins);
+ for ($i = 0; $i < $numMargins; ++$i) {
+ if ($margins[$i] !== null) {
+ $hasInnerMargins = true;
+ }
+ }
+
+ return $hasInnerMargins;
+ }
+
+ /**
+ * Set border size.
+ *
+ * @param null|int $value Size in points
+ */
+ public function setBorderSize(?int $value = null): void
+ {
+ $this->borderSize = $value;
+ }
+
+ /**
+ * Get border size.
+ */
+ public function getBorderSize(): ?int
+ {
+ return $this->borderSize;
+ }
+
+ /**
+ * Set border color.
+ */
+ public function setBorderColor(?string $value = null): void
+ {
+ $this->borderColor = $value;
+ }
+
+ /**
+ * Get border color.
+ */
+ public function getBorderColor(): ?string
+ {
+ return $this->borderColor;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/TemplateProcessor.php b/vendor/phpoffice/phpword/src/PhpWord/TemplateProcessor.php
new file mode 100644
index 00000000..f6fe1d88
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/TemplateProcessor.php
@@ -0,0 +1,1502 @@
+tempDocumentFilename = tempnam(Settings::getTempDir(), 'PhpWord');
+ if (false === $this->tempDocumentFilename) {
+ throw new CreateTemporaryFileException(); // @codeCoverageIgnore
+ }
+
+ // Template file cloning
+ if (false === copy($documentTemplate, $this->tempDocumentFilename)) {
+ throw new CopyFileException($documentTemplate, $this->tempDocumentFilename); // @codeCoverageIgnore
+ }
+
+ // Temporary document content extraction
+ $this->zipClass = new ZipArchive();
+ $this->zipClass->open($this->tempDocumentFilename);
+ $index = 1;
+ while (false !== $this->zipClass->locateName($this->getHeaderName($index))) {
+ $this->tempDocumentHeaders[$index] = $this->readPartWithRels($this->getHeaderName($index));
+ ++$index;
+ }
+ $index = 1;
+ while (false !== $this->zipClass->locateName($this->getFooterName($index))) {
+ $this->tempDocumentFooters[$index] = $this->readPartWithRels($this->getFooterName($index));
+ ++$index;
+ }
+
+ $this->tempDocumentMainPart = $this->readPartWithRels($this->getMainPartName());
+ $this->tempDocumentSettingsPart = $this->readPartWithRels($this->getSettingsPartName());
+ $this->tempDocumentContentTypes = $this->zipClass->getFromName($this->getDocumentContentTypesName());
+ }
+
+ public function __destruct()
+ {
+ // ZipClass
+ if ($this->zipClass) {
+ try {
+ $this->zipClass->close();
+ } catch (Throwable $e) {
+ // Nothing to do here.
+ }
+ }
+ }
+
+ /**
+ * Expose zip class.
+ *
+ * To replace an image: $templateProcessor->zip()->AddFromString("word/media/image1.jpg", file_get_contents($file));
+ * To read a file: $templateProcessor->zip()->getFromName("word/media/image1.jpg");
+ *
+ * @return \PhpOffice\PhpWord\Shared\ZipArchive
+ */
+ public function zip()
+ {
+ return $this->zipClass;
+ }
+
+ /**
+ * @param string $fileName
+ *
+ * @return string
+ */
+ protected function readPartWithRels($fileName)
+ {
+ $relsFileName = $this->getRelationsName($fileName);
+ $partRelations = $this->zipClass->getFromName($relsFileName);
+ if ($partRelations !== false) {
+ $this->tempDocumentRelations[$fileName] = $partRelations;
+ }
+
+ return $this->fixBrokenMacros($this->zipClass->getFromName($fileName));
+ }
+
+ /**
+ * @param string $xml
+ * @param XSLTProcessor $xsltProcessor
+ *
+ * @return string
+ */
+ protected function transformSingleXml($xml, $xsltProcessor)
+ {
+ if (\PHP_VERSION_ID < 80000) {
+ $orignalLibEntityLoader = libxml_disable_entity_loader(true);
+ }
+ $domDocument = new DOMDocument();
+ if (false === $domDocument->loadXML($xml)) {
+ throw new Exception('Could not load the given XML document.');
+ }
+
+ $transformedXml = $xsltProcessor->transformToXml($domDocument);
+ if (false === $transformedXml) {
+ throw new Exception('Could not transform the given XML document.');
+ }
+ if (\PHP_VERSION_ID < 80000) {
+ libxml_disable_entity_loader($orignalLibEntityLoader);
+ }
+
+ return $transformedXml;
+ }
+
+ /**
+ * @param mixed $xml
+ * @param XSLTProcessor $xsltProcessor
+ *
+ * @return mixed
+ */
+ protected function transformXml($xml, $xsltProcessor)
+ {
+ if (is_array($xml)) {
+ foreach ($xml as &$item) {
+ $item = $this->transformSingleXml($item, $xsltProcessor);
+ }
+ unset($item);
+ } else {
+ $xml = $this->transformSingleXml($xml, $xsltProcessor);
+ }
+
+ return $xml;
+ }
+
+ /**
+ * Applies XSL style sheet to template's parts.
+ *
+ * Note: since the method doesn't make any guess on logic of the provided XSL style sheet,
+ * make sure that output is correctly escaped. Otherwise you may get broken document.
+ *
+ * @param DOMDocument $xslDomDocument
+ * @param array $xslOptions
+ * @param string $xslOptionsUri
+ */
+ public function applyXslStyleSheet($xslDomDocument, $xslOptions = [], $xslOptionsUri = ''): void
+ {
+ $xsltProcessor = new XSLTProcessor();
+
+ $xsltProcessor->importStylesheet($xslDomDocument);
+ if (false === $xsltProcessor->setParameter($xslOptionsUri, $xslOptions)) {
+ throw new Exception('Could not set values for the given XSL style sheet parameters.');
+ }
+
+ $this->tempDocumentHeaders = $this->transformXml($this->tempDocumentHeaders, $xsltProcessor);
+ $this->tempDocumentMainPart = $this->transformXml($this->tempDocumentMainPart, $xsltProcessor);
+ $this->tempDocumentFooters = $this->transformXml($this->tempDocumentFooters, $xsltProcessor);
+ }
+
+ /**
+ * @param string $macro
+ *
+ * @return string
+ */
+ protected static function ensureMacroCompleted($macro)
+ {
+ if (substr($macro, 0, 2) !== self::$macroOpeningChars && substr($macro, -1) !== self::$macroClosingChars) {
+ $macro = self::$macroOpeningChars . $macro . self::$macroClosingChars;
+ }
+
+ return $macro;
+ }
+
+ /**
+ * @param ?string $subject
+ *
+ * @return string
+ */
+ protected static function ensureUtf8Encoded($subject)
+ {
+ return $subject ? Text::toUTF8($subject) : '';
+ }
+
+ /**
+ * @param string $search
+ */
+ public function setComplexValue($search, Element\AbstractElement $complexType): void
+ {
+ $elementName = substr(get_class($complexType), strrpos(get_class($complexType), '\\') + 1);
+ $objectClass = 'PhpOffice\\PhpWord\\Writer\\Word2007\\Element\\' . $elementName;
+
+ $xmlWriter = new XMLWriter();
+ /** @var \PhpOffice\PhpWord\Writer\Word2007\Element\AbstractElement $elementWriter */
+ $elementWriter = new $objectClass($xmlWriter, $complexType, true);
+ $elementWriter->write();
+
+ $where = $this->findContainingXmlBlockForMacro($search, 'w:r');
+
+ if ($where === false) {
+ return;
+ }
+
+ $block = $this->getSlice($where['start'], $where['end']);
+ $textParts = $this->splitTextIntoTexts($block);
+ $this->replaceXmlBlock($search, $textParts, 'w:r');
+
+ $search = static::ensureMacroCompleted($search);
+ $this->replaceXmlBlock($search, $xmlWriter->getData(), 'w:r');
+ }
+
+ /**
+ * @param string $search
+ */
+ public function setComplexBlock($search, Element\AbstractElement $complexType): void
+ {
+ $elementName = substr(get_class($complexType), strrpos(get_class($complexType), '\\') + 1);
+ $objectClass = 'PhpOffice\\PhpWord\\Writer\\Word2007\\Element\\' . $elementName;
+
+ $xmlWriter = new XMLWriter();
+ /** @var \PhpOffice\PhpWord\Writer\Word2007\Element\AbstractElement $elementWriter */
+ $elementWriter = new $objectClass($xmlWriter, $complexType, false);
+ $elementWriter->write();
+
+ $this->replaceXmlBlock($search, $xmlWriter->getData(), 'w:p');
+ }
+
+ /**
+ * @param mixed $search
+ * @param mixed $replace
+ * @param int $limit
+ */
+ public function setValue($search, $replace, $limit = self::MAXIMUM_REPLACEMENTS_DEFAULT): void
+ {
+ if (is_array($search)) {
+ foreach ($search as &$item) {
+ $item = static::ensureMacroCompleted($item);
+ }
+ unset($item);
+ } else {
+ $search = static::ensureMacroCompleted($search);
+ }
+
+ if (is_array($replace)) {
+ foreach ($replace as &$item) {
+ $item = static::ensureUtf8Encoded($item);
+ }
+ unset($item);
+ } else {
+ $replace = static::ensureUtf8Encoded($replace);
+ }
+
+ if (Settings::isOutputEscapingEnabled()) {
+ $xmlEscaper = new Xml();
+ $replace = $xmlEscaper->escape($replace);
+ }
+
+ // convert carriage returns
+ if (is_array($replace)) {
+ foreach ($replace as &$item) {
+ $item = $this->replaceCarriageReturns($item);
+ }
+ } else {
+ $replace = $this->replaceCarriageReturns($replace);
+ }
+
+ $this->tempDocumentHeaders = $this->setValueForPart($search, $replace, $this->tempDocumentHeaders, $limit);
+ $this->tempDocumentMainPart = $this->setValueForPart($search, $replace, $this->tempDocumentMainPart, $limit);
+ $this->tempDocumentFooters = $this->setValueForPart($search, $replace, $this->tempDocumentFooters, $limit);
+ }
+
+ /**
+ * Set values from a one-dimensional array of "variable => value"-pairs.
+ */
+ public function setValues(array $values): void
+ {
+ foreach ($values as $macro => $replace) {
+ $this->setValue($macro, $replace);
+ }
+ }
+
+ public function setCheckbox(string $search, bool $checked): void
+ {
+ $search = static::ensureMacroCompleted($search);
+ $blockType = 'w:sdt';
+
+ $where = $this->findContainingXmlBlockForMacro($search, $blockType);
+ if (!is_array($where)) {
+ return;
+ }
+
+ $block = $this->getSlice($where['start'], $where['end']);
+
+ $val = $checked ? '1' : '0';
+ $block = preg_replace('/()/', '$1"' . $val . '"$2', $block);
+
+ $text = $checked ? '☒' : '☐';
+ $block = preg_replace('/().*?(<\/w:t>)/', '$1' . $text . '$2', $block);
+
+ $this->replaceXmlBlock($search, $block, $blockType);
+ }
+
+ /**
+ * @param string $search
+ */
+ public function setChart($search, Element\AbstractElement $chart): void
+ {
+ $elementName = substr(get_class($chart), strrpos(get_class($chart), '\\') + 1);
+ $objectClass = 'PhpOffice\\PhpWord\\Writer\\Word2007\\Element\\' . $elementName;
+
+ // Get the next relation id
+ $rId = $this->getNextRelationsIndex($this->getMainPartName());
+ $chart->setRelationId($rId);
+
+ // Define the chart filename
+ $filename = "charts/chart{$rId}.xml";
+
+ // Get the part writer
+ $writerPart = new \PhpOffice\PhpWord\Writer\Word2007\Part\Chart();
+ $writerPart->setElement($chart);
+
+ // ContentTypes.xml
+ $this->zipClass->addFromString("word/{$filename}", $writerPart->write());
+
+ // add chart to content type
+ $xmlRelationsType = "";
+ $this->tempDocumentContentTypes = str_replace('', $xmlRelationsType, $this->tempDocumentContentTypes) . '';
+
+ // Add the chart to relations
+ $xmlChartRelation = "";
+ $this->tempDocumentRelations[$this->getMainPartName()] = str_replace('', $xmlChartRelation, $this->tempDocumentRelations[$this->getMainPartName()]) . '';
+
+ // Write the chart
+ $xmlWriter = new XMLWriter();
+ $elementWriter = new $objectClass($xmlWriter, $chart, true);
+ $elementWriter->write();
+
+ // Place it in the template
+ $this->replaceXmlBlock($search, '' . $xmlWriter->getData() . '', 'w:p');
+ }
+
+ private function getImageArgs($varNameWithArgs)
+ {
+ $varElements = explode(':', $varNameWithArgs);
+ array_shift($varElements); // first element is name of variable => remove it
+
+ $varInlineArgs = [];
+ // size format documentation: https://msdn.microsoft.com/en-us/library/documentformat.openxml.vml.shape%28v=office.14%29.aspx?f=255&MSPPError=-2147217396
+ foreach ($varElements as $argIdx => $varArg) {
+ if (strpos($varArg, '=')) { // arg=value
+ [$argName, $argValue] = explode('=', $varArg, 2);
+ $argName = strtolower($argName);
+ if ($argName == 'size') {
+ [$varInlineArgs['width'], $varInlineArgs['height']] = explode('x', $argValue, 2);
+ } else {
+ $varInlineArgs[strtolower($argName)] = $argValue;
+ }
+ } elseif (preg_match('/^([0-9]*[a-z%]{0,2}|auto)x([0-9]*[a-z%]{0,2}|auto)$/i', $varArg)) { // 60x40
+ [$varInlineArgs['width'], $varInlineArgs['height']] = explode('x', $varArg, 2);
+ } else { // :60:40:f
+ switch ($argIdx) {
+ case 0:
+ $varInlineArgs['width'] = $varArg;
+
+ break;
+ case 1:
+ $varInlineArgs['height'] = $varArg;
+
+ break;
+ case 2:
+ $varInlineArgs['ratio'] = $varArg;
+
+ break;
+ }
+ }
+ }
+
+ return $varInlineArgs;
+ }
+
+ private function chooseImageDimension($baseValue, $inlineValue, $defaultValue)
+ {
+ $value = $baseValue;
+ if (null === $value && isset($inlineValue)) {
+ $value = $inlineValue;
+ }
+ if (!preg_match('/^([0-9\.]*(cm|mm|in|pt|pc|px|%|em|ex|)|auto)$/i', $value ?? '')) {
+ $value = null;
+ }
+ if (null === $value) {
+ $value = $defaultValue;
+ }
+ if (is_numeric($value)) {
+ $value .= 'px';
+ }
+
+ return $value;
+ }
+
+ private function fixImageWidthHeightRatio(&$width, &$height, $actualWidth, $actualHeight): void
+ {
+ $imageRatio = $actualWidth / $actualHeight;
+
+ if (($width === '') && ($height === '')) { // defined size are empty
+ $width = $actualWidth . 'px';
+ $height = $actualHeight . 'px';
+ } elseif ($width === '') { // defined width is empty
+ $heightFloat = (float) $height;
+ $widthFloat = $heightFloat * $imageRatio;
+ $matches = [];
+ preg_match('/\\d([a-z%]+)$/', $height, $matches);
+ $width = $widthFloat . $matches[1];
+ } elseif ($height === '') { // defined height is empty
+ $widthFloat = (float) $width;
+ $heightFloat = $widthFloat / $imageRatio;
+ $matches = [];
+ preg_match('/\\d([a-z%]+)$/', $width, $matches);
+ $height = $heightFloat . $matches[1];
+ } else { // we have defined size, but we need also check it aspect ratio
+ $widthMatches = [];
+ preg_match('/\\d([a-z%]+)$/', $width, $widthMatches);
+ $heightMatches = [];
+ preg_match('/\\d([a-z%]+)$/', $height, $heightMatches);
+ // try to fix only if dimensions are same
+ if ($widthMatches[1] == $heightMatches[1]) {
+ $dimention = $widthMatches[1];
+ $widthFloat = (float) $width;
+ $heightFloat = (float) $height;
+ $definedRatio = $widthFloat / $heightFloat;
+
+ if ($imageRatio > $definedRatio) { // image wider than defined box
+ $height = ($widthFloat / $imageRatio) . $dimention;
+ } elseif ($imageRatio < $definedRatio) { // image higher than defined box
+ $width = ($heightFloat * $imageRatio) . $dimention;
+ }
+ }
+ }
+ }
+
+ private function prepareImageAttrs($replaceImage, $varInlineArgs)
+ {
+ // get image path and size
+ $width = null;
+ $height = null;
+ $ratio = null;
+
+ // a closure can be passed as replacement value which after resolving, can contain the replacement info for the image
+ // use case: only when a image if found, the replacement tags can be generated
+ if (is_callable($replaceImage)) {
+ $replaceImage = $replaceImage();
+ }
+
+ if (is_array($replaceImage) && isset($replaceImage['path'])) {
+ $imgPath = $replaceImage['path'];
+ if (isset($replaceImage['width'])) {
+ $width = $replaceImage['width'];
+ }
+ if (isset($replaceImage['height'])) {
+ $height = $replaceImage['height'];
+ }
+ if (isset($replaceImage['ratio'])) {
+ $ratio = $replaceImage['ratio'];
+ }
+ } else {
+ $imgPath = $replaceImage;
+ }
+
+ $width = $this->chooseImageDimension($width, $varInlineArgs['width'] ?? null, 115);
+ $height = $this->chooseImageDimension($height, $varInlineArgs['height'] ?? null, 70);
+
+ $imageData = @getimagesize($imgPath);
+ if (!is_array($imageData)) {
+ throw new Exception(sprintf('Invalid image: %s', $imgPath));
+ }
+ [$actualWidth, $actualHeight, $imageType] = $imageData;
+
+ // fix aspect ratio (by default)
+ if (null === $ratio && isset($varInlineArgs['ratio'])) {
+ $ratio = $varInlineArgs['ratio'];
+ }
+ if (null === $ratio || !in_array(strtolower($ratio), ['', '-', 'f', 'false'])) {
+ $this->fixImageWidthHeightRatio($width, $height, $actualWidth, $actualHeight);
+ }
+
+ $imageAttrs = [
+ 'src' => $imgPath,
+ 'mime' => image_type_to_mime_type($imageType),
+ 'width' => $width,
+ 'height' => $height,
+ ];
+
+ return $imageAttrs;
+ }
+
+ private function addImageToRelations($partFileName, $rid, $imgPath, $imageMimeType): void
+ {
+ // define templates
+ $typeTpl = '';
+ $relationTpl = '';
+ $newRelationsTpl = '' . "\n" . '';
+ $newRelationsTypeTpl = '';
+ $extTransform = [
+ 'image/jpeg' => 'jpeg',
+ 'image/png' => 'png',
+ 'image/bmp' => 'bmp',
+ 'image/gif' => 'gif',
+ ];
+
+ // get image embed name
+ if (isset($this->tempDocumentNewImages[$imgPath])) {
+ $imgName = $this->tempDocumentNewImages[$imgPath];
+ } else {
+ // transform extension
+ if (isset($extTransform[$imageMimeType])) {
+ $imgExt = $extTransform[$imageMimeType];
+ } else {
+ throw new Exception("Unsupported image type $imageMimeType");
+ }
+
+ // add image to document
+ $imgName = 'image_' . $rid . '_' . pathinfo($partFileName, PATHINFO_FILENAME) . '.' . $imgExt;
+ $this->zipClass->pclzipAddFile($imgPath, 'word/media/' . $imgName);
+ $this->tempDocumentNewImages[$imgPath] = $imgName;
+
+ // setup type for image
+ $xmlImageType = str_replace(['{IMG}', '{EXT}'], [$imgName, $imgExt], $typeTpl);
+ $this->tempDocumentContentTypes = str_replace('', $xmlImageType, $this->tempDocumentContentTypes) . '';
+ }
+
+ $xmlImageRelation = str_replace(['{RID}', '{IMG}'], [$rid, $imgName], $relationTpl);
+
+ if (!isset($this->tempDocumentRelations[$partFileName])) {
+ // create new relations file
+ $this->tempDocumentRelations[$partFileName] = $newRelationsTpl;
+ // and add it to content types
+ $xmlRelationsType = str_replace('{RELS}', $this->getRelationsName($partFileName), $newRelationsTypeTpl);
+ $this->tempDocumentContentTypes = str_replace('', $xmlRelationsType, $this->tempDocumentContentTypes) . '';
+ }
+
+ // add image to relations
+ $this->tempDocumentRelations[$partFileName] = str_replace('', $xmlImageRelation, $this->tempDocumentRelations[$partFileName]) . '';
+ }
+
+ /**
+ * @param mixed $search
+ * @param mixed $replace Path to image, or array("path" => xx, "width" => yy, "height" => zz)
+ * @param int $limit
+ */
+ public function setImageValue($search, $replace, $limit = self::MAXIMUM_REPLACEMENTS_DEFAULT): void
+ {
+ // prepare $search_replace
+ if (!is_array($search)) {
+ $search = [$search];
+ }
+
+ $replacesList = [];
+ if (!is_array($replace) || isset($replace['path'])) {
+ $replacesList[] = $replace;
+ } else {
+ $replacesList = array_values($replace);
+ }
+
+ $searchReplace = [];
+ foreach ($search as $searchIdx => $searchString) {
+ $searchReplace[$searchString] = $replacesList[$searchIdx] ?? $replacesList[0];
+ }
+
+ // collect document parts
+ $searchParts = [
+ $this->getMainPartName() => &$this->tempDocumentMainPart,
+ ];
+ foreach (array_keys($this->tempDocumentHeaders) as $headerIndex) {
+ $searchParts[$this->getHeaderName($headerIndex)] = &$this->tempDocumentHeaders[$headerIndex];
+ }
+ foreach (array_keys($this->tempDocumentFooters) as $footerIndex) {
+ $searchParts[$this->getFooterName($footerIndex)] = &$this->tempDocumentFooters[$footerIndex];
+ }
+
+ // define templates
+ // result can be verified via "Open XML SDK 2.5 Productivity Tool" (http://www.microsoft.com/en-us/download/details.aspx?id=30425)
+ $imgTpl = '';
+
+ $i = 0;
+ foreach ($searchParts as $partFileName => &$partContent) {
+ $partVariables = $this->getVariablesForPart($partContent);
+
+ foreach ($searchReplace as $searchString => $replaceImage) {
+ $varsToReplace = array_filter($partVariables, function ($partVar) use ($searchString) {
+ return ($partVar == $searchString) || preg_match('/^' . preg_quote($searchString) . ':/', $partVar);
+ });
+
+ foreach ($varsToReplace as $varNameWithArgs) {
+ $varInlineArgs = $this->getImageArgs($varNameWithArgs);
+ $preparedImageAttrs = $this->prepareImageAttrs($replaceImage, $varInlineArgs);
+ $imgPath = $preparedImageAttrs['src'];
+
+ // get image index
+ $imgIndex = $this->getNextRelationsIndex($partFileName);
+ $rid = 'rId' . $imgIndex;
+
+ // replace preparations
+ $this->addImageToRelations($partFileName, $rid, $imgPath, $preparedImageAttrs['mime']);
+ $xmlImage = str_replace(['{RID}', '{WIDTH}', '{HEIGHT}'], [$rid, $preparedImageAttrs['width'], $preparedImageAttrs['height']], $imgTpl);
+
+ // replace variable
+ $varNameWithArgsFixed = static::ensureMacroCompleted($varNameWithArgs);
+ $matches = [];
+ if (preg_match('/(<[^<]+>)([^<]*)(' . preg_quote($varNameWithArgsFixed) . ')([^>]*)(<[^>]+>)/Uu', $partContent, $matches)) {
+ $wholeTag = $matches[0];
+ array_shift($matches);
+ [$openTag, $prefix, , $postfix, $closeTag] = $matches;
+ $replaceXml = $openTag . $prefix . $closeTag . $xmlImage . $openTag . $postfix . $closeTag;
+ // replace on each iteration, because in one tag we can have 2+ inline variables => before proceed next variable we need to change $partContent
+ $partContent = $this->setValueForPart($wholeTag, $replaceXml, $partContent, $limit);
+ }
+
+ if (++$i >= $limit) {
+ break;
+ }
+ }
+ }
+ }
+ }
+
+ /**
+ * Returns count of all variables in template.
+ *
+ * @return array
+ */
+ public function getVariableCount()
+ {
+ $variables = $this->getVariablesForPart($this->tempDocumentMainPart);
+
+ foreach ($this->tempDocumentHeaders as $headerXML) {
+ $variables = array_merge(
+ $variables,
+ $this->getVariablesForPart($headerXML)
+ );
+ }
+
+ foreach ($this->tempDocumentFooters as $footerXML) {
+ $variables = array_merge(
+ $variables,
+ $this->getVariablesForPart($footerXML)
+ );
+ }
+
+ return array_count_values($variables);
+ }
+
+ /**
+ * Returns array of all variables in template.
+ *
+ * @return string[]
+ */
+ public function getVariables()
+ {
+ return array_keys($this->getVariableCount());
+ }
+
+ /**
+ * Clone a table row in a template document.
+ *
+ * @param string $search
+ * @param int $numberOfClones
+ */
+ public function cloneRow($search, $numberOfClones): void
+ {
+ $search = static::ensureMacroCompleted($search);
+
+ $tagPos = strpos($this->tempDocumentMainPart, $search);
+ if (!$tagPos) {
+ throw new Exception('Can not clone row, template variable not found or variable contains markup.');
+ }
+
+ $rowStart = $this->findRowStart($tagPos);
+ $rowEnd = $this->findRowEnd($tagPos);
+ $xmlRow = $this->getSlice($rowStart, $rowEnd);
+
+ // Check if there's a cell spanning multiple rows.
+ if (preg_match('##', $xmlRow)) {
+ // $extraRowStart = $rowEnd;
+ $extraRowEnd = $rowEnd;
+ while (true) {
+ $extraRowStart = $this->findRowStart($extraRowEnd + 1);
+ $extraRowEnd = $this->findRowEnd($extraRowEnd + 1);
+
+ // If extraRowEnd is lower then 7, there was no next row found.
+ if ($extraRowEnd < 7) {
+ break;
+ }
+
+ // If tmpXmlRow doesn't contain continue, this row is no longer part of the spanned row.
+ $tmpXmlRow = $this->getSlice($extraRowStart, $extraRowEnd);
+ if (!preg_match('##', $tmpXmlRow) &&
+ !preg_match('##', $tmpXmlRow)
+ ) {
+ break;
+ }
+ // This row was a spanned row, update $rowEnd and search for the next row.
+ $rowEnd = $extraRowEnd;
+ }
+ $xmlRow = $this->getSlice($rowStart, $rowEnd);
+ }
+
+ $result = $this->getSlice(0, $rowStart);
+ $result .= implode('', $this->indexClonedVariables($numberOfClones, $xmlRow));
+ $result .= $this->getSlice($rowEnd);
+
+ $this->tempDocumentMainPart = $result;
+ }
+
+ /**
+ * Delete a table row in a template document.
+ */
+ public function deleteRow(string $search): void
+ {
+ if (self::$macroOpeningChars !== substr($search, 0, 2) && self::$macroClosingChars !== substr($search, -1)) {
+ $search = self::$macroOpeningChars . $search . self::$macroClosingChars;
+ }
+
+ $tagPos = strpos($this->tempDocumentMainPart, $search);
+ if (!$tagPos) {
+ throw new Exception(sprintf('Can not delete row %s, template variable not found or variable contains markup.', $search));
+ }
+
+ $tableStart = $this->findTableStart($tagPos);
+ $tableEnd = $this->findTableEnd($tagPos);
+ $xmlTable = $this->getSlice($tableStart, $tableEnd);
+
+ if (substr_count($xmlTable, 'tempDocumentMainPart = $this->getSlice(0, $tableStart) . $this->getSlice($tableEnd);
+
+ return;
+ }
+
+ $rowStart = $this->findRowStart($tagPos);
+ $rowEnd = $this->findRowEnd($tagPos);
+ $xmlRow = $this->getSlice($rowStart, $rowEnd);
+
+ $this->tempDocumentMainPart = $this->getSlice(0, $rowStart) . $this->getSlice($rowEnd);
+
+ // Check if there's a cell spanning multiple rows.
+ if (preg_match('##', $xmlRow)) {
+ $extraRowStart = $rowStart;
+ while (true) {
+ $extraRowStart = $this->findRowStart($extraRowStart + 1);
+ $extraRowEnd = $this->findRowEnd($extraRowStart + 1);
+
+ // If extraRowEnd is lower then 7, there was no next row found.
+ if ($extraRowEnd < 7) {
+ break;
+ }
+
+ // If tmpXmlRow doesn't contain continue, this row is no longer part of the spanned row.
+ $tmpXmlRow = $this->getSlice($extraRowStart, $extraRowEnd);
+ if (!preg_match('##', $tmpXmlRow) &&
+ !preg_match('##', $tmpXmlRow)
+ ) {
+ break;
+ }
+
+ $tableStart = $this->findTableStart($extraRowEnd + 1);
+ $tableEnd = $this->findTableEnd($extraRowEnd + 1);
+ $xmlTable = $this->getSlice($tableStart, $tableEnd);
+ if (substr_count($xmlTable, 'tempDocumentMainPart = $this->getSlice(0, $tableStart) . $this->getSlice($tableEnd);
+
+ return;
+ }
+
+ $this->tempDocumentMainPart = $this->getSlice(0, $extraRowStart) . $this->getSlice($extraRowEnd);
+ }
+ }
+ }
+
+ /**
+ * Clones a table row and populates it's values from a two-dimensional array in a template document.
+ *
+ * @param string $search
+ * @param array $values
+ */
+ public function cloneRowAndSetValues($search, $values): void
+ {
+ $this->cloneRow($search, count($values));
+
+ foreach ($values as $rowKey => $rowData) {
+ $rowNumber = $rowKey + 1;
+ foreach ($rowData as $macro => $replace) {
+ $this->setValue($macro . '#' . $rowNumber, $replace);
+ }
+ }
+ }
+
+ /**
+ * Clone a block.
+ *
+ * @param string $blockname
+ * @param int $clones How many time the block should be cloned
+ * @param bool $replace
+ * @param bool $indexVariables If true, any variables inside the block will be indexed (postfixed with #1, #2, ...)
+ * @param array $variableReplacements Array containing replacements for macros found inside the block to clone
+ *
+ * @return null|string
+ */
+ public function cloneBlock($blockname, $clones = 1, $replace = true, $indexVariables = false, $variableReplacements = null)
+ {
+ $xmlBlock = null;
+ $matches = [];
+ $escapedMacroOpeningChars = self::$macroOpeningChars;
+ $escapedMacroClosingChars = self::$macroClosingChars;
+ preg_match(
+ //'/(.*((?s)))(.*)((?s))/is',
+ '/(.*((?s)))(.*)((?s))/is',
+ //'/(.*((?s)))(.*)((?s))/is',
+ $this->tempDocumentMainPart,
+ $matches
+ );
+
+ if (isset($matches[3])) {
+ $xmlBlock = $matches[3];
+ if ($indexVariables) {
+ $cloned = $this->indexClonedVariables($clones, $xmlBlock);
+ } elseif ($variableReplacements !== null && is_array($variableReplacements)) {
+ $cloned = $this->replaceClonedVariables($variableReplacements, $xmlBlock);
+ } else {
+ $cloned = [];
+ for ($i = 1; $i <= $clones; ++$i) {
+ $cloned[] = $xmlBlock;
+ }
+ }
+
+ if ($replace) {
+ $this->tempDocumentMainPart = str_replace(
+ $matches[2] . $matches[3] . $matches[4],
+ implode('', $cloned),
+ $this->tempDocumentMainPart
+ );
+ }
+ }
+
+ return $xmlBlock;
+ }
+
+ /**
+ * Replace a block.
+ *
+ * @param string $blockname
+ * @param string $replacement
+ */
+ public function replaceBlock($blockname, $replacement): void
+ {
+ $matches = [];
+ $escapedMacroOpeningChars = preg_quote(self::$macroOpeningChars);
+ $escapedMacroClosingChars = preg_quote(self::$macroClosingChars);
+ preg_match(
+ '/(<\?xml.*)(' . $escapedMacroOpeningChars . $blockname . $escapedMacroClosingChars . '<\/w:.*?p>)(.*)()/is',
+ $this->tempDocumentMainPart,
+ $matches
+ );
+
+ if (isset($matches[3])) {
+ $this->tempDocumentMainPart = str_replace(
+ $matches[2] . $matches[3] . $matches[4],
+ $replacement,
+ $this->tempDocumentMainPart
+ );
+ }
+ }
+
+ /**
+ * Delete a block of text.
+ *
+ * @param string $blockname
+ */
+ public function deleteBlock($blockname): void
+ {
+ $this->replaceBlock($blockname, '');
+ }
+
+ /**
+ * Automatically Recalculate Fields on Open.
+ *
+ * @param bool $update
+ */
+ public function setUpdateFields($update = true): void
+ {
+ $string = $update ? 'true' : 'false';
+ $matches = [];
+ if (preg_match('//', $this->tempDocumentSettingsPart, $matches)) {
+ $this->tempDocumentSettingsPart = str_replace($matches[0], '', $this->tempDocumentSettingsPart);
+ } else {
+ $this->tempDocumentSettingsPart = str_replace('', '', $this->tempDocumentSettingsPart);
+ }
+ }
+
+ /**
+ * Saves the result document.
+ *
+ * @return string
+ */
+ public function save()
+ {
+ foreach ($this->tempDocumentHeaders as $index => $xml) {
+ $this->savePartWithRels($this->getHeaderName($index), $xml);
+ }
+
+ $this->savePartWithRels($this->getMainPartName(), $this->tempDocumentMainPart);
+ $this->savePartWithRels($this->getSettingsPartName(), $this->tempDocumentSettingsPart);
+
+ foreach ($this->tempDocumentFooters as $index => $xml) {
+ $this->savePartWithRels($this->getFooterName($index), $xml);
+ }
+
+ $this->zipClass->addFromString($this->getDocumentContentTypesName(), $this->tempDocumentContentTypes);
+
+ // Close zip file
+ if (false === $this->zipClass->close()) {
+ throw new Exception('Could not close zip file.'); // @codeCoverageIgnore
+ }
+
+ return $this->tempDocumentFilename;
+ }
+
+ /**
+ * @param string $fileName
+ * @param string $xml
+ */
+ protected function savePartWithRels($fileName, $xml): void
+ {
+ $this->zipClass->addFromString($fileName, $xml);
+ if (isset($this->tempDocumentRelations[$fileName])) {
+ $relsFileName = $this->getRelationsName($fileName);
+ $this->zipClass->addFromString($relsFileName, $this->tempDocumentRelations[$fileName]);
+ }
+ }
+
+ /**
+ * Saves the result document to the user defined file.
+ *
+ * @since 0.8.0
+ *
+ * @param string $fileName
+ */
+ public function saveAs($fileName): void
+ {
+ $tempFileName = $this->save();
+
+ if (file_exists($fileName)) {
+ unlink($fileName);
+ }
+
+ /*
+ * Note: we do not use `rename` function here, because it loses file ownership data on Windows platform.
+ * As a result, user cannot open the file directly getting "Access denied" message.
+ *
+ * @see https://github.com/PHPOffice/PHPWord/issues/532
+ */
+ copy($tempFileName, $fileName);
+ unlink($tempFileName);
+ }
+
+ /**
+ * Finds parts of broken macros and sticks them together.
+ * Macros, while being edited, could be implicitly broken by some of the word processors.
+ *
+ * @param string $documentPart The document part in XML representation
+ *
+ * @return string
+ */
+ protected function fixBrokenMacros($documentPart)
+ {
+ $brokenMacroOpeningChars = substr(self::$macroOpeningChars, 0, 1);
+ $endMacroOpeningChars = substr(self::$macroOpeningChars, 1);
+ $macroClosingChars = self::$macroClosingChars;
+
+ return preg_replace_callback(
+ '/\\' . $brokenMacroOpeningChars . '(?:\\' . $endMacroOpeningChars . '|[^{$]*\>\{)[^' . $macroClosingChars . '$]*\}/U',
+ function ($match) {
+ return strip_tags($match[0]);
+ },
+ $documentPart
+ );
+ }
+
+ /**
+ * Find and replace macros in the given XML section.
+ *
+ * @param mixed $search
+ * @param mixed $replace
+ * @param array|string $documentPartXML
+ * @param int $limit
+ *
+ * @return string
+ */
+ protected function setValueForPart($search, $replace, $documentPartXML, $limit)
+ {
+ // Note: we can't use the same function for both cases here, because of performance considerations.
+ if (self::MAXIMUM_REPLACEMENTS_DEFAULT === $limit) {
+ return str_replace($search, $replace, $documentPartXML);
+ }
+ $regExpEscaper = new RegExp();
+
+ return preg_replace($regExpEscaper->escape($search), $replace, $documentPartXML, $limit);
+ }
+
+ /**
+ * Find all variables in $documentPartXML.
+ *
+ * @param string $documentPartXML
+ *
+ * @return string[]
+ */
+ protected function getVariablesForPart($documentPartXML)
+ {
+ $matches = [];
+ $escapedMacroOpeningChars = preg_quote(self::$macroOpeningChars);
+ $escapedMacroClosingChars = preg_quote(self::$macroClosingChars);
+
+ preg_match_all("/$escapedMacroOpeningChars(.*?)$escapedMacroClosingChars/i", $documentPartXML, $matches);
+
+ return $matches[1];
+ }
+
+ /**
+ * Get the name of the header file for $index.
+ *
+ * @param int $index
+ *
+ * @return string
+ */
+ protected function getHeaderName($index)
+ {
+ return sprintf('word/header%d.xml', $index);
+ }
+
+ /**
+ * Usually, the name of main part document will be 'document.xml'. However, some .docx files (possibly those from Office 365, experienced also on documents from Word Online created from blank templates) have file 'document22.xml' in their zip archive instead of 'document.xml'. This method searches content types file to correctly determine the file name.
+ *
+ * @return string
+ */
+ protected function getMainPartName()
+ {
+ $contentTypes = $this->zipClass->getFromName('[Content_Types].xml');
+
+ $pattern = '~PartName="\/(word\/document.*?\.xml)" ContentType="application\/vnd\.openxmlformats-officedocument\.wordprocessingml\.document\.main\+xml"~';
+
+ $matches = [];
+ preg_match($pattern, $contentTypes, $matches);
+
+ return array_key_exists(1, $matches) ? $matches[1] : 'word/document.xml';
+ }
+
+ /**
+ * The name of the file containing the Settings part.
+ *
+ * @return string
+ */
+ protected function getSettingsPartName()
+ {
+ return 'word/settings.xml';
+ }
+
+ /**
+ * Get the name of the footer file for $index.
+ *
+ * @param int $index
+ *
+ * @return string
+ */
+ protected function getFooterName($index)
+ {
+ return sprintf('word/footer%d.xml', $index);
+ }
+
+ /**
+ * Get the name of the relations file for document part.
+ *
+ * @param string $documentPartName
+ *
+ * @return string
+ */
+ protected function getRelationsName($documentPartName)
+ {
+ return 'word/_rels/' . pathinfo($documentPartName, PATHINFO_BASENAME) . '.rels';
+ }
+
+ protected function getNextRelationsIndex($documentPartName)
+ {
+ if (isset($this->tempDocumentRelations[$documentPartName])) {
+ $candidate = substr_count($this->tempDocumentRelations[$documentPartName], 'tempDocumentRelations[$documentPartName], 'Id="rId' . $candidate . '"') !== false) {
+ ++$candidate;
+ }
+
+ return $candidate;
+ }
+
+ return 1;
+ }
+
+ /**
+ * @return string
+ */
+ protected function getDocumentContentTypesName()
+ {
+ return '[Content_Types].xml';
+ }
+
+ /**
+ * Find the start position of the nearest table before $offset.
+ */
+ private function findTableStart(int $offset): int
+ {
+ $rowStart = strrpos(
+ $this->tempDocumentMainPart,
+ 'tempDocumentMainPart) - $offset) * -1)
+ );
+
+ if (!$rowStart) {
+ $rowStart = strrpos(
+ $this->tempDocumentMainPart,
+ '',
+ ((strlen($this->tempDocumentMainPart) - $offset) * -1)
+ );
+ }
+ if (!$rowStart) {
+ throw new Exception('Can not find the start position of the table.');
+ }
+
+ return $rowStart;
+ }
+
+ /**
+ * Find the end position of the nearest table row after $offset.
+ */
+ private function findTableEnd(int $offset): int
+ {
+ return strpos($this->tempDocumentMainPart, '', $offset) + 7;
+ }
+
+ /**
+ * Find the start position of the nearest table row before $offset.
+ *
+ * @param int $offset
+ *
+ * @return int
+ */
+ protected function findRowStart($offset)
+ {
+ $rowStart = strrpos($this->tempDocumentMainPart, 'tempDocumentMainPart) - $offset) * -1));
+
+ if (!$rowStart) {
+ $rowStart = strrpos($this->tempDocumentMainPart, '', ((strlen($this->tempDocumentMainPart) - $offset) * -1));
+ }
+ if (!$rowStart) {
+ throw new Exception('Can not find the start position of the row to clone.');
+ }
+
+ return $rowStart;
+ }
+
+ /**
+ * Find the end position of the nearest table row after $offset.
+ *
+ * @param int $offset
+ *
+ * @return int
+ */
+ protected function findRowEnd($offset)
+ {
+ return strpos($this->tempDocumentMainPart, '', $offset) + 7;
+ }
+
+ /**
+ * Get a slice of a string.
+ *
+ * @param int $startPosition
+ * @param int $endPosition
+ *
+ * @return string
+ */
+ protected function getSlice($startPosition, $endPosition = 0)
+ {
+ if (!$endPosition) {
+ $endPosition = strlen($this->tempDocumentMainPart);
+ }
+
+ return substr($this->tempDocumentMainPart, $startPosition, ($endPosition - $startPosition));
+ }
+
+ /**
+ * Replaces variable names in cloned
+ * rows/blocks with indexed names.
+ *
+ * @param int $count
+ * @param string $xmlBlock
+ *
+ * @return string
+ */
+ protected function indexClonedVariables($count, $xmlBlock)
+ {
+ $results = [];
+ $escapedMacroOpeningChars = preg_quote(self::$macroOpeningChars);
+ $escapedMacroClosingChars = preg_quote(self::$macroClosingChars);
+
+ for ($i = 1; $i <= $count; ++$i) {
+ $results[] = preg_replace("/$escapedMacroOpeningChars([^:]*?)(:.*?)?$escapedMacroClosingChars/", self::$macroOpeningChars . '\1#' . $i . '\2' . self::$macroClosingChars, $xmlBlock);
+ }
+
+ return $results;
+ }
+
+ /**
+ * Replace carriage returns with xml.
+ */
+ public function replaceCarriageReturns(string $string): string
+ {
+ return str_replace(["\r\n", "\r", "\n"], '', $string);
+ }
+
+ /**
+ * Replaces variables with values from array, array keys are the variable names.
+ *
+ * @param array $variableReplacements
+ * @param string $xmlBlock
+ *
+ * @return string[]
+ */
+ protected function replaceClonedVariables($variableReplacements, $xmlBlock)
+ {
+ $results = [];
+ foreach ($variableReplacements as $replacementArray) {
+ $localXmlBlock = $xmlBlock;
+ foreach ($replacementArray as $search => $replacement) {
+ $localXmlBlock = $this->setValueForPart(self::ensureMacroCompleted($search), $replacement, $localXmlBlock, self::MAXIMUM_REPLACEMENTS_DEFAULT);
+ }
+ $results[] = $localXmlBlock;
+ }
+
+ return $results;
+ }
+
+ /**
+ * Replace an XML block surrounding a macro with a new block.
+ *
+ * @param string $macro Name of macro
+ * @param string $block New block content
+ * @param string $blockType XML tag type of block
+ *
+ * @return \PhpOffice\PhpWord\TemplateProcessor Fluent interface
+ */
+ public function replaceXmlBlock($macro, $block, $blockType = 'w:p')
+ {
+ $where = $this->findContainingXmlBlockForMacro($macro, $blockType);
+ if (is_array($where)) {
+ $this->tempDocumentMainPart = $this->getSlice(0, $where['start']) . $block . $this->getSlice($where['end']);
+ }
+
+ return $this;
+ }
+
+ /**
+ * Find start and end of XML block containing the given macro
+ * e.g. ...${macro}....
+ *
+ * Note that only the first instance of the macro will be found
+ *
+ * @param string $macro Name of macro
+ * @param string $blockType XML tag for block
+ *
+ * @return bool|int[] FALSE if not found, otherwise array with start and end
+ */
+ protected function findContainingXmlBlockForMacro($macro, $blockType = 'w:p')
+ {
+ $macroPos = $this->findMacro($macro);
+ if (0 > $macroPos) {
+ return false;
+ }
+ $start = $this->findXmlBlockStart($macroPos, $blockType);
+ if (0 > $start) {
+ return false;
+ }
+ $end = $this->findXmlBlockEnd($start, $blockType);
+ //if not found or if resulting string does not contain the macro we are searching for
+ if (0 > $end || strstr($this->getSlice($start, $end), $macro) === false) {
+ return false;
+ }
+
+ return ['start' => $start, 'end' => $end];
+ }
+
+ /**
+ * Find the position of (the start of) a macro.
+ *
+ * Returns -1 if not found, otherwise position of opening $
+ *
+ * Note that only the first instance of the macro will be found
+ *
+ * @param string $search Macro name
+ * @param int $offset Offset from which to start searching
+ *
+ * @return int -1 if macro not found
+ */
+ protected function findMacro($search, $offset = 0)
+ {
+ $search = static::ensureMacroCompleted($search);
+ $pos = strpos($this->tempDocumentMainPart, $search, $offset);
+
+ return ($pos === false) ? -1 : $pos;
+ }
+
+ /**
+ * Find the start position of the nearest XML block start before $offset.
+ *
+ * @param int $offset Search position
+ * @param string $blockType XML Block tag
+ *
+ * @return int -1 if block start not found
+ */
+ protected function findXmlBlockStart($offset, $blockType)
+ {
+ $reverseOffset = (strlen($this->tempDocumentMainPart) - $offset) * -1;
+ // first try XML tag with attributes
+ $blockStart = strrpos($this->tempDocumentMainPart, '<' . $blockType . ' ', $reverseOffset);
+ // if not found, or if found but contains the XML tag without attribute
+ if (false === $blockStart || strrpos($this->getSlice($blockStart, $offset), '<' . $blockType . '>')) {
+ // also try XML tag without attributes
+ $blockStart = strrpos($this->tempDocumentMainPart, '<' . $blockType . '>', $reverseOffset);
+ }
+
+ return ($blockStart === false) ? -1 : $blockStart;
+ }
+
+ /**
+ * Find the nearest block end position after $offset.
+ *
+ * @param int $offset Search position
+ * @param string $blockType XML Block tag
+ *
+ * @return int -1 if block end not found
+ */
+ protected function findXmlBlockEnd($offset, $blockType)
+ {
+ $blockEndStart = strpos($this->tempDocumentMainPart, '', $offset);
+ // return position of end of tag if found, otherwise -1
+
+ return ($blockEndStart === false) ? -1 : $blockEndStart + 3 + strlen($blockType);
+ }
+
+ /**
+ * Splits a w:r/w:t into a list of w:r where each ${macro} is in a separate w:r.
+ *
+ * @param string $text
+ *
+ * @return string
+ */
+ protected function splitTextIntoTexts($text)
+ {
+ if (!$this->textNeedsSplitting($text)) {
+ return $text;
+ }
+ $matches = [];
+ if (preg_match('/()/i', $text, $matches)) {
+ $extractedStyle = $matches[0];
+ } else {
+ $extractedStyle = '';
+ }
+
+ $unformattedText = preg_replace('/>\s+<', $text);
+ $result = str_replace([self::$macroOpeningChars, self::$macroClosingChars], ['' . $extractedStyle . '' . self::$macroOpeningChars, self::$macroClosingChars . '' . $extractedStyle . ''], $unformattedText);
+
+ return str_replace(['' . $extractedStyle . '', '', ''], ['', '', ''], $result);
+ }
+
+ /**
+ * Returns true if string contains a macro that is not in it's own w:r.
+ *
+ * @param string $text
+ *
+ * @return bool
+ */
+ protected function textNeedsSplitting($text)
+ {
+ $escapedMacroOpeningChars = preg_quote(self::$macroOpeningChars);
+ $escapedMacroClosingChars = preg_quote(self::$macroClosingChars);
+
+ return 1 === preg_match('/[^>]' . $escapedMacroOpeningChars . '|' . $escapedMacroClosingChars . '[^<]/i', $text);
+ }
+
+ public function setMacroOpeningChars(string $macroOpeningChars): void
+ {
+ self::$macroOpeningChars = $macroOpeningChars;
+ }
+
+ public function setMacroClosingChars(string $macroClosingChars): void
+ {
+ self::$macroClosingChars = $macroClosingChars;
+ }
+
+ public function setMacroChars(string $macroOpeningChars, string $macroClosingChars): void
+ {
+ self::$macroOpeningChars = $macroOpeningChars;
+ self::$macroClosingChars = $macroClosingChars;
+ }
+
+ public function getTempDocumentFilename(): string
+ {
+ return $this->tempDocumentFilename;
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Writer/AbstractWriter.php b/vendor/phpoffice/phpword/src/PhpWord/Writer/AbstractWriter.php
new file mode 100644
index 00000000..8ebf98c7
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Writer/AbstractWriter.php
@@ -0,0 +1,411 @@
+ '', 'object' => ''];
+
+ /**
+ * Use disk caching.
+ *
+ * @var bool
+ */
+ private $useDiskCaching = false;
+
+ /**
+ * Disk caching directory.
+ *
+ * @var string
+ */
+ private $diskCachingDirectory = './';
+
+ /**
+ * Temporary directory.
+ *
+ * @var string
+ */
+ private $tempDir = '';
+
+ /**
+ * Original file name.
+ *
+ * @var string
+ */
+ private $originalFilename;
+
+ /**
+ * Temporary file name.
+ *
+ * @var string
+ */
+ private $tempFilename;
+
+ /**
+ * Get PhpWord object.
+ *
+ * @return \PhpOffice\PhpWord\PhpWord
+ */
+ public function getPhpWord()
+ {
+ if (null !== $this->phpWord) {
+ return $this->phpWord;
+ }
+
+ throw new Exception('No PhpWord assigned.');
+ }
+
+ /**
+ * Set PhpWord object.
+ *
+ * @param \PhpOffice\PhpWord\PhpWord
+ *
+ * @return self
+ */
+ public function setPhpWord(?PhpWord $phpWord = null)
+ {
+ $this->phpWord = $phpWord;
+
+ return $this;
+ }
+
+ /**
+ * Get writer part.
+ *
+ * @param string $partName Writer part name
+ *
+ * @return mixed
+ */
+ public function getWriterPart($partName = '')
+ {
+ if ($partName != '' && isset($this->writerParts[strtolower($partName)])) {
+ return $this->writerParts[strtolower($partName)];
+ }
+
+ return null;
+ }
+
+ /**
+ * Get use disk caching status.
+ *
+ * @return bool
+ */
+ public function isUseDiskCaching()
+ {
+ return $this->useDiskCaching;
+ }
+
+ /**
+ * Set use disk caching status.
+ *
+ * @param bool $value
+ * @param string $directory
+ *
+ * @return self
+ */
+ public function setUseDiskCaching($value = false, $directory = null)
+ {
+ $this->useDiskCaching = $value;
+
+ if (null !== $directory) {
+ if (is_dir($directory)) {
+ $this->diskCachingDirectory = $directory;
+ } else {
+ throw new Exception("Directory does not exist: $directory");
+ }
+ }
+
+ return $this;
+ }
+
+ /**
+ * Get disk caching directory.
+ *
+ * @return string
+ */
+ public function getDiskCachingDirectory()
+ {
+ return $this->diskCachingDirectory;
+ }
+
+ /**
+ * Get temporary directory.
+ *
+ * @return string
+ */
+ public function getTempDir()
+ {
+ return $this->tempDir;
+ }
+
+ /**
+ * Set temporary directory.
+ *
+ * @param string $value
+ *
+ * @return self
+ */
+ public function setTempDir($value)
+ {
+ if (!is_dir($value)) {
+ mkdir($value);
+ }
+ $this->tempDir = $value;
+
+ return $this;
+ }
+
+ /**
+ * Get temporary file name.
+ *
+ * If $filename is php://output or php://stdout, make it a temporary file
+ *
+ * @param string $filename
+ *
+ * @return string
+ */
+ protected function getTempFile($filename)
+ {
+ // Temporary directory
+ $this->setTempDir(Settings::getTempDir() . uniqid('/PHPWordWriter_', true) . '/');
+
+ // Temporary file
+ $this->originalFilename = $filename;
+ if (strpos(strtolower($filename), 'php://') === 0) {
+ $filename = tempnam(Settings::getTempDir(), 'PhpWord');
+ if (false === $filename) {
+ $filename = $this->originalFilename; // @codeCoverageIgnore
+ } // @codeCoverageIgnore
+ }
+ $this->tempFilename = $filename;
+
+ return $this->tempFilename;
+ }
+
+ /**
+ * Cleanup temporary file.
+ */
+ protected function cleanupTempFile(): void
+ {
+ if ($this->originalFilename != $this->tempFilename) {
+ // @codeCoverageIgnoreStart
+ // Can't find any test case. Uncomment when found.
+ if (false === copy($this->tempFilename, $this->originalFilename)) {
+ throw new CopyFileException($this->tempFilename, $this->originalFilename);
+ }
+ // @codeCoverageIgnoreEnd
+ @unlink($this->tempFilename);
+ }
+
+ $this->clearTempDir();
+ }
+
+ /**
+ * Clear temporary directory.
+ */
+ protected function clearTempDir(): void
+ {
+ if (is_dir($this->tempDir)) {
+ $this->deleteDir($this->tempDir);
+ }
+ }
+
+ /**
+ * Get ZipArchive object.
+ *
+ * @param string $filename
+ *
+ * @return \PhpOffice\PhpWord\Shared\ZipArchive
+ */
+ protected function getZipArchive($filename)
+ {
+ // Remove any existing file
+ if (file_exists($filename)) {
+ unlink($filename);
+ }
+
+ // Try opening the ZIP file
+ $zip = new ZipArchive();
+
+ // @codeCoverageIgnoreStart
+ // Can't find any test case. Uncomment when found.
+ if ($zip->open($filename, ZipArchive::OVERWRITE) !== true) {
+ if ($zip->open($filename, ZipArchive::CREATE) !== true) {
+ throw new \Exception("Could not open '{$filename}' for writing.");
+ }
+ }
+ // @codeCoverageIgnoreEnd
+
+ return $zip;
+ }
+
+ /**
+ * Open file for writing.
+ *
+ * @since 0.11.0
+ *
+ * @param string $filename
+ *
+ * @return resource
+ */
+ protected function openFile($filename)
+ {
+ $filename = $this->getTempFile($filename);
+ $fileHandle = fopen($filename, 'wb');
+ // @codeCoverageIgnoreStart
+ // Can't find any test case. Uncomment when found.
+ if ($fileHandle === false) {
+ throw new \Exception("Could not open '{$filename}' for writing.");
+ }
+ // @codeCoverageIgnoreEnd
+
+ return $fileHandle;
+ }
+
+ /**
+ * Write content to file.
+ *
+ * @since 0.11.0
+ *
+ * @param resource $fileHandle
+ * @param string $content
+ */
+ protected function writeFile($fileHandle, $content): void
+ {
+ fwrite($fileHandle, $content);
+ fclose($fileHandle);
+ $this->cleanupTempFile();
+ }
+
+ /**
+ * Add files to package.
+ *
+ * @param mixed $elements
+ */
+ protected function addFilesToPackage(ZipArchive $zip, $elements): void
+ {
+ foreach ($elements as $element) {
+ $type = $element['type']; // image|object|link
+
+ // Skip nonregistered types and set target
+ if (!isset($this->mediaPaths[$type])) {
+ continue;
+ }
+ $target = $this->mediaPaths[$type] . $element['target'];
+
+ // Retrive GD image content or get local media
+ if (isset($element['isMemImage']) && $element['isMemImage']) {
+ $imageContents = $element['imageString'];
+ $zip->addFromString($target, $imageContents);
+ } else {
+ $this->addFileToPackage($zip, $element['source'], $target);
+ }
+ }
+ }
+
+ /**
+ * Add file to package.
+ *
+ * Get the actual source from an archive image.
+ *
+ * @param \PhpOffice\PhpWord\Shared\ZipArchive $zipPackage
+ * @param string $source
+ * @param string $target
+ */
+ protected function addFileToPackage($zipPackage, $source, $target): void
+ {
+ $isArchive = strpos($source, 'zip://') !== false;
+ $actualSource = null;
+ if ($isArchive) {
+ $source = substr($source, 6);
+ [$zipFilename, $imageFilename] = explode('#', $source);
+
+ $zip = new ZipArchive();
+ if ($zip->open($zipFilename) !== false) {
+ if ($zip->locateName($imageFilename)) {
+ $zip->extractTo($this->getTempDir(), $imageFilename);
+ $actualSource = $this->getTempDir() . DIRECTORY_SEPARATOR . $imageFilename;
+ }
+ }
+ $zip->close();
+ } else {
+ $actualSource = $source;
+ }
+
+ if (null !== $actualSource) {
+ $zipPackage->addFile($actualSource, $target);
+ }
+ }
+
+ /**
+ * Delete directory.
+ *
+ * @param string $dir
+ */
+ private function deleteDir($dir): void
+ {
+ foreach (scandir($dir) as $file) {
+ if ($file === '.' || $file === '..') {
+ continue;
+ } elseif (is_file($dir . '/' . $file)) {
+ unlink($dir . '/' . $file);
+ } elseif (is_dir($dir . '/' . $file)) {
+ $this->deleteDir($dir . '/' . $file);
+ }
+ }
+
+ rmdir($dir);
+ }
+}
diff --git a/vendor/phpoffice/phpword/src/PhpWord/Writer/HTML.php b/vendor/phpoffice/phpword/src/PhpWord/Writer/HTML.php
new file mode 100644
index 00000000..64789059
--- /dev/null
+++ b/vendor/phpoffice/phpword/src/PhpWord/Writer/HTML.php
@@ -0,0 +1,237 @@
+setPhpWord($phpWord);
+
+ $this->parts = ['Head', 'Body'];
+ foreach ($this->parts as $partName) {
+ $partClass = 'PhpOffice\\PhpWord\\Writer\\HTML\\Part\\' . $partName;
+ if (class_exists($partClass)) {
+ /** @var \PhpOffice\PhpWord\Writer\HTML\Part\AbstractPart $part Type hint */
+ $part = new $partClass();
+ $part->setParentWriter($this);
+ $this->writerParts[strtolower($partName)] = $part;
+ }
+ }
+ }
+
+ /**
+ * Save PhpWord to file.
+ */
+ public function save(string $filename): void
+ {
+ $this->writeFile($this->openFile($filename), $this->getContent());
+ }
+
+ /**
+ * Get content.
+ *
+ * @return string
+ *
+ * @since 0.11.0
+ */
+ public function getContent()
+ {
+ $content = '';
+
+ $content .= '' . PHP_EOL;
+ $content .= '' . PHP_EOL;
+ $langtext = '';
+ $phpWord = $this->getPhpWord();
+ $lang = $phpWord->getSettings()->getThemeFontLang();
+ if (!empty($lang)) {
+ $lang2 = $lang->getLatin();
+ if (!$lang2) {
+ $lang2 = $lang->getEastAsia();
+ }
+ if (!$lang2) {
+ $lang2 = $lang->getBidirectional();
+ }
+ if ($lang2) {
+ $langtext = " lang='" . $lang2 . "'";
+ }
+ }
+ $content .= "" . PHP_EOL;
+ $content .= $this->getWriterPart('Head')->write();
+ $content .= $this->getWriterPart('Body')->write();
+ $content .= ' | |