HTML Min

https://github.com/akankov/html-min
Admin
A fast HTML5 compressor and minifier for PHP that strips redundant whitespace, comments, optional...
Tokens:61,559
Snippets:368
Trust Score:5.4
License:MIT
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install dependencies

Source: https://github.com/akankov/html-min/blob/main/CONTRIBUTING.md

Install project dependencies from the repository root using Composer.

```bash
composer install
```

--------------------------------

### MinifierOptions Presets

Source: https://github.com/akankov/html-min/blob/main/README.md

Predefined configurations for quick setup.

```APIDOC
## MinifierOptions Presets

### Description
Provides named starting points for configuration to avoid manual setup of all flags.

### Methods
- **defaults()**: Balanced configuration, safe for almost any HTML.
- **aggressive()**: Maximum byte savings, includes aggressive whitespace trimming and tag omission.
- **conservative()**: Shape-preserving, only performs safe optimizations like comment stripping and whitespace collapsing.
```

--------------------------------

### Early PHP/FI Syntax Example

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/wikipedia-article.html

An example of the early PHP/FI syntax demonstrating HTML embedding, environment variable retrieval, conditional logic, and database queries.

```PHP/FI
<!--include /text/header.html-->

<!--getenv HTTP_USER_AGENT-->
<!--if substr $exec_result Mozilla-->
  Hey, you are using Netscape!<p>
<!--endif-->

<!--sql database select * from table where user='$username'-->
<!--ifless $numentries 1-->
  Sorry, that record does not exist<p>
<!--endif exit-->
  Welcome <!--$user-->!<p>
  You have <!--$index:0--> credits left in your account.<p>

<!--include /text/footer.html-->
```

--------------------------------

### Run Benchmarks

Source: https://github.com/akankov/html-min/blob/main/README.md

Commands to install benchmark dependencies and execute the benchmark suite using Docker.

```bash
make bench-install && make bench
```

--------------------------------

### Run benchmark commands

Source: https://github.com/akankov/html-min/blob/main/benchmarks/README.md

Commands to install dependencies and execute benchmark runs. Use bench-quick for faster local regression checks.

```bash
make bench-install   # install dependencies once (~1 minute)
make bench           # full run (~5-10 minutes, writes latest.md)
make bench-quick     # faster run with fewer iterations, for local regression checks
```

--------------------------------

### Install html-min via Composer

Source: https://github.com/akankov/html-min/blob/main/README.md

Use this command to add the html-min package to your PHP project.

```bash
composer require akankov/html-min
```

--------------------------------

### Configure HtmlMin with chainable setters

Source: https://github.com/akankov/html-min/blob/main/README.md

This example demonstrates how to configure the HtmlMin instance using chainable setters, reproducing the default configuration.

```php
$htmlMin = (new HtmlMin())
    // Core
    ->doOptimizeViaHtmlDomParser(true)   // run the DOM-based pass (required for most of the flags below)
    ->doRemoveComments(true)             // drop HTML comments (conditional comments are preserved)
    ->doSumUpWhitespace(true)            // collapse runs of whitespace in text nodes
    ->doRemoveWhitespaceAroundTags(false)// aggressive: also trim whitespace adjacent to block tags
    ->doRemoveSpacesBetweenTags(false)   // aggressive: remove whitespace-only text nodes between elements

    // Attribute optimization
    ->doOptimizeAttributes(true)
    ->doSortHtmlAttributes(true)         // canonical attribute order → better gzip
    ->doSortCssClassNames(true)          // canonical class order → better gzip
    ->doRemoveOmittedQuotes(true)        // class="foo" → class=foo when safe
    ->doRemoveOmittedHtmlTags(true)      // <p>x</p> → <p>x where the closing tag is optional
    ->doRemoveOmittedHtmlStartTags(false)// aggressive: also omit the <html>/<head>/<body> START tags
    ->doRemoveEmptyAttributes(true)
    ->doRemoveValueFromEmptyInput(true)
    ->doRemoveDefaultAttributes(false)   // opt-in: drop defaults like form method=get

    // URL attribute trimming
    ->doRemoveHttpPrefixFromAttributes(false)
    ->doRemoveHttpsPrefixFromAttributes(false)
    ->doKeepHttpAndHttpsPrefixOnExternalAttributes(false)
    ->doMakeSameDomainsLinksRelative([])       // e.g. ['example.com'] → strip host from same-site links

    // Deprecated attribute cleanup
    ->doRemoveDeprecatedAnchorName(true)
    ->doRemoveDeprecatedScriptCharsetAttribute(true)
    ->doRemoveDeprecatedTypeFromScriptTag(true)
    ->doRemoveDeprecatedTypeFromStylesheetLink(true)
    ->doRemoveDeprecatedTypeFromStyleAndLinkTag(true)
    ->doRemoveDeprecatedTypeFromStyleAndLinkTag(true)
    ->doRemoveDefaultMediaTypeFromStyleAndLinkTag(true)
    ->doRemoveDefaultTypeFromButton(false)

    // Inline CSS / JS minification (opt-in, off by default)
    ->doMinifyInlineCss(false)           // minify the contents of inline <style> blocks
    ->doMinifyInlineJs(false);           // minify the contents of inline <script> blocks

echo $htmlMin->minify($html);
```

--------------------------------

### HTML Paragraph Content Example

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/blog-post.html

A demonstration of multiple paragraphs in HTML.

