lmerotta/docx

PHP Based Docx Parser, based on original work by PhilGale92/docx

0.1.1 2016-06-15 12:47 UTC

This package is auto-updated.

Last update: 2024-05-09 05:20:22 UTC


README

This PHP based parser takes any docx file, and creates a PHP array containing its structure, content & style information. Simply import any style data (as demonstrated within index.php) using the word style name & any desired attributes and run the parser.

====

Supports:

  • Word styles
  • Paragraphs
  • Text indentation / tabbing
  • Nested lists (& inline lists)
  • Tables (Vertical cell merging + colspans)
  • Images (& finding the required image size)
  • Hyperlinks (With mailto: support)
  • Bold / Underlined / Italic text
  • Textboxes (Parser support added, but not rendered)
  • Table of content functionality (You likely need to extend the docx class & modify the ->render() class)

====

Known Bugs:

  • Tables cells that us the following pattern don't render properly:
Example (incorrect render)
cell 1
cell 2
--------
cell 3
cell 4

Cell 1 + 2 are vertically merged. Then there is a border, cell 3 + 4 are merged. The renderer cannot differentiate between multiple vertical merges that don't have a standard cell between them.

The following layout is fine, as cell 3 is a standard cell dividing the two vertical merges:

Example (works)
cell 1
cell 2
--------
cell 3
--------
cell 4
cell 5

====

Caveats:

  • Images are displayed at the same dimensions as in word, however the included rendering class does not contain functionality for resizing the raw image files as required (due to it being out of scope for this project)
  • The parser may take some time to run on larger documents
  • Modifying text in word to look the same as a header style is not the same as setting its stylename to 'header'

====

Requirements:

  • PHP 5.3 or greater
  • /tmp writable by PHP