Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
97.14% covered (success)
97.14%
476 / 490
75.00% covered (warning)
75.00%
21 / 28
CRAP
0.00% covered (danger)
0.00%
0 / 1
AbstractPart
97.14% covered (success)
97.14%
476 / 490
75.00% covered (warning)
75.00%
21 / 28
169
0.00% covered (danger)
0.00%
0 / 1
 read
n/a
0 / 0
n/a
0 / 0
0
 __construct
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
1
 setRels
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 setImageLoading
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
1
 hasImageLoading
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 getCommentReferences
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 setCommentReferences
100.00% covered (success)
100.00%
2 / 2
100.00% covered (success)
100.00%
1 / 1
1
 setCommentReference
88.89% covered (warning)
88.89%
8 / 9
0.00% covered (danger)
0.00%
0 / 1
3.01
 getCommentReference
66.67% covered (warning)
66.67%
2 / 3
0.00% covered (danger)
0.00%
0 / 1
2.15
 readParagraph
98.82% covered (success)
98.82%
84 / 85
0.00% covered (danger)
0.00%
0 / 1
32
 readFormField
95.24% covered (success)
95.24%
60 / 63
0.00% covered (danger)
0.00%
0 / 1
27
 getHeadingDepth
100.00% covered (success)
100.00%
8 / 8
100.00% covered (success)
100.00%
1 / 1
5
 readRun
100.00% covered (success)
100.00%
16 / 16
100.00% covered (success)
100.00%
1 / 1
7
 readRunChild
93.51% covered (success)
93.51%
72 / 77
0.00% covered (danger)
0.00%
0 / 1
29.23
 readRubyProperties
100.00% covered (success)
100.00%
12 / 12
100.00% covered (success)
100.00%
1 / 1
1
 readTable
100.00% covered (success)
100.00%
32 / 32
100.00% covered (success)
100.00%
1 / 1
12
 readParagraphStyle
100.00% covered (success)
100.00%
36 / 36
100.00% covered (success)
100.00%
1 / 1
2
 readFontStyle
93.10% covered (success)
93.10%
27 / 29
0.00% covered (danger)
0.00%
0 / 1
4.01
 readTableStyle
96.30% covered (success)
96.30%
26 / 27
0.00% covered (danger)
0.00%
0 / 1
7
 readTablePosition
100.00% covered (success)
100.00%
13 / 13
100.00% covered (success)
100.00%
1 / 1
1
 readTableIndent
100.00% covered (success)
100.00%
6 / 6
100.00% covered (success)
100.00%
1 / 1
1
 readCellStyle
100.00% covered (success)
100.00%
19 / 19
100.00% covered (success)
100.00%
1 / 1
3
 findPossibleElement
100.00% covered (success)
100.00%
6 / 6
100.00% covered (success)
100.00%
1 / 1
4
 findPossibleAttribute
100.00% covered (success)
100.00%
6 / 6
100.00% covered (success)
100.00%
1 / 1
4
 readStyleDefs
100.00% covered (success)
100.00%
15 / 15
100.00% covered (success)
100.00%
1 / 1
6
 readStyleDef