```html
<p>
  This is the first paragraph of text. This is the first paragraph of text. This
  is the first paragraph of text. This is the first paragraph of text.
</p>
<p>
  This is the second paragraph. This is the second paragraph. This is the second
  paragraph. This is the second paragraph.
</p>
```

--------------------------------

### CSS Import and Hack Examples

Source: https://github.com/akankov/html-min/blob/main/tests/fixtures/base2_result.html

Demonstrates CSS @import usage and various CSS hacks for browser compatibility.

```css
@import "/001/001.css"; /*\*/ css hack {} /* */ /* normal CSS comment */ /*/*/ css hack {} /* */ css hack { display/**/:/**/none; display:none; }
```

--------------------------------

### CSS Styling for Paragraphs

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/blog-post.html

Example of applying margin, padding, and borders to <p> elements.

```css
p {
  margin: 10px 0;
  padding: 5px;
  border: 1px solid #999999;
}
```

--------------------------------

### PHP 8 Object-Oriented Programming Implementation

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/wikipedia-article.html

A basic example demonstrating abstract classes, inheritance, and constructor property promotion in PHP 8.

```php
<?php

abstract class User
{
    protected string $name;

    public function __construct(string $name)
    {
        // make first letter uppercase and the rest lowercase
        $this->name = ucfirst(strtolower($name));
    }

    public function greet(): string
    {
        return "Hello, my name is " . $this->name;
    }

    abstract public function job(): string;
}

class Student extends User
{
    public function __construct(string $name, private string $course)
    {
        parent::__construct($name);
    }

    public function job(): string
    {
        return "I learn " . $this->course;
    }
}

class Teacher extends User
{
    public function __construct(string $name, private array $teachingCourses)
    {
        parent::__construct($name);
    }

    public function job(): string
    {
        return "I teach " . implode(", ", $this->teachingCourses);
    }
}

$students = [
    new Student("Alice", "Computer Science"),
    new Student("Bob", "Computer Science"),
    new Student("Charlie", "Business Studies"),
];

$teachers = [
    new Teacher("Dan", ["Computer Science", "Information Security"]),
    new Teacher("Erin", ["Computer Science", "3D Graphics Programming"]),
    new Teacher("Frankie", ["Online Marketing", "Business Studies", "E-commerce"]),
];

foreach ([$students, $teachers] as $users) {
    echo $users[0]::class . "s:\n";

    array_walk($users, function (User $user) {
        echo "{$user->greet()}, {$user->job()}\n";
    });
}
```

--------------------------------

### Inline Script Example

Source: https://github.com/akankov/html-min/blob/main/tests/fixtures/base1_result.html

A simple script tag defining a variable.

```html
<script>var Hello = 'world';</script>
```

--------------------------------

### Loop and Conditional Logic

Source: https://github.com/akankov/html-min/blob/main/tests/fixtures/base2_result.html

Basic JavaScript loop and conditional expression examples.

```javascript
var i = 0; while (++i < 10) { // ... }i = 1;(i < 1);
```

--------------------------------

### HTML Paragraph Structure

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/blog-post.html

Basic example of using <p> tags to define paragraphs.

```html
<p>
  Geckos are a group of usually small, usually nocturnal lizards. They are found
  on every continent except Antarctica.
</p>

<p>
  Some species live in houses where they hunt insects attracted by artificial
  light.
</p>
```

--------------------------------

### PHP Hello World in HTML

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/wikipedia-article.html

An example of a Hello World program written in PHP embedded within an HTML document using the echo short tag.

```html
<!DOCTYPE html>
<html>
    <head>
        <title>PHP "Hello, World!" program</title>
    </head>
    <body>
        <p><?= 'Hello, World!' ?></p>
    </body>
</html>
```

--------------------------------

### Include Popper and Bootstrap JS separately

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/bootstrap-docs.html

An alternative setup for including Popper and Bootstrap JS individually if you do not require the full bundle.

```html
<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js" integrity="sha384-I7E8VVD/ismYTF4hNIPjVp/Zjvgyol6VFvRkX/vR+Vc4jQkC+hVqc2pM8ODewa9r" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/js/bootstrap.min.js" integrity="sha384-G/EV+4j2dNv+tEPo3++6LCgdCROaejBqfUeNjuKAiuXbjrxilcCdDz6ZAVfHWe1Y" crossorigin="anonymous"></script>
```

--------------------------------

### Minify HTML content

Source: https://github.com/akankov/html-min/blob/main/README.md

Example showing how to instantiate HtmlMin and minify an HTML string. The output demonstrates the removal of unnecessary whitespace and tags.

```php
use Akankov\HtmlMin\HtmlMin;

$html = <<<HTML
<html>
  <body>
    <ul style="">
      <li style="display: inline;" class="foo">One</li>
      <li class="foo" style="display: inline;">Two</li>
    </ul>
  </body>
</html>
HTML;

echo (new HtmlMin())->minify($html);
// <html><body><ul><li class=foo style="display: inline;">One<li class=foo style="display: inline;">Two</ul>
```

--------------------------------

### Whitespace preservation example

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/small/base2.html

A block demonstrating the importance of whitespace preservation in the document.

```text
	White  space  is  important   here!
		
```

--------------------------------

### PHP Object-Oriented Programming Output

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/wikipedia-article.html

The console output generated by the PHP object-oriented programming example.

```text
Students:
Hello, my name is Alice, I learn Computer Science
Hello, my name is Bob, I learn Computer Science
Hello, my name is Charlie, I learn Business Studies
Teachers:
Hello, my name is Dan, I teach Computer Science, Information Security
Hello, my name is Erin, I teach Computer Science, 3D Graphics Programming
Hello, my name is Frankie, I teach Online Marketing, Business Studies, E-commerce
```

