README

Berry is a zero-dependency, type-safe toolkit for building HTML structures using pure PHP.

Features

• Pure PHP eDSL: Define HTML structures using a fluent API, no new template syntax to learn just pure PHP
• Type Safety: Designed with PHPStan in mind, benefit from static analysis to catch bugs before they hit production
• Built-in inspector: Berry includes a visual debugging tool that renders a tree of your components and stack traces directly in the browser
• Extensible: Extend Berry with custom attributes using the integrated extension method functionality

Usage

Install via composer

$ composer req berry/html

<?php declare(strict_types=1); // renders a counter button and a debug representation of itself // clicking on the button will send a POST request to the current script function counterButton(int $value): Element { $nextValue = $value + 1; /** @var string $current */ $current = $_SERVER['PHP_SELF'] ?? '/'; return div() ->attr('hx-target', 'this') ->child( button() ->id('counter-button') ->attr('hx-post', "$current?counter=$nextValue") ->attr('hx-swap', 'outerHTML') ->text("+ $value") ) ->child(hr()) ->dump(true); } // our website layout to wrap around the content // includes picocss and htmx function layout(Element $content): Element { return html() ->child(head() ->child(title()->text('Hello, Berry!')) ->child(link() ->rel(Rel::Stylesheet) ->href('https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css'))) ->child(body() ->child(header()) ->child(div() ->class('container') ->child($content)) ->child(script()->src('https://cdnjs.cloudflare.com/ajax/libs/htmx/2.0.7/htmx.min.js'))); } // if we get a POST render only the counter button and stop if ($_SERVER['REQUEST_METHOD'] === 'POST') { $value = $_GET['counter'] ?? '1'; assert(is_string($value)); $value = intval($value); echo counterButton($value)->toString(); die(); } // and lastly render the normal page template echo layout( main() ->class('container') ->child(h1()->text('Hello, Berry!')) ->child(p()->text('This is an example page rendering HTML using Berry')) ->child(counterButton(1)) )->toString();

Ecosystem

Some other related packages:

• berry/symfony - Symfony integration
• berry/htmx - HTMX integration

License

MIT