dhii / output-renderer-interface
An interface for objects that can perform rendering.
Installs: 44 439
Dependents: 16
Suggesters: 0
Security: 0
Stars: 0
Watchers: 4
Forks: 0
Open Issues: 2
Requires
- php: ^7.1 | ^8.0
Requires (Dev)
- phpunit/phpunit: ^6.0 | ^7.0 | ^8.0 | ^9.0
- psr/container: ^1.0
- slevomat/coding-standard: ^6.0
- symfony/polyfill-php80: ^1.19
- vimeo/psalm: ^3.11.7 | ^4
Suggests
- psr/container: To use PSR-11 containers as context
This package is auto-updated.
Last update: 2024-11-22 15:49:44 UTC
README
Interfaces for rendering interoperability.
Details
Like other members of the Dhii\Output
namespace, interfaces in this package
are related to producing output, handling related errors, and providing
convenience around output functionality. Particularly, interfaces in this
package are at the core of output generation, defining a standard API for
anything that can render output.
Therefore, output renderers MUST implement RendererInterface
. If
RendererInterface#render()
is unable to produce output,
a CouldNotRenderExceptionInterface
MUST be thrown.
Interfaces
RendererInterface
- Represents a renderer, i.e. something that can produce output.TemplateInterface
- A renderer that uses context to render.PathTemplateFactoryInterface
- A factory that creates templates from paths.StringTemplateFactoryInterface
- A factory that creates templates from strings.BlockInterface
- A renderer that has access to the render context, and is also stringable.CallbackBlockFactoryInterface
- A factory that creates blocks from callbacks.StringBlockFactoryInterface
- A factory that creates blocks from strings.TemplateBlockFactoryInterface
- A factory that creates blocks from templates.RendererAwareInterface
- Something that exposes a renderer.ContextAwareInterface
- Something that can have a rendering context retrieved.BlockAwareInterface
- Something that can have a block retrieved.TemplateAwareInterface
- Something that can have a template retrieved.RendererExceptionInterface
- An exception that occurs in relation to a renderer, and is aware of it.CouldNotRenderExceptionInterface
- A specialized renderer exception that signals problems during rendering.TemplateRenderExceptionInterface
- A specialized "could-not-render" exception that is aware of the rendering context.