--------------------------------

### Defining a custom PHP function

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/wikipedia-article.html

Example of a user-defined function that calculates age based on a birth year and returns a formatted string.

```php
function myAge(int $birthYear): string
{
    // calculate the age by subtracting the birth year from the current year.
    $yearsOld = date('Y') - $birthYear;

    // return the age in a descriptive string.
    return $yearsOld . ($yearsOld == 1 ? ' year' : ' years');
}

echo 'I am currently ' . myAge(1995) . ' old.';
```

--------------------------------

### Development Commands

Source: https://github.com/akankov/html-min/blob/main/README.md

Standard commands for setting up the environment, running tests, performing static analysis, and fixing code style.

```bash
composer install
make md-check                 # markdown formatting (Docker)
vendor/bin/phpunit            # tests
vendor/bin/phpstan analyse    # static analysis (level max)
vendor/bin/php-cs-fixer fix   # code style
```

--------------------------------

### MediaWiki JavaScript Configuration

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/wikipedia-article.html

Initializes the MediaWiki environment by pushing configuration settings and performance metrics into the RLQ queue.

```javascript
(RLQ=window.RLQ||[]).push(function(){mw.config.set({"wgHostname":"mw-web.eqiad.main-64b76658d5-smk7z","wgBackendResponseTime":153,"wgPageParseReport":{"limitreport":{"cputime":"1.942","walltime":"3.037","ppvisitednodes":{"value":19968,"limit":1000000},"revisionsize":{"value":141423,"limit":2097152},"postexpandincludesize":{"value":659726,"limit":2097152},"templateargumentsize":{"value":63467,"limit":2097152},"expansiondepth":{"value":23,"limit":100},"expensivefunctioncount":{"value":85,"limit":500},"unstrip-depth":{"value":1,"limit":20},"unstrip-size":{"value":1281873,"limit":5000000},"entityaccesscount":{"value":1,"limit":500},"timingprofile":["100.00% 2702.115 1 -total"," 31.36% 847.490 2 Template:Reflist"," 26.34% 711.646 324 Template:Cite_web"," 18.45% 498.474 47 Template:Code"," 12.89% 348.195 3 Template:Infobox"," 10.29% 278.029 1 Template:Infobox_programming_language"," 7.19% 194.305 1 Template:Infobox_software/simple"," 6.42% 173.513 2 Template:Wikidata"," 2.82% 76.253 11 Template:Citation_needed"," 2.51% 67.764 1 Template:Short_description"]},"scribunto":{"limitreport-timeusage":{"value":"1.161","limit":"10.000"},"limitreport-memusage":{"value":18764505,"limit":52428800},"limitreport-logs":"value too small\t0\tPHP 5.0: \u003C0.1% of PHP 5 (0.00%)\nvalue too small\t0.0222\tPHP 4.3: 22.2% of PHP 4 (0.02%)\nvalue too small\t0.0026\tPHP 4.2: 2.60% of PHP 4 (0.00%)\nvalue too small\t0.0007\tPHP 4.1: 0.70% of PHP 4 (0.00%)\nvalue too small\t0.0007\tPHP 4.0: 0.70% of PHP 4 (0.00%)\n"},"cachereport":{"origin":"mw-web.eqiad.main-64b76658d5-hvbbl","timestamp":"20260420134052","ttl":39600,"transientcontent":true,"expiry-source":"Module:Time_ago (formatDate)"}}});});
```

--------------------------------

### Initialize HtmlMin with presets

Source: https://github.com/akankov/html-min/blob/main/README.md

Use MinifierOptions presets to initialize HtmlMin with predefined configurations for different levels of minification.

```php
use Akankov\HtmlMin\Config\MinifierOptions;
use Akankov\HtmlMin\HtmlMin;

$balanced     = new HtmlMin(MinifierOptions::defaults());     // same as new HtmlMin()
$smallest     = new HtmlMin(MinifierOptions::aggressive());
$shapeStable  = new HtmlMin(MinifierOptions::conservative());
```

--------------------------------

### Create a basic HTTP server with ReactPHP

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/small/code.html

This script initializes an event loop and a socket server on port 1337 to handle HTTP requests. It responds to every request with 'Hello World'.

```php
<?php

    require 'vendor/autoload.php';

    $loop = React\EventLoop\Factory::create();
    $socket = new React\Socket\Server($loop);
    $http = new React\Http\Server($socket, $loop);

    $http->on('request', function ($request, $response) {
    $response->writeHead(200, array('Content-Type' => 'text/plain'));
    $response->end("Hello World\n");
    });

    $socket->listen(1337);
    $loop->run();
```

--------------------------------

### Set Theme and NOP Preferences

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/blog-post.html

Initializes the document theme and NOP setting from localStorage, with error handling for potential access issues.

```javascript
try { document.documentElement.dataset.theme = localStorage.getItem("theme") || "light dark"; } catch (error) { console.warn("Unable to set theme", error); } try { if (localStorage.getItem("nop") === "yes") { document.documentElement.dataset["nop"] = "yes"; } } catch (error) { console.warn("Unable to set nop", error); }
```

--------------------------------

### PHP Variable Declaration and Initialization

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/wikipedia-article.html

Demonstrates how to declare and initialize variables of different types, including string, integer, and double, and how to output them using concatenation and interpolation.

