mezzio/mezzio-template

Releases

1. ▸▾3.0.011 Oct 2025

   Version 3.0.0 of mezzio-template contains several changes that break backwards compatibility.

   Release Notes for 3.0.0

   Version 3.0.0 of mezzio-template contains several changes that break backwards compatibility.

   Mezzio\Template\TemplateRendererInterface

   The following methods have been removed:

   • addPath
   • getPaths

   As an interface whose primary purpose is to render a named template to a string, adding and listing template file paths is out of scope. The engine in use may not even deal with the filesystem, so these methods are no longer forced on implementors.

   General Changes

   • Native PHP types have been added to all properties, parameters and return types where previously there were none.
     This affects a number of method signatures and will therefore require code changes in classes that override or implement these methods.
   • Shipped exceptions have been marked as final
   • ExceptionInterface now inherits from Throwable
   • The documented types relating to template variables or parameters have been refined from array<string, mixed> to array<non-empty-string, mixed>. The more precise types will affect users of static analysis tooling, and as such a new method has been added ArrayParametersTrait::normalizeParamsAsMap() that should ease the burden of asserting the correct types for implementors

   3.0.0

   • Total issues resolved: 0
   • Total pull requests resolved: 6
   • Total contributors: 2

   Dependencies,Enhancement

   • 45: Merge release 2.13.0 into 3.0.x thanks to @github-actions[bot]

   QA

   • 43: Merge release 2.12.0 into 3.0.x thanks to @github-actions[bot]

   BC Break,QA

   • 41: Mark shipped exceptions as final thanks to @gsteel

   BC Break,Bug,QA

   • 40: ExceptionInterface should inherit from Throwable thanks to @gsteel

   BC Break,Enhancement,QA

   • 39: Refine types for view variables/parameters thanks to @gsteel

   BC Break,Feature Removal

   • 38: Remove addPath and getPaths from TemplateRendererInterface thanks to @gsteel