phpnomad/gettext-integration

PHPNomad gettext translation strategy implementation

Maintainers

Package info

github.com/phpnomad/gettext-integration

pkg:composer/phpnomad/gettext-integration

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.0.0 2026-03-31 11:31 UTC

Requires

Requires (Dev)

MIT 9162ae0a22a423ab165909f9206e8d5cf30ea72e

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

This package is auto-updated.

Last update: 2026-04-10 02:11:42 UTC

README

Latest Version Total Downloads PHP Version License

Integrates PHP's built-in gettext extension with phpnomad/translate. This package provides a TranslationStrategy implementation that delegates to dgettext and dngettext, applies the locale through setlocale(LC_MESSAGES, ...), and handles gettext's msgctxt context convention. If you'd rather not depend on the ext-gettext PHP extension, phpnomad/symfony-translation-integration implements the same abstraction against Symfony Translation instead.

Installation

This package requires the ext-gettext PHP extension to be installed and enabled.

composer require phpnomad/gettext-integration

What This Provides

  • PHPNomad\Gettext\Strategies\TranslationStrategy, which implements PHPNomad\Translations\Interfaces\TranslationStrategy using dgettext and dngettext.
  • Locale application from an injected HasLanguage provider, applied with setlocale(LC_MESSAGES, ...) on every call.
  • Context disambiguation via the gettext msgctxt convention (EOT separator \x04), with fallback to the untranslated source (or the appropriate singular/plural form) when no translation is registered for that context.

Requirements

  • PHP 8.0+
  • ext-gettext PHP extension
  • phpnomad/translate ^2.0
  • A HasTextDomain provider and a HasLanguage provider bound in your container (both interfaces ship with phpnomad/translate)

Usage

Bind the TranslationStrategy interface from phpnomad/translate to the gettext implementation inside your bootstrapper. The strategy is then resolved wherever the interface is injected.

<?php

use PHPNomad\Gettext\Strategies\TranslationStrategy as GettextTranslationStrategy;
use PHPNomad\Translations\Interfaces\TranslationStrategy;

$container->bind(TranslationStrategy::class, GettextTranslationStrategy::class);

Catalog files, domain binding, and locale setup are handled by the gettext extension itself. See the PHP manual for bindtextdomain, .mo file layout, and platform-specific notes on locale availability.

Documentation

The PHPNomad bootstrapping guide lives at phpnomad.com. For gettext catalog setup, see the PHP manual entry for gettext.

License

MIT. See LICENSE.