```php
<?php
    $name = 'John';  // variable of string type being declared and initialized
    $age = 18;       // variable of integer type being declared and initialized
    $height = 5.3;   // variable of double type being declared and initialized
    echo $name . ' is ' . $height . "m tall\n"; // concatenating variables and strings
    echo "$name is $age years old."; // interpolating variables to string
?>
```

--------------------------------

### Check Markdown documentation

Source: https://github.com/akankov/html-min/blob/main/CONTRIBUTING.md

Verify Markdown documentation formatting using the Dockerized Prettier tool.

```bash
make md-check
```

--------------------------------

### Product Schema metadata

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/inline-heavy-landing.html

JSON-LD structured data for the html-min product.

```json
{ "@context": "https://schema.org", "@type": "Product", "name": "html-min", "description": "HTML compressor and minifier for PHP" }
```

--------------------------------

### Configuration Methods

Source: https://github.com/akankov/html-min/blob/main/README.md

Methods to configure the minification behavior, including enabling inline CSS/JS minification and setting custom minifier callables.

```APIDOC
## Configuration Methods

### doMinifyInlineCss(bool $minify)
Enables or disables minification of contents within <style> tags.

### doMinifyInlineJs(bool $minify)
Enables or disables minification of contents within <script> tags.

### setInlineCssMinifier(callable $minifier)
Sets a custom callable to handle CSS minification. Pass null to restore the default.

### setInlineJsMinifier(callable $minifier)
Sets a custom callable to handle JS minification. Pass null to restore the default.

### setLogger(Psr\Log\LoggerInterface $logger)
Sets a PSR-3 logger to capture warnings if a bundled minifier fails.
```

--------------------------------

### Implement DomObserver for Custom Minification

Source: https://github.com/akankov/html-min/blob/main/README.md

Implement the DomObserver contract to run custom logic during the minification process. Register the observer using attachObserverToTheDomLoop to modify elements during the DOM walk.

```php
use Akankov\HtmlMin\Contract\DomObserver;
use Akankov\HtmlMin\Contract\HtmlMinInterface;
use Akankov\HtmlMin\HtmlMin;

final class StripDataTestIds implements DomObserver
{
    public function domElementBeforeMinification(\DOMElement $element, HtmlMinInterface $htmlMin): void
    {
    }

    public function domElementAfterMinification(\DOMElement $element, HtmlMinInterface $htmlMin): void
    {
        if ($element->hasAttribute('data-testid')) {
            $element->removeAttribute('data-testid');
        }
    }
}

$htmlMin = new HtmlMin();
$htmlMin->attachObserverToTheDomLoop(new StripDataTestIds());
echo $htmlMin->minify($html);
```

--------------------------------

### Minify HTML via CLI

Source: https://github.com/akankov/html-min/blob/main/README.md

Use the vendor/bin/html-min binary for file minification, piping, or applying specific minification flags.

```bash
vendor/bin/html-min page.html                      # minify a file to stdout
vendor/bin/html-min page.html --output=page.min.html
cat page.html | vendor/bin/html-min                # stdin → stdout
vendor/bin/html-min page.html --minify-inline-css --minify-inline-js
```

--------------------------------

### Bootstrap Component Initialization

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/bootstrap-docs.html

The v function initializes tooltips, popovers, toasts, alerts, carousels, and modal interactions across the documentation pages.

```javascript
v=()=>{document.querySelectorAll('[data-bs-toggle="tooltip"]').forEach(e=>{new bootstrap.Tooltip(e)}),document.querySelectorAll('[data-bs-toggle="popover"]').forEach(e=>{new bootstrap.Popover(e)});const t=document.getElementById("toastPlacement");t&&document.getElementById("selectToastPlacement").addEventListener("change",function(){t.dataset.originalClass||(t.dataset.originalClass=t.className),t.className=`${t.dataset.originalClass} ${this.value}`}),document.querySelectorAll(".bd-example .toast").forEach(e=>{new bootstrap.Toast(e,{autohide:!1}).show()});const a=document.getElementById("liveToastBtn"),c=document.getElementById("liveToast");if(a){const e=bootstrap.Toast.getOrCreateInstance(c);a.addEventListener("click",()=>{e.show()})}const i=document.getElementById("liveAlertPlaceholder"),r=(e,o)=>{const l=document.createElement("div");l.innerHTML=[`<div class="alert alert-${o} alert-dismissible" role="alert">`,` <div>${e}</div>`,' <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>',"</div>"].join(""),i.append(l)},n=document.getElementById("liveAlertBtn");n&&n.addEventListener("click",()=>{r("Nice, you triggered this alert message!","success")}),document.querySelectorAll('.carousel:not([data-bs-ride="carousel"])').forEach(e=>{bootstrap.Carousel.getOrCreateInstance(e)}),document.querySelectorAll('.bd-example-indeterminate [type="checkbox"]').forEach(e=>{e.id.includes("Indeterminate")&&(e.indeterminate=!0)}),document.querySelectorAll('.bd-content [href="#"]').forEach(e=>{e.addEventListener("click",o=>{o.preventDefault()})});const s=document.getElementById("exampleModal");s&&s.addEventListener("show.bs.modal",e=>{const l=e.relatedTarget.getAttribute("data-bs-whatever"),m=s.querySelector(".modal-title"),u=s.querySelector(".modal-body input");m.textContent=`New message to ${l}`,u.value=l});const d=document.querySelectorAll(".bd-example-offcanvas .offcanvas");d&&d.forEach(e=>{e.addEventListener("show.bs.offcanvas",o=>{o.preventDefault()},!1)})};p();v();
```

--------------------------------

