Guía rápida · PHP

Objetivo: un sitio PHP sirviendo páginas traducidas, en menos de diez minutos.

La librería de PHP toma un enfoque distinto al de Dart y Node: en vez de darte las keywords para que las pintes tú, traduce la página e inyecta un selector de idioma.

Antes de empezar

• PHP 7.0 o superior
• Composer, recomendable pero no obligatorio
• Un proyecto de AZbox con su Project ID y su API key

1 · Crea el proyecto

En el panel: Create Project, con el idioma de origen y los de destino en los que quieras tener el sitio.

2 · Instala

composer require azbox/azbox-php

Sin Composer, copia azbox.php y el directorio lib a tu proyecto.

3 · Inicializa

Al principio de la ejecución — normalmente index.php o app.php, antes de imprimir nada:

require __DIR__ . '/vendor/autoload.php';

\Azbox\AZ::Instance(array(
  "api_key"                => "TU API KEY",
  "projectId"              => "TU PROJECT ID",
  "original_language"      => "es",
  "destination_languages"  => "en,fr,de",
  "buttonOptions" => array(
    "fullname"    => true,
    "is_dropdown" => true,
    "position"    => "bottom-right",
  ),
));

4 · Comprueba que funciona

Carga el sitio. Debería aparecer un selector de idioma en la esquina que hayas configurado. Al cambiar de idioma, la página se traduce.

5 · Sitios en un subdirectorio

Si el sitio no cuelga de la raíz del dominio, define home_url para que la librería construya bien sus enlaces. El directorio example/ del repositorio tiene un caso funcionando.

Las credenciales, fuera del repositorio

"api_key"   => getenv('AZBOX_API_KEY'),
"projectId" => getenv('AZBOX_PROJECT_ID'),

Si algo falla

• No aparece el selector — la inicialización se ejecuta después de haber empezado a imprimir. Tiene que ir antes de cualquier salida.
• Los enlaces se rompen en un subdirectorio — define home_url.

Siguiente

• Referencia de PHP / Laravel
• El paquete en Packagist