Skip to content

CHANGELOG.md

Latest commit

 

History

History
44 lines (34 loc) · 1.89 KB

CHANGELOG.md

File metadata and controls

44 lines (34 loc) · 1.89 KB
Raw

Change Log

1.0.0 [2026.06.11]

First stable release. The public API of the previous 0.2 line — _r() / _e() and the fluent setters — is preserved, so existing code keeps working.

Requirements

  • Requires PHP 8.1+ (was 7.4+).

Fixed

  • Default-language fallback now works for nested (dot-delimited) keys. Nested lookups were always resolved against the active language, so a key present only in the default language was never found and the key was returned verbatim. Affected both the file and directory layouts.
  • Requesting a key that resolves to a nested array no longer throws a TypeError. Such a namespace node is treated as a miss and falls through the resolution chain.
  • Inline fallbacks of '0' and '' are honoured. The provided-fallback check used empty(), which discarded these values; it now checks for null.

Added

  • translate() and render() as the primary, descriptive methods (returning and echoing, respectively).
  • Clear TranslatorException messages for misconfiguration: directory not set, language file/directory missing, a directory that cannot be read, a file that does not return an array, and changing the file/directory mode after a language has been loaded.
  • English documentation under docs/, a rewritten README.md, a GitHub Actions CI workflow, PHPStan (level max) and PHP-CS-Fixer configuration, and a comprehensive test suite.

Changed

  • _r() and _e() are now thin, deprecated aliases of translate() and render(). They remain fully functional for backward compatibility.
  • Translator is now final and implements the documented TranslatorInterface. Depend on the interface rather than subclassing.
  • Calling useFile() / useDirectory() after a language has been loaded now throws a TranslatorException instead of silently leaving the translator in an inconsistent state.