---
title: "Translations"
description: "Translations"
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-10-20"
last_update: "2026-10-20"
time_minutes: 2
draft: false
unlisted: false
url: "https://www.derafu.dev/docs/data/container/translations"
---

# Translations

The exceptions of `derafu/container` can be translated. This page explains what
is translatable, what ships out of the box and how to activate it in your
application.

## What's Translatable

Every exception the package throws is translatable (see
[`derafu/translation`](https://www.derafu.dev/docs/core/translation)):

- `MissingValueException` and `UnexpectedTypeException`, from the
  [typed getters](typed-getters).
- The errors of a `Store` (data that does not comply with the JSON schema, data
  or schema that can not be converted to JSON).
- The errors of the schema of a `Vault`.
- A value that can not be used as the key of a container.

The errors of the data of a `Vault` are the exceptions of
`symfony/options-resolver`, which are not translatable.

Messages are written in ICU MessageFormat, with the English text as the
translation id and named placeholders:

```php
use Derafu\Container\Bag;

try {
    (new Bag(['port' => 'abc']))->requireInt('port');
} catch (\Throwable $e) {
    echo $e->getMessage();
    // "The value of port must be of type int; string given."
}
```

Without a translator configured, `getMessage()` already returns the formatted
English text, so the package works as before whether or not you set up
translation.

## What Ships

- `resources/translations/errors+intl-icu.es.php`: a Spanish translation for
  every message of the package.
- `Derafu\Container\Translation\ContainerTranslationResourceProvider`: a
  `TranslationResourceProviderInterface` pointing at that directory.
- `resources/config/container-services.yaml`: a recipe for applications that use
  `symfony/dependency-injection`.

None of them does anything by itself: `derafu/container` is a library, it does
not build a `Translator`.

## Activating It (Plain PHP)

```php
use Derafu\Container\Translation\ContainerTranslationResourceProvider;
use Derafu\Translation\TranslatorFactory;

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

echo $exception->trans($translator);
// "El valor de port debe ser de tipo int; se recibió string."
```

## Activating It (Dependency Injection)

```yaml
imports:
    - { resource: '../vendor/derafu/translation/resources/config/translation-services.yaml' }
    - { resource: '../vendor/derafu/container/resources/config/container-services.yaml' }

services:
    Symfony\Component\Translation\Translator:
        factory: ['Derafu\Translation\TranslatorFactory', 'create']
        arguments:
            $defaultLocale: 'es'
            $fallbackLocales: ['es', 'en']
            $resourceProviders: !tagged_iterator derafu_translation.resource_provider
```

`container-services.yaml` tags `ContainerTranslationResourceProvider` with
`derafu_translation.resource_provider`, so it is picked up automatically.



---
Last updated on 20/10/2026