README

描述

此库为 Skeleton 提供国际化翻译功能。

安装

通过 composer 安装

composer require tigron/skeleton-i18n

运行迁移来更新数据库模式

skeleton migrate:up

如何使用

配置软件包

/**
 * The path to store the po files
 *
 * \Skeleton\I18n\Config::$po_directory is deprecated
 */
\Skeleton\I18n\Config::$po_path = '/my_app/po';

/**
 * Define a temporary folder to cache all translations
 *
 * \Skeleton\I18n\Config::$cache_directory is deprecated
 */
\Skeleton\I18n\Config::$cache_path = '/my_app/tmp/languages';

/**
 * Optional:
 * skeleton-i18n keeps translations for templates per application.
 * For every skeleton application in your project a different po file is
 * created that contains all strings to be translated for the given
 * application.
 * If for some reason, you want to include more templates, this can
 * be done via the following configuration.
\Skeleton\I18n\Config::$additional_template_paths['pdf'] = '/my_app/pdf/templates';

/**
 * Optional:
 * Set another Language interface
 */
\Skeleton\I18n\Config::$language_interface = '\Language';

/**
 * Optional:
 * Enable auto fill po file when requesting translation
 * Default to false
 */
\Skeleton\I18n\Config::$auto_fill_po = true;

使用它

通过 skeleton-template-twig 渲染的 twig 模板

{% trans "To be translated" %}

直接通过 PHP

$language = Language::get_by_name_short('en');
$application_name = 'admin';
$translation = \Skeleton\I18n\Translation::get($language, $application_name);
\Skeleton\I18n\Translation::translate('To be translated', $translation);