### Applying type declarations to functions

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/wikipedia-article.html

Shows how to annotate function parameters and return types in PHP 7, including how incorrect types trigger exceptions.

```php
function getAdder(int $x): Closure
{
    return fn(int $y): int => $x + $y;
}

$adder = getAdder(8);
echo $adder(2); // prints "10"
echo $adder(null); // throws an exception because an incorrect type was passed
$adder = getAdder([]); // would also throw an exception
```

--------------------------------

### PHP Syntax Highlighter Controller

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/small/base4.html

This script handles the retrieval of code snippets from the database, manages password-protected access, and prepares the template variables for rendering with Prism.

```php
<?php if(!defined('barlall') && barlall!='Public') die('Access denied');

if(!isset($DB)) {
    $DB = new db();
}
$URL = Bootstrap(1);
$code_unique = md5($URL);
include CfgPath.'prism.php';

$TPL->SetSiteTitle($LANG['Syntax_Highlighter']);
$TPL->SetMetaDescription($LANG['Syntax_Highlighter_Desc']);
$TPL->Load('bootstrap-select');
$TPL->Load('select_picker');

if($URL) {
    $DB->query('SELECT code_id,code_url,code_title,code_lang,code_text,code_notes,code_author,code_password,code_editpassword,created,updated FROM '.TBL_syntaxhigh.' WHERE code_unique=:code_unique AND deleted IS NULL LIMIT 1');
    $DB->str(':code_unique',$code_unique);
    if($code = $DB->fetch_row()) {
        if($code = $DB->fetch_row()) {
            if($code['code_password'] && !isset($_SESSION[$code['code_url']]) && $_SESSION[$code['code_url']]!='access') {
                $show_title=$lang_row=$show_notes='';
                if($code['code_title']) {
                    $TPL->set('code_title',$code['code_title']);
                    $show_title = $TPL->writeTpl('Syntax-Highlighter/show/title');
                    $TPL->SetSiteTitle($code['code_title'].' « '.$LANG['Syntax_Highlighter']);
                }

                $code_lang = isset($_POST['code_lang']) && $_POST['code_lang']!='' ? $_POST['code_lang']:$code['code_lang'];

                foreach ($_PRISM_LANGUAGES as $prism_language => $prism_class) {
                    $selected = $prism_class==$code_lang ? ' selected':'';
                    $lang_row.= '<option value="'.$prism_class.'"'.$selected.'>'.HTMLChars($prism_language).'</option>';
                }

                if($code['code_notes']) {
                    $TPL->set('notes',HTMLChars($code['code_notes']));
                    $show_notes = $TPL->writeTpl('Syntax-Highlighter/show/notes');
                }

                $TPL->set('url',$_SERVER['SERVER_NAME'].REQUEST_URI);
                $TPL->set('code_lang',HTMLChars($code_lang));
                $TPL->set('code_text',HTMLChars($code['code_text']));
                $TPL->set('lang_row',$lang_row);
                $TPL->set('show_title',$show_title);
                $TPL->set('show_notes',$show_notes);

                $TPL->LoadPrism();
                $BODY.= $TPL->writeTpl('Syntax-Highlighter/show/show');
            }
        }
    } else {
        $TPL->NotFound();
    }
}

if(!$BODY) {
```

--------------------------------

### Create index.html boilerplate

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/bootstrap-docs.html

The initial HTML5 structure required for a Bootstrap project, including the viewport meta tag for responsive behavior.

```html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Bootstrap demo</title>
  </head>
  <body>
    <h1>Hello, world!</h1>
  </body>
</html>
```

--------------------------------

### Initialize baseline indicator state

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/blog-post.html

This script checks the localStorage for a baseline-indicator key and sets the corresponding details element to open if the value is 'open'.

```javascript
if (localStorage.getItem("baseline-indicator") === "open") { const indicator = document.querySelector(".baseline-indicator"); if (indicator instanceof HTMLDetailsElement) { indicator.open = true; } }
```

--------------------------------

### Responsive Media Queries

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/html-email.html

Layout adjustments for small screens, including full-width columns and typography scaling.

```css
/* Media Queries */ @media screen and (max-width: 600px) { .email-container { width: 100% !important; margin: auto !important; } /* What it does: Forces table cells into full-width rows. */ .stack-column, .stack-column-center { display: block !important; width: 100% !important; max-width: 100% !important; direction: ltr !important; } /* And center justify these ones. */ .stack-column-center { text-align: center !important; } /* What it does: Generic utility class for centering. Useful for images, buttons, and nested tables. */ .center-on-narrow { text-align: center !important; display: block !important; margin-left: auto !important; margin-right: auto !important; float: none !important; } table.center-on-narrow { display: inline-block !important; } /* What it does: Adjust typography on small screens to improve readability */ .email-container p { font-size: 17px !important; } }
```

--------------------------------

### Creating closures with arrow syntax

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/wikipedia-article.html

Demonstrates using the arrow function syntax introduced in PHP 7.4 to create a closure that captures variables from the surrounding scope.

```php
function getAdder($x) {
    return fn($y) => $x + $y;
}

$adder = getAdder(8);
echo $adder(2);  // prints "10"
```

--------------------------------

### Update benchmark report

Source: https://github.com/akankov/html-min/blob/main/benchmarks/README.md

Workflow for regenerating the latest.md report on a clean commit.

```bash
1. Make sure you're on a clean commit — the report header captures the git SHA.
2. make bench — writes latest.md.
3. git add latest.md && git commit -m "docs(benchmarks): refresh".
```

--------------------------------

