Download the PHP package akankov/html-min without Composer
On this page you can find all versions of the php package akankov/html-min. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download akankov/html-min
More information about akankov/html-min
Files in akankov/html-min
Package html-min
Short Description HTML compressor and minifier for PHP 8.3+
License MIT
Homepage https://github.com/akankov/html-min
FAQ
Example:
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 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.
Informations about the package html-min
html-min
A fast HTML5 compressor and minifier for PHP. Strips redundant whitespace, comments, optional tags, and default attributes, then sorts what's left so your gzip layer has less work to do.
Built on native \DOMDocument — no third-party DOM dependencies.
Requirements
- PHP 8.3, 8.4, or 8.5
- ext-dom, ext-libxml, ext-mbstring
Installation
Usage
Wrap any block in <nocompress>…</nocompress> to keep its whitespace intact.
Configuration
Every option is a chainable setter. All defaults are shown — the example below reproduces the default configuration.
Each setter returns $this, so you can configure and call minify() in one chain.
Presets
MinifierOptions ships three named starting points so you don't have to
reason about all 27 flags at once:
defaults()— the balanced configuration shown above. Safe for almost any HTML; output is spec-equivalent to the input.aggressive()— maximum byte savings within what the HTML5 spec allows. Adds block-tag whitespace trimming, whitespace-only text-node removal,<html>/<head>/<body>start-tag omission, spec-default attribute removal, and inline CSS/JS minification. Two trade-offs to know: whitespace between inline elements is rendering-significant, so markup that relies on</span> <span>spacing can render tighter; and start-tag omission can reduce an effectively-empty document — a bare html/head/body skeleton — to an empty string, which is correct per spec but surprising the first time. URL scheme stripping stays off even here because protocol-relative URLs change meaning outside an http(s) context.conservative()— shape-preserving: only collapses whitespace runs, strips comments, and drops spec-redundant deprecated attributes. Keeps optional end tags, attribute quotes, attribute/class order, and empty attributes. Use it when output is diffed against input, post-processed by shape-sensitive tools, or styled via selectors like[data-x=""].
Presets are plain constructors — start from one and override per-flag with the fluent setters if you need a variation.
Inline CSS and JS minification
By default the contents of <style> and <script> blocks round-trip untouched.
Enable the two opt-in toggles to minify them:
The bundled minifiers are zero-dependency and conservative:
- CSS — strips
/* … */comments and collapses whitespace; the contents of strings andurl(…)are preserved. - JS — removes comments and collapses horizontal whitespace while preserving newlines (so Automatic Semicolon Insertion is unaffected), strings, regex literals, and template literals. Identifiers are never renamed.
Scripts that are not JavaScript are left alone automatically: a <script>
whose type is, for example, application/ld+json or text/x-template, and any
<script src="…">, passes through unminified.
Using a different minifier
For aggressive minification (identifier renaming, dead-code removal), plug in a
third-party tool with setInlineCssMinifier() / setInlineJsMinifier(). Each
takes any callable(string): string; pass null to restore the bundled default.
If a bundled minifier throws, the original source is kept and a warning is sent
to the PSR-3 logger (when one is set via setLogger()), so a minifier bug can
never corrupt the page. User-supplied callables let their exceptions propagate.
Command line
The package ships a small CLI at vendor/bin/html-min — handy for one-off
minification, build pipelines, and inspecting what a config change does:
Exit codes: 0 success, 1 I/O failure (unreadable input / unwritable
--output), 2 invalid argument. --help prints the full usage text.
make phar builds a self-contained dist/html-min.phar for use outside a
Composer project.
Extending
To run your own pass over every element during minification, implement
Akankov\HtmlMin\Contract\DomObserver and register it:
Observer practicalities worth knowing before you ship one:
- Phases.
attachObserverToTheDomLoop()takes an optionalObserverPhase(Before,After, or the defaultBoth):domElementBeforeMinification()runs in the pre-pass, before attribute optimization;domElementAfterMinification()in the post-pass. Register for only the phase you need — each hook fires for every element on everyminify()call, so heavy work multiplies across the document. - Ordering. Observers run in registration order within a phase, and the
built-in
OptimizeAttributesobserver is registered first (in theAfterphase) — your after-phase observers see already-optimized attributes. There is no priority system. - Branch on the live config. The second argument is the owning
HtmlMinInterface; itsisDo*()getters reflect the actual flags, so an observer can follow e.g.isDoRemoveHttpPrefixFromAttributes()instead of duplicating configuration. - Exceptions propagate. The DOM walk does not wrap observer calls — a
throwing observer aborts the whole
minify()call. Catch inside the observer if a page must never break on observer bugs. - Mutating the tree is the point, but removing the element you were just handed (or re-parenting its ancestors) mid-walk can skip nodes — prefer attribute and text mutations, and removal of descendants.
Benchmarks
Measured against voku/html-min, zaininnari/html-minifier, and abordage/html-min on a corpus of real-world HTML pages.
| adapter | median ms/op | geomean ms/op | parse failures | avg gzipped ratio |
|---|---|---|---|---|
| akankov/html-min | 2.0 | 2.1 | 0 / 15 | 90.7% |
| akankov/html-min (inline) | 2.2 | 2.7 | 0 / 15 | 87.6% |
| voku/html-min | 3.4 | 3.8 | 0 / 15 | 90.2% |
| zaininnari/html-minifier | 9.5 | 8.2 | 0 / 15 | 94.8% |
| abordage/html-min † | 0.2 | 0.2 | 0 / 15 | 90.2% |
The table above is regenerated by make bench from the latest run.
See latest.md for the per-fixture detail (speed, peak memory,
gzipped compression ratio, methodology, and non-claims). Reproduce with
make bench-install && make bench (requires Docker).
Development
CI runs the full matrix (PHP 8.3 / 8.4 / 8.5) on every push and pull request.
License
MIT — see LICENSE.
Originally authored by Lars Moelleken; maintained in this fork by Alex Kankov.
All versions of html-min with dependencies
ext-dom Version *
ext-libxml Version *
ext-mbstring Version *
psr/http-factory Version ^1.0
psr/http-message Version ^1.1 || ^2.0
psr/http-server-middleware Version ^1.0
psr/log Version ^3.0