El siguiente paso es usar el adaptador dentro de su código.

print "Example\n";
print "=======\n";
print "Here is line one\n";
print "Today is the " . date("d.m.Y") . "\n";
print "\n";
print "Here is line two\n";

El ejemplo anterior muestra cierta salida sin soporte para traducción. Probablemente usted escribe su código en su idioma nativo. Generalmente necesita traducir no solo la salida, sino también los mensajes de error y de registro (log).

El siguiente paso es integrar Zend_Translate en su código existente. Por supuesto, es mucho más fácil si ya hubiera escrito su código pensando en la traducción, que modificar su código después.

$translate = new Zend_Translate(
    array(
        'adapter' => 'gettext',
        'content' => '/my/path/source-de.mo',
        'locale'  => 'de'
    )
);
$translate->addTranslation(
    array(
        'content' => '/path/to/translation/fr-source.mo',
        'locale'  => 'fr'
    )
);

print $translate->_("Example") . "\n";
print "=======\n";
print $translate->_("Here is line one") . "\n";
printf($translate->_("Today is the %1\$s") . "\n", date('d.m.Y'));
print "\n";

$translate->setLocale('fr');
print $translate->_("Here is line two") . "\n";

Ahora echemos un vistazo más profundo a lo que se ha hecho y cómo integrar Zend_Translate en su propio código.

Cree un nuevo objeto Zend_Translate y defina el adaptador base:

$translate = new Zend_Translate
    array(
        'adapter' => 'gettext',
        'content' => '/path/to/translation/source-de.mo',
        'locale'  => 'de'
    )
);

En este ejemplo elegimos el Adaptador Gettext. Colocamos nuestro archivo source-de.mo en el directorio /path/to/translation. El archivo gettext incluirá la traducción al alemán, y también añadimos otra fuente de idioma para el francés.

El siguiente paso es envolver todas las cadenas que se van a traducir. El enfoque más simple es tener solo cadenas o frases simples como esta:

print $translate->_("Example") . "\n";
print "=======\n";
print $translate->_("Here is line one") . "\n";

Algunas cadenas no necesitan ser traducidas. La línea separadora siempre es una línea separadora, incluso en otros idiomas.

Tener valores de datos integrados en una cadena de traducción también se admite mediante el uso de parámetros incrustados.

printf($translate->_("Today is the %1\$s") . "\n", date("d.m.Y"));

En lugar de print(), use la función printf() y reemplace todos los parámetros con partes %1\$s. El primero es %1\$s, el segundo es %2\$s, y así sucesivamente. De esta forma una traducción puede hacerse sin conocer el valor exacto. En nuestro ejemplo, la fecha es siempre el día actual, pero la cadena puede traducirse sin el conocimiento del día actual.

Cada cadena se identifica en el almacén de traducción mediante un ID de mensaje. Puede usar IDs de mensaje en lugar de cadenas en su código, así:

print $translate->_(1) . "\n";
print "=======\n";
print $translate->_(2) . "\n";

Pero hacer esto tiene varias desventajas:

No puede ver qué debería mostrar su código simplemente viendo su código.

Además tendrá problemas si algunas cadenas no están traducidas. Siempre debe tener presente cómo funciona la traducción. Primero Zend_Translate comprueba si el idioma especificado tiene una traducción para el ID de mensaje o cadena dado. Si no se encuentra ninguna cadena de traducción, recurre al siguiente nivel inferior de idioma según lo definido dentro de Zend_Locale. Así "de_AT" se convierte en solo "de". Si tampoco se encuentra ninguna traducción para "de", entonces se devuelve el mensaje original. De esta forma siempre tiene una salida, incluso en caso de que la traducción del mensaje no exista en su almacén de mensajes. Zend_Translate nunca lanza un error o excepción al traducir cadenas.