### Include Bootstrap CSS and JS bundle

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/bootstrap-docs.html

Integrate Bootstrap by adding the CSS link in the head and the bundle script before the closing body tag.

```html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Bootstrap demo</title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-sRIl4kxILFvY47J16cr9ZwB07vP4J8+LH7qKQnuqkuIAvNWLzeN8tE5YBujZqJLB" crossorigin="anonymous">
  </head>
  <body>
    <h1>Hello, world!</h1>
    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/js/bootstrap.bundle.min.js" integrity="sha384-FKyoEForCGlyvwx9Hj09JcYn3nv7wiPVlz7YYwJrWVcXK/BmnVDxM+D2scQbITxI" crossorigin="anonymous"></script>
  </body>
</html>
```

--------------------------------

### Configuration Setters

Source: https://github.com/akankov/html-min/blob/main/README.md

Fluent setters used to configure the minification behavior.

```APIDOC
## Configuration Setters

### Description
Every option is a chainable setter that returns the instance of `HtmlMin`. These methods allow for granular control over core optimization, attribute handling, URL trimming, and deprecated attribute cleanup.

### Usage
```php
$htmlMin = (new HtmlMin())
    ->doRemoveComments(true)
    ->doSortHtmlAttributes(true)
    ->doMinifyInlineCss(false);
```
```

--------------------------------

### Configure a custom inline minifier

Source: https://github.com/akankov/html-min/blob/main/README.md

Use setInlineCssMinifier() and setInlineJsMinifier() to provide custom callables for aggressive minification, such as using the matthiasmullie/minify library.

```php
use MatthiasMullie\Minify; // composer require matthiasmullie/minify

$htmlMin = (new HtmlMin())
    ->doMinifyInlineCss(true)
    ->doMinifyInlineJs(true)
    ->setInlineCssMinifier(static fn (string $css): string => (new Minify\CSS($css))->minify())
    ->setInlineJsMinifier(static fn (string $js): string => (new Minify\JS($js))->minify());

echo $htmlMin->minify($html);
```

--------------------------------

### Run local checks

Source: https://github.com/akankov/html-min/blob/main/CONTRIBUTING.md

Execute local development checks including PHPUnit, PHPStan, PHP-CS-Fixer, and Rector.

```bash
vendor/bin/phpunit
vendor/bin/phpstan analyse
vendor/bin/php-cs-fixer fix --dry-run --diff
vendor/bin/rector process --dry-run
```

--------------------------------

### Email Client Compatibility Fixes

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/html-email.html

Specific overrides for Apple Mail, Gmail, and image rendering issues.

```css
/* What it does: A work-around for email clients meddling in triggered links. */ a[x-apple-data-detectors], /* iOS */ .unstyle-auto-detected-links a, .aBn { border-bottom: 0 !important; cursor: default !important; color: inherit !important; text-decoration: none !important; font-size: inherit !important; font-family: inherit !important; font-weight: inherit !important; line-height: inherit !important; } /* What it does: Prevents Gmail from changing the text color in conversation threads. */ .im { color: inherit !important; } /* What it does: Prevents Gmail from displaying a download button on large, non-linked images. */ .a6S { display: none !important; opacity: 0.01 !important; } /* If the above doesn't work, add a .g-img class to any image in question. */ img.g-img + div { display: none !important; }
```

--------------------------------

### Syntax Highlighter PHP Logic

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/small/base4.html

Handles the processing of POST data for code snippets, including language selection, unique URL generation, and database insertion for the syntax highlighter.

```php
$lang = isset($_POST['lang']) && $_POST['lang']!='' ? $_POST['lang']:array_keys($_PRISM_LANGUAGES)[0];
        $code = isset($_POST['code']) && $_POST['code']!='' ? $_POST['code']:'';
    
        $lang_row='';
        foreach ($_PRISM_LANGUAGES as $prism_language => $prism_class) {
            $selected = $prism_language==$lang ? ' selected':'';
    
            $lang_row.= '<option value="'.$prism_class.'"'.$selected.'>'.HTMLChars($prism_language).'</option>';
        }
    
        function CreateURL()  {
            $USER 	= new user();
            $DB     = new db();
            $string = $USER->RandStr(8,true);
            $md5    = $string ? md5($string):'';
            $DB->query('SELECT code_id FROM '.TBL_syntaxhigh.' WHERE code_unique=:code_unique LIMIT 1');
            $DB->str('code_unique',$md5);
            if($q = $DB->fetch_row()) {
                $string = CreateURL();
            }
            if(!$string) {
                $string = CreateURL();
            }
            return $string;
        }
    
        if(isset($_POST['store']) && $lang && $code) {
            $code_url    = CreateURL();
            $code_unique = md5($code_url);
    
            $title             = isset($_POST['title']) && $_POST['title']!='' ? $_POST['title']:'';
            $notes             = isset($_POST['notes']) && $_POST['notes']!='' ? $_POST['notes']:'';
            $code_password     = isset($_POST['show-password']) && $_POST['show-password']!='' ? password_hash($_POST['show-password'], PASSWORD_DEFAULT):'';
            $code_editpassword = isset($_POST['edit-password']) && $_POST['edit-password']!='' ? password_hash($_POST['edit-password'], PASSWORD_DEFAULT):'';
            $DB->query('INSERT '.TBL_syntaxhigh.'
                (code_unique,code_url,code_title,code_lang,code_text,code_notes,code_author,code_password,code_editpassword,created)
                    VALUES
                (:code_unique,:code_url,:code_title,:code_lang,:code_text,:code_notes,:code_author,:code_password,:code_editpassword,:created)');
            $DB->str('code_unique',$code_unique);
            $DB->str('code_url',$code_url);
            $DB->str('code_title',$title);
            $DB->str('code_lang',$lang);
            $DB->str('code_text',$code);
            $DB->str('code_notes',$notes);
            $DB->str('code_author',$USER->id());
            $DB->str('code_password',$code_password);
            $DB->str('code_editpassword',$code_editpassword);
            $DB->str('created',$DB->datetime());
            $DB->execute();
    
            $USER->redirect('/'.$SITE.'/'.$code_url);
        }
    
        $TPL->set('title',isset($_POST['title']) && $_POST['title']!='' ? HTMLChars($_POST['title']):'');
        $TPL->set('code',isset($_POST['code']) && $_POST['code']!='' ? HTMLChars($_POST['code']):'');
        $TPL->set('notes',isset($_POST['notes']) && $_POST['notes']!='' ? HTMLChars($_POST['notes']):'');
        $TPL->set('lang_row',$lang_row);
    
        $BODY.= $TPL->writeTpl('Syntax-Highlighter/Syntax-Highlighter');
    }
```

