Download the PHP package dskripchenko/php-docx without Composer

On this page you can find all versions of the php package dskripchenko/php-docx. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of dskripchenko/php-docx

Informations about the package php-docx

dskripchenko/php-docx

Pure-PHP DOCX (Office Open XML) library: bidirectional HTML ↔ DOCX conversion, fluent programmatic builder, variable detection, round-trip-safe AST. No external dependencies beyond standard PHP extensions.

Read this in other languages: English · Русский · 中文 · Deutsch

Table of contents

Features

Out of scope

Tracked changes, comments, embedded charts, OLE objects, footnotes/endnotes, SmartArt, math equations (OMML), form fields, custom XML parts.

Requirements

Installation

Quick start

1. HTML → DOCX

2. Programmatic builder

3. DOCX → HTML / AST

HTML → DOCX

Input HTML must use inline styles only (no <style> blocks). Use a CSS-inliner upstream if needed.

Supported elements

Category HTML tags
Text blocks <p>, <h1..h6>, <div>, <pre>, <blockquote>
Inline marks <strong>/<b>, <em>/<i>, <u>, <s>/<del>, <sup>, <sub>, <mark>
Code/teletype <code>, <kbd>, <samp>, <var>, <cite>, <dfn>, <q>, <small>
Links <a href> external, <a href="#anchor"> internal, <a id> bookmarks
Images <img src="data:image/...;base64,...">
Tables <table>, <thead>/<tbody>, <tr>, <th>/<td>, <colgroup>/<col>, <caption>, colspan, rowspan
Lists <ul>, <ol type="a/A/i/I" start="N">, <li value="N">, <dl>/<dt>/<dd>
Custom tags <page-number/>, <page-total/>, <current-date format="...">, <page-break>
Layout <hr>, <br>, <figure>/<figcaption>

Inline styles

The converter understands style="…" properties:

Custom tags

These become OOXML field codes (<w:fldSimple w:instr="PAGE">).

Custom heading styles

Programmatic builder API

The Build namespace provides a fluent API for assembling DOCX documents block by block, finalising to the same immutable AST that the HTML pipeline produces.

DocumentBuilder

Entry point. Accumulates body, header/footer, watermark, page setup.

ParagraphBuilder

Inside ->paragraph(fn ($p) => …):

Paragraph-level styling:

TableBuilder

Spans and merges:

ListBuilder

RunStyleBuilder

Used inside ->styled(text, fn (RunStyleBuilder) => …) or standalone via RunStyleBuilder::new()->…->build().

Length helpers

Convert common units to OOXML twips (1 twip = 1/20 pt). Used wherever a twip int is expected.

Most builders expose unit-aware shortcuts:

DOCX → HTML (Reader)

High-level: DocxReader

This runs the full pipeline: package unpack → styles resolve → body/header/footer parsing → vMerge/list reconstruction → image extraction → watermark detection → page setup.

Low-level: DocxPackageReader

If you need the raw OOXML parts:

Serializer: AST → HTML

HTML output uses inline styles only — re-loadable into the same library via Html\Converter::fromHtml($imported->bodyHtml).

Headers, footers & watermarks

Three header/footer types are supported per section: default, first (title page), even (even pages). Word automatically renders the right one based on page number.

The writer automatically:

Watermark

Renders as a 45°-rotated VML text shape on every page.

Variable detection

Scans an imported DOCX for three kinds of variables:

  1. MERGEFIELD — Word mail-merge native, both simple <w:fldSimple> and complex <w:fldChar> form.
  2. SDT content controls — <w:sdt> with <w:tag w:val="...">.
  3. Text patterns — configurable regexes (defaults: {{name}}, ${name}, %name%).

Detection runs across body + all headers + all footers. Results are deduplicated by (source, name).

Length helpers

See Length helpers above. Conversion table:

Unit Twips Pt Notes
1 twip 1 0.05 OOXML native
1 pt 20 1 typography
1 mm ~57 2.83 metric
1 cm ~567 28.35 metric
1 inch 1440 72 imperial
1 px 15 0.75 CSS @ 96 DPI

AST overview

All elements live under Dskripchenko\PhpDocx\Element namespace.

Element Type Notes
Document root { section: Section, watermarkText: ?string }
Section container { body, header, footer, pageSetup, firstHeader, firstFooter, evenHeader, evenFooter }
Paragraph BlockElement { children: InlineElement[], style: ParagraphStyle, headingLevel: ?int }
Run InlineElement { text: string, style: RunStyle }
Hyperlink InlineElement { href: ?string, anchor: ?string, children: InlineElement[] }
Bookmark InlineElement { name: string, children: InlineElement[] }
Image both { binary, format, widthEmu, heightEmu, altText }
Field InlineElement { instruction: string, style: RunStyle }
LineBreak, PageBreak, HorizontalRule both marker elements
Table BlockElement { rows: TableRow[], style, caption, gridColumnsTwips }
TableRow element { cells: TableCell[], isHeader, heightTwips }
TableCell element { children: BlockElement[], style: CellStyle }
ListNode BlockElement { items: ListItem[], ordered, format, startAt }
ListItem element { children: InlineElement[], nestedList: ?ListNode }

Styles live under Dskripchenko\PhpDocx\Style:

Round-trip

The library targets semantic round-trip safety, not byte equality — content, structure and styling survive, but XML ordering and whitespace may differ.

In-scope round-trip features:

Out-of-scope features are silently dropped (footnotes, comments, equations, etc.).

Architecture

The same Document AST is shared by HTML conversion, programmatic construction and DOCX reading — every entry/exit point operates on typed value-objects.

Development

License

MIT — see LICENSE.

All versions of php-docx with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
ext-dom Version *
ext-mbstring Version *
ext-zip Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package dskripchenko/php-docx contains the following files

Loading the files please wait ...