phpnomad/template

Maintainers

Package info

github.com/phpnomad/template

pkg:composer/phpnomad/template

Statistics

Installs: 2 225

Dependents: 3

Suggesters: 0

Stars: 0

Open Issues: 2

Security

Advisories: 0

Aikido package health analysis

1.0.0 2024-12-18 17:27 UTC

Requires (Dev)

MIT 675a8e4b075f97f822e681a559ee224a35e15f4a

  • Alex Standiford <alex.woop@standiford.us>

This package is auto-updated.

Last update: 2026-04-15 06:15:09 UTC

README

Latest Version Total Downloads PHP Version License

phpnomad/template is the template rendering abstraction for PHPNomad applications. It defines a small set of interfaces that describe how a template name becomes rendered output, without committing to any particular template engine. The primary contract is CanRender, which takes a template path and a data array and returns a string. Companion interfaces handle path and URL resolution, and a screen resolver interface covers admin routing for plugins that need it. A plain-PHP engine ships with the package, and phpnomad/twig-integration provides a Twig-backed implementation that slots into the same contract.

Installation

composer require phpnomad/template

Overview

  • CanRender defines the render contract: a template path plus a data array returns a rendered string, or throws TemplateException if something goes wrong.
  • CanResolvePaths and CanResolveUrls map a logical template name to a file path or a public URL, keeping callers free of filesystem assumptions.
  • ScreenResolverStrategy covers admin and page-slug routing, including current-screen detection and URL generation for slug and action pairs.
  • RenderService composes a path resolver with a CanRender implementation so application code passes a template name rather than an absolute file path.
  • PhpEngine is the bundled default renderer. It appends .php to the resolved path, extracts the data array into scope, and captures the include through output buffering.

Documentation

Full documentation lives at phpnomad.com, including how phpnomad/core exposes a Template facade for static access to the render service inside a running application.

License

Released under the MIT license. See LICENSE.txt.