--------------------------------

### Button Hover Styles

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/html-email.html

CSS transitions and hover states for email buttons.

```css
/* What it does: Hover styles for buttons */ .button-td, .button-a { transition: all 100ms ease-in; } .button-td-primary:hover, .button-a-primary:hover { background: #555555 !important; border-color: #555555 !important; }
```

--------------------------------

### Viewport Media Queries for iOS

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/html-email.html

Media queries to fix viewport widths for various iPhone models.

```css
/* What it does: Removes right gutter in Gmail iOS app: https://github.com/TedGoas/Cerberus/issues/89 */ /* Create one of these media queries for each additional viewport size you'd like to fix */ /* iPhone 4, 4S, 5, 5S, 5C, and 5SE */ @media only screen and (min-device-width: 320px) and (max-device-width: 374px) { u ~ div .email-container { min-width: 320px !important; } } /* iPhone 6, 6S, 7, 8, and X */ @media only screen and (min-device-width: 375px) and (max-device-width: 413px) { u ~ div .email-container { min-width: 375px !important; } } /* iPhone 6+, 7+, and 8+ */ @media only screen and (min-device-width: 414px) { u ~ div .email-container { min-width: 414px !important; } }
```

--------------------------------

### attachObserverToTheDomLoop(DomObserver $observer, ObserverPhase $phase = ObserverPhase::Both)

Source: https://github.com/akankov/html-min/blob/main/README.md

Registers a custom observer to hook into the DOM traversal process during minification.

```APIDOC
## Method: attachObserverToTheDomLoop

### Description
Registers an implementation of `DomObserver` to execute custom logic during the DOM traversal phase of minification.

### Signature
`public function attachObserverToTheDomLoop(DomObserver $observer, ObserverPhase $phase = ObserverPhase::Both): void`

### Parameters
- **observer** (DomObserver) - Required - The observer instance to attach.
- **phase** (ObserverPhase) - Optional - The phase during which the observer should run (Before, After, or Both).
```

--------------------------------

### JavaScript Initialization Script

Source: https://github.com/akankov/html-min/blob/main/tests/fixtures/inline_minify_full_page_result.html

A self-invoking function that adds a 'js' class to the document element and manages visibility based on document readiness.

```javascript
(function () { const root = document.documentElement; root.classList.add('js'); const ready = /^(complete|interactive)$/; if (ready.test(document.readyState)) { root.style.visibility = 'visible'; } })();
```

--------------------------------

### Minified CSS and Schema.org JSON-LD

Source: https://github.com/akankov/html-min/blob/main/tests/fixtures/inline_minify_full_page_result.html

Minified CSS styles and a JSON-LD script block used for the demo page.

```html
html{visibility:hidden}body,main{font-family:system-ui,sans-serif;margin:0 16px}{ "@context": "https://schema.org", "@type": "WebSite", "name": "Demo" }
```

--------------------------------

### Critical CSS for landing page

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/inline-heavy-landing.html

Contains the critical CSS styles inlined for first paint, including CSS variables, reset rules, and layout components like hero and grid.

```css
/* Critical CSS inlined for first paint */ :root { --brand: #1a73e8; --ink: #202124; --paper: #ffffff; --radius: 8px; } *, *::before, *::after { box-sizing: border-box; } html { -webkit-text-size-adjust: 100%; } body { margin: 0; font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif; color: var(--ink); background: var(--paper); line-height: 1.5; } .hero { padding: 64px 24px; text-align: center; background: linear-gradient(180deg, #f8f9fa 0%, #ffffff 100%); } .hero h1 { font-size: clamp(2rem, 5vw, 3.5rem); margin: 0 0 16px; } .btn { display: inline-block; padding: 12px 28px; border-radius: var(--radius); background: var(--brand); color: #fff; text-decoration: none; transition: transform 120ms ease, box-shadow 120ms ease; } .btn:hover { transform: translateY(-1px); box-shadow: 0 6px 18px rgba(26, 115, 232, 0.35); } .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 24px; padding: 48px 24px; max-width: 1100px; margin: 0 auto; } .card { border: 1px solid #e0e0e0; border-radius: var(--radius); padding: 20px; } @media (min-width: 768px) { .hero { padding: 96px 24px; } } .bg { background-image: url("data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciLz4="); }
```

--------------------------------

### Enable default inline CSS and JS minification