100.00% covered (success)
100.00%
10 / 10
100.00% covered (success)
100.00%
1 / 1
5
 isOn
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
4
 getMediaTarget
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
2
 getTargetMode
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
2
1<?php
2
3/**
4 * This file is part of PHPWord - A pure PHP library for reading and writing
5 * word processing documents.
6 *
7 * PHPWord is free software distributed under the terms of the GNU Lesser
8 * General Public License version 3 as published by the Free Software Foundation.
9 *
10 * For the full copyright and license information, please read the LICENSE
11 * file that was distributed with this source code. For the full list of
12 * contributors, visit https://github.com/PHPOffice/PHPWord/contributors.
13 *
14 * @see         https://github.com/PHPOffice/PHPWord
15 *
16 * @license     http://www.gnu.org/licenses/lgpl.txt LGPL version 3
17 */
18
19namespace PhpOffice\PhpWord\Reader\Word2007;
20
21use DateTime;
22use DOMElement;
23use InvalidArgumentException;
24use PhpOffice\Math\Reader\OfficeMathML;
25use PhpOffice\PhpWord\ComplexType\RubyProperties;
26use PhpOffice\PhpWord\ComplexType\TblWidth as TblWidthComplexType;
27use PhpOffice\PhpWord\Element\AbstractContainer;
28use PhpOffice\PhpWord\Element\AbstractElement;
29use PhpOffice\PhpWord\Element\FormField;
30use PhpOffice\PhpWord\Element\Ruby;
31use PhpOffice\PhpWord\Element\Text;
32use PhpOffice\PhpWord\Element\TextRun;
33use PhpOffice\PhpWord\Element\TrackChange;
34use PhpOffice\PhpWord\PhpWord;
35use PhpOffice\PhpWord\Shared\XMLReader;
36
37/**
38 * Abstract part reader.
39 *
40 * This class is inherited by ODText reader
41 *
42 * @since 0.10.0
43 */
44abstract class AbstractPart
45{
46    /**
47     * Conversion method.
48     *
49     * @const int
50     */
51    const READ_VALUE = 'attributeValue';            // Read attribute value
52    const READ_EQUAL = 'attributeEquals';           // Read `true` when attribute value equals specified value
53    const READ_TRUE = 'attributeTrue';              // Read `true` when element exists
54    const READ_FALSE = 'attributeFalse';            // Read `false` when element exists
55    const READ_SIZE = 'attributeMultiplyByTwo';     // Read special attribute value for Font::$size
56
57    /**
58     * Document file.
59     *
60     * @var string
61     */
62    protected $docFile;
63
64    /**
65     * XML file.
66     *
67     * @var string
68     */
69    protected $xmlFile;
70
71    /**
72     * Part relationships.
73     *
74     * @var array
75     */
76    protected $rels = [];
77
78    /**
79     * Comment references.
80     *
81     * @var array<string, array<string, AbstractElement>>
82     */
83    protected $commentRefs = [];
84
85    /**
86     * Image Loading.
87     *
88     * @var bool
89     */
90    protected $imageLoading = true;
91
92    /**
93     * Read part.
94     */
95    abstract public function read(PhpWord $phpWord);
96
97    /**
98     * Create new instance.
99     *
100     * @param string $docFile
101     * @param string $xmlFile
102     */
103    public function __construct($docFile, $xmlFile)
104    {
105        $this->docFile = $docFile;
106        $this->xmlFile = $xmlFile;
107    }
108
109    /**
110     * Set relationships.
111     *
112     * @param array $value
113     */
114    public function setRels($value): void
115    {
116        $this->rels = $value;
117    }
118
119    public function setImageLoading(bool $value): self
120    {
121        $this->imageLoading = $value;
122
123        return $this;
124    }
125
126    public function hasImageLoading(): bool
127    {
128        return $this->imageLoading;
129    }
130
131    /**
132     * Get comment references.
133     *
134     * @return array<string, array<string, null|AbstractElement>>
135     */
136    public function getCommentReferences(): array
137    {
138        return $this->commentRefs;
139    }
140
141    /**
142     * Set comment references.
143     *
144     * @param array<string, array<string, null|AbstractElement>> $commentRefs
145     */
146    public function setCommentReferences(array $commentRefs): self
147    {
148        $this->commentRefs = $commentRefs;
149
150        return $this;
151    }
152
153    /**
154     * Set comment reference.
155     */
156    private function setCommentReference(string $type, string $id, AbstractElement $element): self
157    {
158        if (!in_array($type, ['start', 'end'])) {
159            throw new InvalidArgumentException('Type must be "start" or "end"');
160        }
161
162        if (!array_key_exists($id, $this->commentRefs)) {
163            $this->commentRefs[$id] = [
164                'start' => null,
165                'end' => null,
166            ];
167        }
168        $this->commentRefs[$id][$type] = $element;
169
170        return $this;
171    }
172
173    /**
174     * Get comment reference.
175     *
176     * @return array<string, null|AbstractElement>
177     */
178    protected function getCommentReference(string $id): array
179    {
180        if (!array_key_exists($id, $this->commentRefs)) {
181            throw new InvalidArgumentException(sprintf('Comment with id %s isn\'t referenced in document', $id));
182        }
183
184        return $this->commentRefs[$id];
185    }
186
187    /**
188     * Read w:p.
189     *
190     * @param AbstractContainer $parent
191     * @param string $docPart
192     *
193     * @todo Get font style for preserve text
194     */
195    protected function readParagraph(XMLReader $xmlReader, DOMElement $domNode, $parent, $docPart = 'document'): void
196    {
197        // Paragraph style
198        $paragraphStyle = $xmlReader->elementExists('w:pPr', $domNode) ? $this->readParagraphStyle($xmlReader, $domNode) : null;
199
200        if ($xmlReader->elementExists('w:r/w:fldChar/w:ffData', $domNode)) {
201            // FormField
202            $partOfFormField = false;
203            $formNodes = [];
204            $formType = null;
205            $textRunContainers = $xmlReader->countElements('w:r|w:ins|w:del|w:hyperlink|w:smartTag', $domNode);
206            if ($textRunContainers > 0) {
207                $nodes = $xmlReader->getElements('*', $domNode);
208                $paragraph = $parent->addTextRun($paragraphStyle);
209                foreach ($nodes as $node) {
210                    if ($xmlReader->elementExists('w:fldChar/w:ffData', $node)) {
211                        $partOfFormField = true;
212                        $formNodes[] = $node;
213                        if ($xmlReader->elementExists('w:fldChar/w:ffData/w:ddList', $node)) {
214                            $formType = 'dropdown';
215                        } elseif ($xmlReader->elementExists('w:fldChar/w:ffData/w:textInput', $node)) {
216                            $formType = 'textinput';
217                        } elseif ($xmlReader->elementExists('w:fldChar/w:ffData/w:checkBox', $node)) {
218                            $formType = 'checkbox';
219                        }
220                    } elseif ($partOfFormField &&
221                        $xmlReader->elementExists('w:fldChar', $node) &&
222                        'end' == $xmlReader->getAttribute('w:fldCharType', $node, 'w:fldChar')
223                    ) {
224                        $formNodes[] = $node;
225                        $partOfFormField = false;
226                        // Process the form fields
227                        $this->readFormField($xmlReader, $formNodes, $paragraph, $paragraphStyle, $formType);
228                    } elseif ($partOfFormField) {
229                        $formNodes[] = $node;
230                    } else {
231                        // normal runs
232                        $this->readRun($xmlReader, $node, $paragraph, $docPart, $paragraphStyle);
233                    }
234                }
235            }
236        } elseif ($xmlReader->elementExists('w:r/w:instrText', $domNode)) {
237            // PreserveText
238            $ignoreText = false;
239            $textContent = '';
240            $fontStyle = $this->readFontStyle($xmlReader, $domNode);
241            $nodes = $xmlReader->getElements('w:r', $domNode);
242            foreach ($nodes as $node) {
243                if ($xmlReader->elementExists('w:lastRenderedPageBreak', $node)) {
244                    $parent->addPageBreak();
245                }
246                $instrText = $xmlReader->getValue('w:instrText', $node);
247                if (null !== $instrText) {
248                    $textContent .= '{' . $instrText . '}';
249                } else {
250                    if ($xmlReader->elementExists('w:fldChar', $node)) {
251                        $fldCharType = $xmlReader->getAttribute('w:fldCharType', $node, 'w:fldChar');
252                        if ('begin' == $fldCharType) {
253                            $ignoreText = true;
254                        } elseif ('end' == $fldCharType) {
255                            $ignoreText = false;
256                        }
257                    }
258                    if (false === $ignoreText) {
259                        $textContent .= $xmlReader->getValue('w:t', $node);
260                    }
261                }
262            }
263            $parent->addPreserveText(htmlspecialchars($textContent, ENT_QUOTES, 'UTF-8'), $fontStyle, $paragraphStyle);
264
265            return;
266        }
267
268        // Formula
269        $xmlReader->registerNamespace('m', 'http://schemas.openxmlformats.org/officeDocument/2006/math');
270        if ($xmlReader->elementExists('m:oMath', $domNode)) {
271            $mathElement = $xmlReader->getElement('m:oMath', $domNode);
272            $mathXML = $mathElement->ownerDocument->saveXML($mathElement);
273            if (is_string($mathXML)) {
274                $reader = new OfficeMathML();
275                $math = $reader->read($mathXML);
276
277                $parent->addFormula($math);
278            }
279
280            return;
281        }
282
283        // List item
284        if ($xmlReader->elementExists('w:pPr/w:numPr', $domNode)) {
285            $numId = $xmlReader->getAttribute('w:val', $domNode, 'w:pPr/w:numPr/w:numId');
286            $levelId = $xmlReader->getAttribute('w:val', $domNode, 'w:pPr/w:numPr/w:ilvl');
287            $nodes = $xmlReader->getElements('*', $domNode);
288
289            $listItemRun = $parent->addListItemRun($levelId, "PHPWordList{$numId}", $paragraphStyle);
290
291            foreach ($nodes as $node) {
292                $this->readRun($xmlReader, $node, $listItemRun, $docPart, $paragraphStyle);
293            }
294
295            return;
296        }
297
298        // Heading or Title
299        $headingDepth = $xmlReader->elementExists('w:pPr', $domNode) ? $this->getHeadingDepth($paragraphStyle) : null;
300        if ($headingDepth !== null) {
301            $textContent = null;
302            $nodes = $xmlReader->getElements('w:r|w:hyperlink', $domNode);
303            $hasRubyElement = $xmlReader->elementExists('w:r/w:ruby', $domNode);
304            if ($nodes->length === 1 && !$hasRubyElement) {
305                $textContent = htmlspecialchars($xmlReader->getValue('w:t', $nodes->item(0)), ENT_QUOTES, 'UTF-8');
306            } else {
307                $textContent = new TextRun($paragraphStyle);
308                foreach ($nodes as $node) {
309                    $this->readRun($xmlReader, $node, $textContent, $docPart, $paragraphStyle);
310                }
311            }
312            $parent->addTitle($textContent, $headingDepth);
313
314            return;
315        }
316
317        // Text and TextRun
318        $textRunContainers = $xmlReader->countElements('w:r|w:ins|w:del|w:hyperlink|w:smartTag|w:commentReference|w:commentRangeStart|w:commentRangeEnd', $domNode);
319        if (0 === $textRunContainers) {
320            $parent->addTextBreak(1, $paragraphStyle);
321        } else {
322            $nodes = $xmlReader->getElements('*', $domNode);
323            $paragraph = $parent->addTextRun($paragraphStyle);
324            foreach ($nodes as $node) {
325                $this->readRun($xmlReader, $node, $paragraph, $docPart, $paragraphStyle);
326            }
327        }
328    }
329
330    /**
331     * @param DOMElement[] $domNodes
332     * @param AbstractContainer $parent
333     * @param mixed $paragraphStyle
334     * @param string $formType
335     */
336    private function readFormField(XMLReader $xmlReader, array $domNodes, $parent, $paragraphStyle, $formType): void
337    {
338        if (!in_array($formType, ['textinput', 'checkbox', 'dropdown'])) {
339            return;
340        }
341
342        $formField = $parent->addFormField($formType, null, $paragraphStyle);
343        $ffData = $xmlReader->getElement('w:fldChar/w:ffData', $domNodes[0]);
344
345        foreach ($xmlReader->getElements('*', $ffData) as $node) {
346            /** @var DOMElement $node */
347            switch ($node->localName) {
348                case 'name':
349                    $formField->setName($node->getAttribute('w:val'));
350
351                    break;
352                case 'ddList':
353                    $listEntries = [];
354                    foreach ($xmlReader->getElements('*', $node) as $ddListNode) {
355                        switch ($ddListNode->localName) {
356                            case 'result':
357                                $formField->setValue($xmlReader->getAttribute('w:val', $ddListNode));
358
359                                break;
360                            case 'default':
361                                $formField->setDefault($xmlReader->getAttribute('w:val', $ddListNode));
362
363                                break;
364                            case 'listEntry':
365                                $listEntries[] = $xmlReader->getAttribute('w:val', $ddListNode);
366
367                                break;
368                        }
369                    }
370                    $formField->setEntries($listEntries);
371                    if (null !== $formField->getValue()) {
372                        /** @phpstan-ignore offsetAccess.notFound */
373                        $formField->setText($listEntries[$formField->getValue()]);
374                    }
375
376                    break;
377                case 'textInput':
378                    foreach ($xmlReader->getElements('*', $node) as $ddListNode) {
379                        switch ($ddListNode->localName) {
380                            case 'default':
381                                $formField->setDefault($xmlReader->getAttribute('w:val', $ddListNode));
382
383                                break;
384                            case 'format':
385                            case 'maxLength':
386                                break;
387                        }
388                    }
389
390                    break;
391                case 'checkBox':
392                    foreach ($xmlReader->getElements('*', $node) as $ddListNode) {
393                        switch ($ddListNode->localName) {
394                            case 'default':
395                                $formField->setDefault($xmlReader->getAttribute('w:val', $ddListNode));
396
397                                break;
398                            case 'checked':
399                                $formField->setValue($xmlReader->getAttribute('w:val', $ddListNode));
400
401                                break;
402                            case 'size':
403                            case 'sizeAuto':
404                                break;
405                        }
406                    }
407
408                    break;
409            }
410        }
411
412        if ('textinput' == $formType) {
413            $ignoreText = true;
414            $textContent = '';
415            foreach ($domNodes as $node) {
416                if ($xmlReader->elementExists('w:fldChar', $node)) {
417                    $fldCharType = $xmlReader->getAttribute('w:fldCharType', $node, 'w:fldChar');
418                    if ('separate' == $fldCharType) {
419                        $ignoreText = false;
420                    } elseif ('end' == $fldCharType) {
421                        $ignoreText = true;
422                    }
423                }
424
425                if (false === $ignoreText) {
426                    $textContent .= $xmlReader->getValue('w:t', $node);
427                }
428            }
429            $formField->setValue(htmlspecialchars($textContent, ENT_QUOTES, 'UTF-8'));
430            $formField->setText(htmlspecialchars($textContent, ENT_QUOTES, 'UTF-8'));
431        }
432    }
433
434    /**
435     * Returns the depth of the Heading, returns 0 for a Title.
436     *
437     * @return null|number
438     */
439    private function getHeadingDepth(?array $paragraphStyle = null)
440    {
441        if (is_array($paragraphStyle) && isset($paragraphStyle['styleName'])) {
442            if ('Title' === $paragraphStyle['styleName']) {
443                return 0;
444            }
445
446            $headingMatches = [];
447            preg_match('/Heading(\d)/', $paragraphStyle['styleName'], $headingMatches);
448            if (!empty($headingMatches)) {
449                return $headingMatches[1];
450            }
451        }
452
453        return null;
454    }
455
456    /**
457     * Read w:r.
458     *
459     * @param AbstractContainer $parent
460     * @param string $docPart
461     * @param mixed $paragraphStyle
462     *
463     * @todo Footnote paragraph style
464     */
465    protected function readRun(XMLReader $xmlReader, DOMElement $domNode, $parent, $docPart, $paragraphStyle = null): void
466    {
467        if (in_array($domNode->nodeName, ['w:ins', 'w:del', 'w:smartTag', 'w:hyperlink', 'w:commentReference'])) {
468            $nodes = $xmlReader->getElements('*', $domNode);
469            foreach ($nodes as $node) {
470                $this->readRun($xmlReader, $node, $parent, $docPart, $paragraphStyle);
471            }
472        } elseif ($domNode->nodeName == 'w:r') {
473            $fontStyle = $this->readFontStyle($xmlReader, $domNode);
474            $nodes = $xmlReader->getElements('*', $domNode);
475            foreach ($nodes as $node) {
476                $this->readRunChild($xmlReader, $node, $parent, $docPart, $paragraphStyle, $fontStyle);
477            }
478        }
479
480        if ($xmlReader->elementExists('.//*["commentReference"=local-name()]', $domNode)) {
481            $node = iterator_to_array($xmlReader->getElements('.//*["commentReference"=local-name()]', $domNode))[0];
482            $attributeIdentifier = $node->attributes->getNamedItem('id');
483            if ($attributeIdentifier) {
484                $id = $attributeIdentifier->nodeValue;
485
486                $this->setCommentReference('start', $id, $parent->getElement($parent->countElements() - 1));
487                $this->setCommentReference('end', $id, $parent->getElement($parent->countElements() - 1));
488            }
489        }
490    }
491
492    /**
493     * Parses nodes under w:r.
494     *
495     * @param string $docPart
496     * @param mixed $paragraphStyle
497     * @param mixed $fontStyle
498     */
499    protected function readRunChild(XMLReader $xmlReader, DOMElement $node, AbstractContainer $parent, $docPart, $paragraphStyle = null, $fontStyle = null): void
500    {
501        $runParent = $node->parentNode->parentNode;
502        if ($node->nodeName == 'w:footnoteReference') {
503            // Footnote
504            $wId = $xmlReader->getAttribute('w:id', $node);
505            $footnote = $parent->addFootnote();
506            $footnote->setRelationId($wId);
507        } elseif ($node->nodeName == 'w:endnoteReference') {
508            // Endnote
509            $wId = $xmlReader->getAttribute('w:id', $node);
510            $endnote = $parent->addEndnote();
511            $endnote->setRelationId($wId);
512        } elseif ($node->nodeName == 'w:pict') {
513            // Image
514            $rId = $xmlReader->getAttribute('r:id', $node, 'v:shape/v:imagedata');
515            $target = $this->getMediaTarget($docPart, $rId);
516            if ($this->hasImageLoading() && null !== $target) {
517                if ('External' == $this->getTargetMode($docPart, $rId)) {
518                    $imageSource = $target;
519                } else {
520                    $imageSource = "zip://{$this->docFile}#{$target}";
521                }
522                $parent->addImage($imageSource);
523            }
524        } elseif ($node->nodeName == 'w:drawing') {
525            // Office 2011 Image
526            $xmlReader->registerNamespace('wp', 'http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing');
527            $xmlReader->registerNamespace('r', 'http://schemas.openxmlformats.org/officeDocument/2006/relationships');
528            $xmlReader->registerNamespace('pic', 'http://schemas.openxmlformats.org/drawingml/2006/picture');
529            $xmlReader->registerNamespace('a', 'http://schemas.openxmlformats.org/drawingml/2006/main');
530
531            $name = $xmlReader->getAttribute('name', $node, 'wp:inline/a:graphic/a:graphicData/pic:pic/pic:nvPicPr/pic:cNvPr');
532            $altText = $xmlReader->getAttribute('descr', $node, 'wp:inline/a:graphic/a:graphicData/pic:pic/pic:nvPicPr/pic:cNvPr');
533            $embedId = $xmlReader->getAttribute('r:embed', $node, 'wp:inline/a:graphic/a:graphicData/pic:pic/pic:blipFill/a:blip');
534            if ($name === null && $altText === null && $embedId === null) { // some Converters puts images on a different path
535                $name = $xmlReader->getAttribute('name', $node, 'wp:anchor/a:graphic/a:graphicData/pic:pic/pic:nvPicPr/pic:cNvPr');
536                $altText = $xmlReader->getAttribute('descr', $node, 'wp:anchor/a:graphic/a:graphicData/pic:pic/pic:nvPicPr/pic:cNvPr');
537                $embedId = $xmlReader->getAttribute('r:embed', $node, 'wp:anchor/a:graphic/a:graphicData/pic:pic/pic:blipFill/a:blip');
538            }
539            $target = $this->getMediaTarget($docPart, $embedId);
540            if ($this->hasImageLoading() && null !== $target) {
541                $imageSource = "zip://{$this->docFile}#{$target}";
542                $parent->addImage($imageSource, null, false, $name, $altText);
543            }
544        } elseif ($node->nodeName == 'w:object') {
545            // Object
546            $rId = $xmlReader->getAttribute('r:id', $node, 'o:OLEObject');
547            // $rIdIcon = $xmlReader->getAttribute('r:id', $domNode, 'w:object/v:shape/v:imagedata');
548            $target = $this->getMediaTarget($docPart, $rId);
549            if (null !== $target) {
550                $textContent = "&lt;Object: {$target}>";
551                $parent->addText($textContent, $fontStyle, $paragraphStyle);
552            }
553        } elseif ($node->nodeName == 'w:br') {
554            $parent->addTextBreak();
555        } elseif ($node->nodeName == 'w:tab') {
556            $parent->addText("\t");
557        } elseif ($node->nodeName == 'mc:AlternateContent') {
558            if ($node->hasChildNodes()) {
559                // Get fallback instead of mc:Choice to make sure it is compatible
560                $fallbackElements = $node->getElementsByTagName('Fallback');
561
562                if ($fallbackElements->length) {
563                    $fallback = $fallbackElements->item(0);
564                    // TextRun
565                    $textContent = htmlspecialchars($fallback->nodeValue, ENT_QUOTES, 'UTF-8');
566
567                    $parent->addText($textContent, $fontStyle, $paragraphStyle);
568                }
569            }
570        } elseif ($node->nodeName == 'w:t' || $node->nodeName == 'w:delText') {
571            // TextRun
572            $textContent = htmlspecialchars($xmlReader->getValue('.', $node), ENT_QUOTES, 'UTF-8');
573
574            if ($runParent->nodeName == 'w:hyperlink') {
575                $rId = $xmlReader->getAttribute('r:id', $runParent);
576                $target = $this->getMediaTarget($docPart, $rId);
577                if (null !== $target) {
578                    $parent->addLink($target, $textContent, $fontStyle, $paragraphStyle);
579                } else {
580                    $parent->addText($textContent, $fontStyle, $paragraphStyle);
581                }
582            } else {
583                /** @var AbstractElement $element */
584                $element = $parent->addText($textContent, $fontStyle, $paragraphStyle);
585                if (in_array($runParent->nodeName, ['w:ins', 'w:del'])) {
586                    $type = ($runParent->nodeName == 'w:del') ? TrackChange::DELETED : TrackChange::INSERTED;
587                    $author = $runParent->getAttribute('w:author');
588                    $date = DateTime::createFromFormat('Y-m-d\TH:i:s\Z', $runParent->getAttribute('w:date'));
589                    $date = $date instanceof DateTime ? $date : null;
590                    $element->setChangeInfo($type, $author, $date);
591                }
592            }
593        } elseif ($node->nodeName == 'w:softHyphen') {
594            $element = $parent->addText("\u{200c}", $fontStyle, $paragraphStyle);
595        } elseif ($node->nodeName == 'w:ruby') {
596            $rubyPropertiesNode = $xmlReader->getElement('w:rubyPr', $node);
597            $properties = $this->readRubyProperties($xmlReader, $rubyPropertiesNode);
598            // read base text node
599            $baseText = new TextRun($paragraphStyle);
600            $baseTextNode = $xmlReader->getElement('w:rubyBase/w:r', $node);
601            $this->readRun($xmlReader, $baseTextNode, $baseText, $docPart, $paragraphStyle);
602            // read the actual ruby text (e.g. furigana in Japanese)
603            $rubyText = new TextRun($paragraphStyle);
604            $rubyTextNode = $xmlReader->getElement('w:rt/w:r', $node);
605            $this->readRun($xmlReader, $rubyTextNode, $rubyText, $docPart, $paragraphStyle);
606            // add element to parent
607            $parent->addRuby($baseText, $rubyText, $properties);
608        }
609    }
610
611    /**
612     * Read w:rubyPr element.
613     *
614     * @param XMLReader $xmlReader reader for XML
615     * @param DOMElement $domNode w:RubyPr element
616     *
617     * @return RubyProperties ruby properties from element
618     */
619    protected function readRubyProperties(XMLReader $xmlReader, DOMElement $domNode): RubyProperties
620    {
621        $rubyAlignment = $xmlReader->getElement('w:rubyAlign', $domNode)->getAttribute('w:val');
622        $rubyHps = $xmlReader->getElement('w:hps', $domNode)->getAttribute('w:val'); // font face
623        $rubyHpsRaise = $xmlReader->getElement('w:hpsRaise', $domNode)->getAttribute('w:val'); // pts above base text
624        $rubyHpsBaseText = $xmlReader->getElement('w:hpsBaseText', $domNode)->getAttribute('w:val'); // base text size
625        $rubyLid = $xmlReader->getElement('w:lid', $domNode)->getAttribute('w:val'); // type of ruby
626        $properties = new RubyProperties();
627        $properties->setAlignment($rubyAlignment);
628        $properties->setFontFaceSize((float) $rubyHps);
629        $properties->setFontPointsAboveBaseText((float) $rubyHpsRaise);
630        $properties->setFontSizeForBaseText((float) $rubyHpsBaseText);
631        $properties->setLanguageId($rubyLid);
632
633        return $properties;
634    }
635
636    /**
637     * Read w:tbl.
638     *
639     * @param mixed $parent
640     * @param string $docPart
641     */
642    protected function readTable(XMLReader $xmlReader, DOMElement $domNode, $parent, $docPart = 'document'): void
643    {
644        // Table style
645        $tblStyle = null;
646        if ($xmlReader->elementExists('w:tblPr', $domNode)) {
647            $tblStyle = $this->readTableStyle($xmlReader, $domNode);
648        }
649
650        /** @var \PhpOffice\PhpWord\Element\Table $table Type hint */
651        $table = $parent->addTable($tblStyle);
652        $tblNodes = $xmlReader->getElements('*', $domNode);
653        foreach ($tblNodes as $tblNode) {
654            if ('w:tblGrid' == $tblNode->nodeName) { // Column
655                // @todo Do something with table columns
656            } elseif ('w:tr' == $tblNode->nodeName) { // Row
657                $rowHeight = $xmlReader->getAttribute('w:val', $tblNode, 'w:trPr/w:trHeight');
658                $rowHRule = $xmlReader->getAttribute('w:hRule', $tblNode, 'w:trPr/w:trHeight');
659                $rowHRule = $rowHRule == 'exact';
660                $rowStyle = [
661                    'tblHeader' => $xmlReader->elementExists('w:trPr/w:tblHeader', $tblNode),
662                    'cantSplit' => $xmlReader->elementExists('w:trPr/w:cantSplit', $tblNode),
663                    'exactHeight' => $rowHRule,
664                ];
665
666                $row = $table->addRow($rowHeight, $rowStyle);
667                $rowNodes = $xmlReader->getElements('*', $tblNode);
668                foreach ($rowNodes as $rowNode) {
669                    if ('w:trPr' == $rowNode->nodeName) { // Row style
670                        // @todo Do something with row style
671                    } elseif ('w:tc' == $rowNode->nodeName) { // Cell
672                        $cellWidth = $xmlReader->getAttribute('w:w', $rowNode, 'w:tcPr/w:tcW');
673                        $cellStyle = null;
674                        if ($xmlReader->elementExists('w:tcPr', $rowNode)) {
675                            $cellStyle = $this->readCellStyle($xmlReader, $rowNode);
676                        }
677
678                        $cell = $row->addCell($cellWidth, $cellStyle);
679                        $cellNodes = $xmlReader->getElements('*', $rowNode);
680                        foreach ($cellNodes as $cellNode) {
681                            if ('w:p' == $cellNode->nodeName) { // Paragraph
682                                $this->readParagraph($xmlReader, $cellNode, $cell, $docPart);
683                            } elseif ($cellNode->nodeName == 'w:tbl') { // Table
684                                $this->readTable($xmlReader, $cellNode, $cell, $docPart);
685                            }
686                        }
687                    }
688                }
689            }
690        }
691    }
692
693    /**
694     * Read w:pPr.
695     *
696     * @return null|array
697     */
698    protected function readParagraphStyle(XMLReader $xmlReader, DOMElement $domNode)
699    {
700        if (!$xmlReader->elementExists('w:pPr', $domNode)) {
701            return null;
702        }
703
704        $styleNode = $xmlReader->getElement('w:pPr', $domNode);
705        $styleDefs = [
706            'styleName' => [self::READ_VALUE, ['w:pStyle', 'w:name']],
707            'alignment' => [self::READ_VALUE, 'w:jc'],
708            'basedOn' => [self::READ_VALUE, 'w:basedOn'],
709            'next' => [self::READ_VALUE, 'w:next'],
710            'indentLeft' => [self::READ_VALUE, 'w:ind', 'w:left'],
711            'indentRight' => [self::READ_VALUE, 'w:ind', 'w:right'],
712            'indentHanging' => [self::READ_VALUE, 'w:ind', 'w:hanging'],
713            'indentFirstLine' => [self::READ_VALUE, 'w:ind', 'w:firstLine'],
714            'indentFirstLineChars' => [self::READ_VALUE, 'w:ind', 'w:firstLineChars'],
715            'spaceAfter' => [self::READ_VALUE, 'w:spacing', 'w:after'],
716            'spaceBefore' => [self::READ_VALUE, 'w:spacing', 'w:before'],
717            'widowControl' => [self::READ_FALSE, 'w:widowControl'],
718            'keepNext' => [self::READ_TRUE,  'w:keepNext'],
719            'keepLines' => [self::READ_TRUE,  'w:keepLines'],
720            'pageBreakBefore' => [self::READ_TRUE,  'w:pageBreakBefore'],
721            'contextualSpacing' => [self::READ_TRUE,  'w:contextualSpacing'],
722            'bidi' => [self::READ_TRUE,  'w:bidi'],
723            'suppressAutoHyphens' => [self::READ_TRUE,  'w:suppressAutoHyphens'],
724            'borderTopStyle' => [self::READ_VALUE, 'w:pBdr/w:top'],
725            'borderTopColor' => [self::READ_VALUE, 'w:pBdr/w:top', 'w:color'],
726            'borderTopSize' => [self::READ_VALUE, 'w:pBdr/w:top', 'w:sz'],
727            'borderRightStyle' => [self::READ_VALUE, 'w:pBdr/w:right'],
728            'borderRightColor' => [self::READ_VALUE, 'w:pBdr/w:right', 'w:color'],
729            'borderRightSize' => [self::READ_VALUE, 'w:pBdr/w:right', 'w:sz'],
730            'borderBottomStyle' => [self::READ_VALUE, 'w:pBdr/w:bottom'],
731            'borderBottomColor' => [self::READ_VALUE, 'w:pBdr/w:bottom', 'w:color'],
732            'borderBottomSize' => [self::READ_VALUE, 'w:pBdr/w:bottom', 'w:sz'],
733            'borderLeftStyle' => [self::READ_VALUE, 'w:pBdr/w:left'],
734            'borderLeftColor' => [self::READ_VALUE, 'w:pBdr/w:left', 'w:color'],
735            'borderLeftSize' => [self::READ_VALUE, 'w:pBdr/w:left', 'w:sz'],
736        ];
737
738        return $this->readStyleDefs($xmlReader, $styleNode, $styleDefs);
739    }
740
741    /**
742     * Read w:rPr.
743     *
744     * @return null|array
745     */
746    protected function readFontStyle(XMLReader $xmlReader, DOMElement $domNode)
747    {
748        if (null === $domNode) {
749            return null;
750        }
751        // Hyperlink has an extra w:r child
752        if ('w:hyperlink' == $domNode->nodeName) {
753            $domNode = $xmlReader->getElement('w:r', $domNode);
754        }
755        if (!$xmlReader->elementExists('w:rPr', $domNode)) {
756            return null;
757        }
758
759        $styleNode = $xmlReader->getElement('w:rPr', $domNode);
760        $styleDefs = [
761            'styleName' => [self::READ_VALUE, 'w:rStyle'],
762            'name' => [self::READ_VALUE, 'w:rFonts', ['w:ascii', 'w:hAnsi', 'w:eastAsia', 'w:cs']],
763            'hint' => [self::READ_VALUE, 'w:rFonts', 'w:hint'],
764            'size' => [self::READ_SIZE,  ['w:sz', 'w:szCs']],
765            'color' => [self::READ_VALUE, 'w:color'],
766            'underline' => [self::READ_VALUE, 'w:u'],
767            'bold' => [self::READ_TRUE,  'w:b'],
768            'italic' => [self::READ_TRUE,  'w:i'],
769            'strikethrough' => [self::READ_TRUE,  'w:strike'],
770            'doubleStrikethrough' => [self::READ_TRUE,  'w:dstrike'],
771            'smallCaps' => [self::READ_TRUE,  'w:smallCaps'],
772            'allCaps' => [self::READ_TRUE,  'w:caps'],
773            'superScript' => [self::READ_EQUAL, 'w:vertAlign', 'w:val', 'superscript'],
774            'subScript' => [self::READ_EQUAL, 'w:vertAlign', 'w:val', 'subscript'],
775            'fgColor' => [self::READ_VALUE, 'w:highlight'],
776            'rtl' => [self::READ_TRUE,  'w:rtl'],
777            'lang' => [self::READ_VALUE, 'w:lang'],
778            'position' => [self::READ_VALUE, 'w:position'],
779            'hidden' => [self::READ_TRUE,  'w:vanish'],
780        ];
781
782        return $this->readStyleDefs($xmlReader, $styleNode, $styleDefs);
783    }
784
785    /**
786     * Read w:tblPr.
787     *
788     * @return null|array|string
789     *
790     * @todo Capture w:tblStylePr w:type="firstRow"
791     */
792    protected function readTableStyle(XMLReader $xmlReader, DOMElement $domNode)
793    {
794        $style = null;
795        $margins = ['top', 'left', 'bottom', 'right'];
796        $borders = array_merge($margins, ['insideH', 'insideV']);
797
798        if ($xmlReader->elementExists('w:tblPr', $domNode)) {
799            if ($xmlReader->elementExists('w:tblPr/w:tblStyle', $domNode)) {
800                $style = $xmlReader->getAttribute('w:val', $domNode, 'w:tblPr/w:tblStyle');
801            } else {
802                $styleNode = $xmlReader->getElement('w:tblPr', $domNode);
803                $styleDefs = [];
804                foreach ($margins as $side) {
805                    $ucfSide = ucfirst($side);
806                    $styleDefs["cellMargin$ucfSide"] = [self::READ_VALUE, "w:tblCellMar/w:$side", 'w:w'];
807                }
808                foreach ($borders as $side) {
809                    $ucfSide = ucfirst($side);
810                    $styleDefs["border{$ucfSide}Size"] = [self::READ_VALUE, "w:tblBorders/w:$side", 'w:sz'];
811                    $styleDefs["border{$ucfSide}Color"] = [self::READ_VALUE, "w:tblBorders/w:$side", 'w:color'];
812                    $styleDefs["border{$ucfSide}Style"] = [self::READ_VALUE, "w:tblBorders/w:$side", 'w:val'];
813                }
814                $styleDefs['layout'] = [self::READ_VALUE, 'w:tblLayout', 'w:type'];
815                $styleDefs['bidiVisual'] = [self::READ_TRUE, 'w:bidiVisual'];
816                $styleDefs['cellSpacing'] = [self::READ_VALUE, 'w:tblCellSpacing', 'w:w'];
817                $style = $this->readStyleDefs($xmlReader, $styleNode, $styleDefs);
818
819                $tablePositionNode = $xmlReader->getElement('w:tblpPr', $styleNode);
820                if ($tablePositionNode !== null) {
821                    $style['position'] = $this->readTablePosition($xmlReader, $tablePositionNode);
822                }
823
824                $indentNode = $xmlReader->getElement('w:tblInd', $styleNode);
825                if ($indentNode !== null) {
826                    $style['indent'] = $this->readTableIndent($xmlReader, $indentNode);
827                }
828            }
829        }
830
831        return $style;
832    }
833
834    /**
835     * Read w:tblpPr.
836     *
837     * @return array
838     */
839    private function readTablePosition(XMLReader $xmlReader, DOMElement $domNode)
840    {
841        $styleDefs = [
842            'leftFromText' => [self::READ_VALUE, '.', 'w:leftFromText'],
843            'rightFromText' => [self::READ_VALUE, '.', 'w:rightFromText'],
844            'topFromText' => [self::READ_VALUE, '.', 'w:topFromText'],
845            'bottomFromText' => [self::READ_VALUE, '.', 'w:bottomFromText'],
846            'vertAnchor' => [self::READ_VALUE, '.', 'w:vertAnchor'],
847            'horzAnchor' => [self::READ_VALUE, '.', 'w:horzAnchor'],
848            'tblpXSpec' => [self::READ_VALUE, '.', 'w:tblpXSpec'],
849            'tblpX' => [self::READ_VALUE, '.', 'w:tblpX'],
850            'tblpYSpec' => [self::READ_VALUE, '.', 'w:tblpYSpec'],
851            'tblpY' => [self::READ_VALUE, '.', 'w:tblpY'],
852        ];
853
854        return $this->readStyleDefs($xmlReader, $domNode, $styleDefs);
855    }
856
857    /**
858     * Read w:tblInd.
859     *
860     * @return TblWidthComplexType
861     */
862    private function readTableIndent(XMLReader $xmlReader, DOMElement $domNode)
863    {
864        $styleDefs = [
865            'value' => [self::READ_VALUE, '.', 'w:w'],
866            'type' => [self::READ_VALUE, '.', 'w:type'],
867        ];
868        $styleDefs = $this->readStyleDefs($xmlReader, $domNode, $styleDefs);
869
870        return new TblWidthComplexType((int) $styleDefs['value'], $styleDefs['type']);
871    }
872
873    /**
874     * Read w:tcPr.
875     *
876     * @return null|array
877     */
878    private function readCellStyle(XMLReader $xmlReader, DOMElement $domNode)
879    {
880        $styleDefs = [
881            'valign' => [self::READ_VALUE, 'w:vAlign'],
882            'textDirection' => [self::READ_VALUE, 'w:textDirection'],
883            'gridSpan' => [self::READ_VALUE, 'w:gridSpan'],
884            'vMerge' => [self::READ_VALUE, 'w:vMerge', null, null, 'continue'],
885            'bgColor' => [self::READ_VALUE, 'w:shd', 'w:fill'],
886            'noWrap' => [self::READ_VALUE, 'w:noWrap', null, null, true],
887        ];
888        $style = null;
889
890        if ($xmlReader->elementExists('w:tcPr', $domNode)) {
891            $styleNode = $xmlReader->getElement('w:tcPr', $domNode);
892
893            $borders = ['top', 'left', 'bottom', 'right'];
894            foreach ($borders as $side) {
895                $ucfSide = ucfirst($side);
896
897                $styleDefs['border' . $ucfSide . 'Size'] = [self::READ_VALUE, 'w:tcBorders/w:' . $side, 'w:sz'];
898                $styleDefs['border' . $ucfSide . 'Color'] = [self::READ_VALUE, 'w:tcBorders/w:' . $side, 'w:color'];
899                $styleDefs['border' . $ucfSide . 'Style'] = [self::READ_VALUE, 'w:tcBorders/w:' . $side, 'w:val'];
900            }
901
902            $style = $this->readStyleDefs($xmlReader, $styleNode, $styleDefs);
903        }
904
905        return $style;
906    }
907
908    /**
909     * Returns the first child element found.
910     *
911     * @param null|array|string $elements
912     *
913     * @return null|string
914     */
915    private function findPossibleElement(XMLReader $xmlReader, ?DOMElement $parentNode = null, $elements = null)
916    {
917        if (is_array($elements)) {
918            //if element is an array, we take the first element that exists in the XML
919            foreach ($elements as $possibleElement) {
920                if ($xmlReader->elementExists($possibleElement, $parentNode)) {
921                    return $possibleElement;
922                }
923            }
924        } else {
925            return $elements;
926        }
927
928        return null;
929    }
930
931    /**
932     * Returns the first attribute found.
933     *
934     * @param array|string $attributes
935     *
936     * @return null|string
937     */
938    private function findPossibleAttribute(XMLReader $xmlReader, DOMElement $node, $attributes)
939    {
940        //if attribute is an array, we take the first attribute that exists in the XML
941        if (is_array($attributes)) {
942            foreach ($attributes as $possibleAttribute) {
943                if ($xmlReader->getAttribute($possibleAttribute, $node)) {
944                    return $possibleAttribute;
945                }
946            }
947
948            return null;
949        }
950
951        return $attributes;
952    }
953
954    /**
955     * Read style definition.
956     *
957     * @param array $styleDefs
958     *
959     * @ignoreScrutinizerPatch
960     *
961     * @return array
962     */
963    protected function readStyleDefs(XMLReader $xmlReader, ?DOMElement $parentNode = null, $styleDefs = [])
964    {
965        $styles = [];
966
967        foreach ($styleDefs as $styleProp => $styleVal) {
968            [$method, $element, $attribute, $expected, $default] = array_pad($styleVal, 5, null);
969
970            $element = $this->findPossibleElement($xmlReader, $parentNode, $element);
971            if ($element === null) {
972                continue;
973            }
974
975            if ($xmlReader->elementExists($element, $parentNode)) {
976                $node = $xmlReader->getElement($element, $parentNode);
977
978                $attribute = $this->findPossibleAttribute($xmlReader, $node, $attribute);
979
980                // Use w:val as default if no attribute assigned
981                $attribute = ($attribute === null) ? 'w:val' : $attribute;
982                $attributeValue = $xmlReader->getAttribute($attribute, $node) ?? $default;
983
984                $styleValue = $this->readStyleDef($method, $attributeValue, $expected);
985                if ($styleValue !== null) {
986                    $styles[$styleProp] = $styleValue;
987                }
988            }
989        }
990
991        return $styles;
992    }
993
994    /**
995     * Return style definition based on conversion method.
996     *
997     * @param string $method
998     *
999     * @ignoreScrutinizerPatch
1000     *
1001     * @param null|string $attributeValue
1002     * @param mixed $expected
1003     *
1004     * @return mixed
1005     */
1006    private function readStyleDef($method, $attributeValue, $expected)
1007    {
1008        $style = $attributeValue;
1009
1010        if (self::READ_SIZE == $method) {
1011            $style = $attributeValue / 2;
1012        } elseif (self::READ_TRUE == $method) {
1013            $style = $this->isOn($attributeValue);
1014        } elseif (self::READ_FALSE == $method) {
1015            $style = !$this->isOn($attributeValue);
1016        } elseif (self::READ_EQUAL == $method) {
1017            $style = $attributeValue == $expected;
1018        }
1019
1020        return $style;
1021    }
1022
1023    /**
1024     * Parses the value of the on/off value, null is considered true as it means the w:val attribute was not present.
1025     *
1026     * @see http://www.datypic.com/sc/ooxml/t-w_ST_OnOff.html
1027     *
1028     * @param string $value
1029     *
1030     * @return bool
1031     */
1032    private function isOn($value = null)
1033    {
1034        return $value === null || $value === '1' || $value === 'true' || $value === 'on';
1035    }
1036
1037    /**
1038     * Returns the target of image, object, or link as stored in ::readMainRels.
1039     *
1040     * @param string $docPart
1041     * @param string $rId
1042     *
1043     * @return null|string
1044     */
1045    private function getMediaTarget($docPart, $rId)
1046    {
1047        $target = null;
1048
1049        if (isset($this->rels[$docPart], $this->rels[$docPart][$rId])) {
1050            $target = $this->rels[$docPart][$rId]['target'];
1051        }
1052
1053        return $target;
1054    }
1055
1056    /**
1057     * Returns the target mode.
1058     *
1059     * @param string $docPart
1060     * @param string $rId
1061     *
1062     * @return null|string
1063     */
1064    private function getTargetMode($docPart, $rId)
1065    {
1066        $mode = null;
1067
1068        if (isset($this->rels[$docPart], $this->rels[$docPart][$rId])) {
1069            $mode = $this->rels[$docPart][$rId]['targetMode'];
1070        }
1071
1072        return $mode;
1073    }
1074}