Translations

Errors from ArrayReader and ArrayTable belong to Derafu\Array\Exception\ArrayException, which extends Derafu\Translation\Exception\Logic\TranslatableInvalidArgumentException. MissingValueException, TypeMismatchException and UnexpectedKeyException specialize array read failures. They can be caught as PHP’s InvalidArgumentException and translated through Derafu Translation.

use Derafu\Array\ArrayReader;

try {
    ArrayReader::fromArray(['port' => 'abc'], 'settings.php')->requireInt('port');
} catch (InvalidArgumentException $exception) {
    echo $exception->getMessage();
    // The key "port" of settings.php must be of type int, string given.
}

ArrayCaster delegates to ValueParser and propagates its ValueConversionException when Stringable conversion fails. Register Value’s provider when translating those exceptions; see Value Translations.

Messages and Context

Reader and type messages also have variants containing of {source}. Nested readers retain the source and append their keys to the diagnostic path. Expected type names come from ValueType; map refers to string-keyed arrays. ArrayReader wraps Value type mismatches while preserving their nested path, element type and original cause. Direct ValueType calls use the Value exception contract.

Resource Provider

The package ships Spanish translations in resources/translations/errors+intl-icu.es.php, with the provider Derafu\Array\Translation\ArrayTranslationResourceProvider.

use Derafu\Array\Translation\ArrayTranslationResourceProvider;
use Derafu\Translation\TranslatorFactory;

$translator = TranslatorFactory::create(
    defaultLocale: 'es',
    fallbackLocales: ['es', 'en'],
    resourceProviders: [new ArrayTranslationResourceProvider()],
);

A translatable exception can then be translated with $exception->trans($translator). The resource provider supplies translations; the library does not create a translator automatically.

Dependency Injection

Applications using Symfony DependencyInjection can import:

imports:
    - { resource: '../vendor/derafu/array/resources/config/array-services.yaml' }

The recipe tags ArrayTranslationResourceProvider with derafu_translation.resource_provider. Pass providers with that tag to TranslatorFactory::create() through its $resourceProviders argument, following the setup in Derafu Translation.