Source: https://github.com/akankov/html-min/blob/main/README.md

Use doMinifyInlineCss(true) and doMinifyInlineJs(true) to enable the library's built-in, conservative minification for inline styles and scripts.

```php
$htmlMin = (new HtmlMin())
    ->doMinifyInlineCss(true)
    ->doMinifyInlineJs(true);

echo $htmlMin->minify($html);
```

--------------------------------

### JavaScript Browser Detection and Logic

Source: https://github.com/akankov/html-min/blob/main/tests/fixtures/base1.html

Contains browser detection logic and basic loop structures within a script element.

```javascript
var is = { ie: navigator.appName == 'Microsoft Internet Explorer', java: navigator.javaEnabled(), ns: navigator.appName == 'Netscape', ua: navigator.userAgent.toLowerCase(), version: parseFloat(navigator.appVersion.substr(21)) || parseFloat(navigator.appVersion), win: navigator.platform == 'Win32' } is.mac = is.ua.indexOf('mac') >= 0; if (is.ua.indexOf('opera') >= 0) { is.ie = is.ns = false; is.opera = true; } if (is.ua.indexOf('gecko') >= 0) { is.ie = is.ns = false; is.gecko = true; } var i = 0; while (++i < 10) { // ... } i = 1; (i < 1);
```

--------------------------------

### Box-sizing Override

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/bootstrap-docs.html

CSS snippet to override the global border-box sizing back to content-box for specific third-party widgets.

```css
.selector-for-some-widget {
  box-sizing: content-box;
}
```

--------------------------------

### minify(string $html): string

Source: https://github.com/akankov/html-min/blob/main/README.md

The primary method to minify HTML content. It processes the input string and returns the minified version, optionally applying registered DOM observers.

```APIDOC
## Method: minify

### Description
Minifies the provided HTML string based on the current configuration and registered observers.

### Signature
`public function minify(string $html): string`

### Parameters
- **html** (string) - Required - The raw HTML content to be minified.

### Returns
- (string) - The minified HTML content.
```

--------------------------------

### Email Client CSS Resets

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/html-email.html

Standard resets for email clients to handle color schemes, margins, padding, and text sizing.

```css
/* What it does: Tells the email client that both light and dark styles are provided. A duplicate of meta color-scheme meta tag above. */ :root { color-scheme: light dark; supported-color-schemes: light dark; } /* What it does: Remove spaces around the email design added by some email clients. */ /* Beware: It can remove the padding / margin and add a background color to the compose a reply window. */ html, body { margin: 0 auto !important; padding: 0 !important; height: 100% !important; width: 100% !important; } /* What it does: Stops email clients resizing small text. */ * { -ms-text-size-adjust: 100%; -webkit-text-size-adjust: 100%; } /* What it does: Centers email on Android 4.4 */ div[style*="margin: 16px 0"] { margin: 0 !important; } /* What it does: forces Samsung Android mail clients to use the entire viewport */ #MessageViewBody, #MessageWebViewDiv{ width: 100% !important; } /* What it does: Stops Outlook from adding extra spacing to tables. */ table, td { mso-table-lspace: 0pt !important; mso-table-rspace: 0pt !important; } /* What it does: Replaces default bold style. */ th { font-weight: normal; } /* What it does: Fixes webkit padding issue. */ table { border-spacing: 0 !important; border-collapse: collapse !important; table-layout: fixed !important; margin: 0 auto !important; } /* What it does: Prevents Windows 10 Mail from underlining links despite inline CSS. Styles for underlined links should be inline. */ a { text-decoration: none; } /* What it does: Uses a better rendering method when resizing images in IE. */ img { -ms-interpolation-mode:bicubic; }
```

--------------------------------

### HtmlMin::minify

Source: https://github.com/akankov/html-min/blob/main/README.md

Minifies the provided HTML string based on the configured settings.

```APIDOC
## Method: minify

### Description
Processes the input HTML string and returns the minified version based on the current configuration settings.

### Signature
`public function minify(string $html): string`

### Parameters
- **html** (string) - Required - The raw HTML content to be minified.

### Returns
- (string) - The minified HTML output.
```

--------------------------------

### Inline CSS and JSON-LD Schema

Source: https://github.com/akankov/html-min/blob/main/tests/fixtures/inline_minify_full_page.html

CSS styles for preventing FOUC and basic layout, alongside a JSON-LD WebSite schema object.

```css
/* prevent FOUC */ html { visibility: hidden; } body , main { font-family: system-ui, sans-serif; margin: 0 16px; }
```

```json
{ "@context": "https://schema.org", "@type": "WebSite", "name": "Demo" }
```

--------------------------------

### CSS paragraph styling

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/blog-post.html

CSS rules to remove default margins, apply first-line indentation, and implement pilcrow separation using pseudo-elements.

```css
p {
  margin: 0;
  text-indent: 3ch;
}

p.pilcrow {
  text-indent: 0;
  display: inline;
}
p.pilcrow + p.pilcrow::before {
  content: " ¶ ";
}
```

--------------------------------

### CSS Margin for Spacing

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/real-world/blog-post.html

Use the margin-bottom property to add space between paragraphs instead of empty <p> tags.

```css
p {
  margin-bottom: 2em; /* increase white space after a paragraph */
}
```

--------------------------------

### JavaScript variable declaration

Source: https://github.com/akankov/html-min/blob/main/benchmarks/fixtures/small/base1.html

A simple script tag defining a variable.

```javascript
<script> var Hello = 'world';</script>
```
Tokens:
Raw