novembit / i18n
独立的 i18n。
Requires
- php: >=7.1
- ext-curl: *
- ext-dom: *
- ext-json: *
- ext-libxml: *
- ext-mbstring: *
- ext-pdo: *
- ext-simplexml: *
- cache/cache: *
- doctrine/dbal: *
- google/cloud-translate: *
- masterminds/html5: ^2.7
- monolog/monolog: *
- psr/cache: *
- psr/log: *
Requires (Dev)
This package is auto-updated.
Last update: 2024-09-04 15:05:07 UTC
README
目录
- 数组
- DataMapper
- DB
- DB
- Dummy
- Exception
- HTML
- HTML
- HTMLFragment
- JSON
- LanguageException
- 方法
- MethodException
- 模块
- RequestException
- Rest
- Rest
- 字符串
- 文本
- 翻译
- TranslationException
- URL
- URL
- XML
- XML
数组
- 全名: \NovemBit\i18n\system\helpers\Arrays
arrayWalkWithRoute
递归数组遍历带有回调和路由
Arrays::arrayWalkWithRoute( array &$arr, callable $callback, \NovemBit\i18n\system\helpers\Strings $route = '', \NovemBit\i18n\system\helpers\Strings $separator = '>' ): void
- 此方法为 静态。 参数:
arrayMergeRecursiveDistinct
array_merge_recursive 确实合并数组,但它将具有重复键的值转换为数组,而不是用第二个数组中的重复值覆盖第一个数组中的值,就像 array_merge 一样。也就是说,使用 array_merge_recursive,会发生这种情况(记录的行为)
Arrays::arrayMergeRecursiveDistinct( array &$array1, array &$array2 ): array
array_merge_recursive(array('key' => 'org value'), array('key' => 'new value')); => array('key' => array('org value', 'new value'));
array_merge_recursive_distinct 不会更改数组中值的数据类型。第二个数组中匹配键的值覆盖第一个数组中的值,就像 array_merge 一样,即
array_merge_recursive_distinct(array('key' => 'org value'), array('key' => 'new value')); => array('key' => array('new value'));
参数通过引用传递,尽管只是为了性能原因。它们不会被此函数更改。
- 此方法为 静态。 参数:
DataMapper
ActiveRecord 类。Yii ActiveRecord 库的子类
- 全名: \NovemBit\i18n\models\DataMapper
另请参阅
getDB
DataMapper::getDB( ): \Doctrine\DBAL\Connection
- 此方法为 静态。
DB
DB 组件
它简单但提供了非常有用的功能模块类
- 全名: \NovemBit\i18n\system\component\DB
- 父类: \NovemBit\i18n\system\Component
另请参阅
__construct
组件构造函数。
DB::__construct( array $config = array(), null|\NovemBit\i18n\system\Component &$context = null )
参数
commonInit
{@inheritdoc} 组件的初始化方法。
DB::commonInit( ): void
设置 DB 的默认连接
isCli
检查脚本是否在 CLI 上运行
DB::isCli( ): boolean
getLogger
DB::getLogger( ): \Psr\Log\LoggerInterface
setLogger
DB::setLogger( \Psr\Log\LoggerInterface $logger )
参数
getRuntimeDir
DB::getRuntimeDir( ): string
setRuntimeDir
DB::setRuntimeDir( string $runtime_dir )
参数
setCachePool
DB::setCachePool( \Psr\SimpleCache\CacheInterface $cache_pool )
参数
getCachePool
DB::getCachePool( ): \Psr\SimpleCache\CacheInterface
defaultConfig
DB::defaultConfig( )
- 此方法为 静态。
getConnection
获取 DB 连接
DB::getConnection( ): \yii\db\Connection
setConnection
设置 DB 连接
DB::setConnection( \yii\db\Connection $_connection ): void
参数
DB
DB 组件
它简单但提供了非常有用的功能模块类
- 全名: \NovemBit\i18n\component\db\DB
- 父类: \NovemBit\i18n\system\Component
另请参阅
__construct
组件构造函数。
DB::__construct( array $config = array(), null|\NovemBit\i18n\system\Component &$context = null )
参数
commonInit
{@inheritdoc} 组件的初始化方法。
DB::commonInit( ): void
设置 DB 的默认连接
isCli
检查脚本是否在 CLI 上运行
DB::isCli( ): boolean
getLogger
DB::getLogger( ): \Psr\Log\LoggerInterface
setLogger
DB::setLogger( \Psr\Log\LoggerInterface $logger )
参数
getRuntimeDir
DB::getRuntimeDir( ): string
setRuntimeDir
DB::setRuntimeDir( string $runtime_dir )
参数
setCachePool
DB::setCachePool( \Psr\SimpleCache\CacheInterface $cache_pool )
参数
getCachePool
DB::getCachePool( ): \Psr\SimpleCache\CacheInterface
defaultConfig
DB::defaultConfig( )
- 此方法为 静态。
getConnection
获取 DB 连接
DB::getConnection( ): \Doctrine\DBAL\Connection
getConnectionParams
连接参数获取器
DB::getConnectionParams( ): array
Dummy
翻译的 Dummy 方法
- 全名: \NovemBit\i18n\component\translation\method\Dummy
- 父类: \NovemBit\i18n\component\translation\method\Method
另请参阅
Exception
系统异常类
- 全名: \NovemBit\i18n\system\exception\Exception
- 父类
- 此类实现: \NovemBit\i18n\system\exception\FriendlyExceptionInterface
另请参阅
翻译的 Google Translate 方法
- 全名: \NovemBit\i18n\component\translation\method\Google
- 父类: \NovemBit\i18n\component\translation\method\Method
另请参阅
mainInit
{@inheritdoc}
Google::mainInit( ): void
HTML
ActiveRecord 类。Yii ActiveRecord 库的子类
- 全名: \NovemBit\i18n\component\translation\type\models\HTML
- 父类: \NovemBit\i18n\component\translation\models\Translation
另请参阅
get
从数据库获取翻译的主要方法
HTML::get( array $texts, string $from_language, array $to_languages, boolean $reverse = false ): array
- 此方法为 静态。 参数:
saveTranslations
将翻译保存到数据库的主要方法
HTML::saveTranslations( string $from_language, array $translations, integer $level, boolean $overwrite = false, array &$result = array() ): void
- 此方法为 静态。 参数:
getDB
HTML::getDB( ): \Doctrine\DBAL\Connection
- 此方法为 静态。
HTML
翻译组件的HTML类型
- 全名:\NovemBit\i18n\component\translation\type\HTML
- 父类:\NovemBit\i18n\component\translation\type\XML
- 此类实现:\NovemBit\i18n\component\translation\type\interfaces\HTML
另请参阅
defaultConfig
{@inheritDoc}
HTML::defaultConfig( ): array
- 此方法为 静态。
getParserType
HTML::getParserType( ): integer
setParserType
HTML::setParserType( integer $parser_type )
参数
buildToTranslateFields
HTML::buildToTranslateFields( \DOMNode &$node, array $params, array &$data )
参数
replaceTranslatedFields
HTML::replaceTranslatedFields( \DOMNode &$node, array $params, array &$data )
参数
getHelperAttributes
{@inheritDoc}
HTML::getHelperAttributes( ): boolean
setHelperAttributes
{@inheritDoc}
HTML::setHelperAttributes( boolean $status ): void
参数
html translation including additional attributes |
addBeforeParseCallback
HTML::addBeforeParseCallback( callable $callback )
参数
addAfterParseCallback
HTML::addAfterParseCallback( callable $callback )
参数
getBeforeParseCallbacks
HTML::getBeforeParseCallbacks( ): array
getAfterParseCallbacks
HTML::getAfterParseCallbacks( ): array
HTMLFragment
翻译组件的HTML类型
- 全名:\NovemBit\i18n\component\translation\type\HTMLFragment
- 父类:\NovemBit\i18n\component\translation\type\HTML
- 此类实现:\NovemBit\i18n\component\translation\type\interfaces\HTMLFragment
另请参阅
defaultConfig
{@inheritDoc}
HTMLFragment::defaultConfig( ): array
- 此方法为 静态。
getParserType
HTMLFragment::getParserType( ): integer
setParserType
HTMLFragment::setParserType( integer $parser_type )
参数
buildToTranslateFields
HTMLFragment::buildToTranslateFields( \DOMNode &$node, array $params, array &$data )
参数
replaceTranslatedFields
HTMLFragment::replaceTranslatedFields( \DOMNode &$node, array $params, array &$data )
参数
getHelperAttributes
{@inheritDoc}
HTMLFragment::getHelperAttributes( ): boolean
setHelperAttributes
{@inheritDoc}
HTMLFragment::setHelperAttributes( boolean $status ): void
参数
html translation including additional attributes |
addBeforeParseCallback
HTMLFragment::addBeforeParseCallback( callable $callback )
参数
addAfterParseCallback
HTMLFragment::addAfterParseCallback( callable $callback )
参数
getBeforeParseCallbacks
HTMLFragment::getBeforeParseCallbacks( ): array
getAfterParseCallbacks
HTMLFragment::getAfterParseCallbacks( ): array
JSON
ActiveRecord 类。Yii ActiveRecord 库的子类
- 全名:\NovemBit\i18n\component\translation\type\models\JSON
- 父类: \NovemBit\i18n\component\translation\models\Translation
另请参阅
get
从数据库获取翻译的主要方法
JSON::get( array $texts, string $from_language, array $to_languages, boolean $reverse = false ): array
- 此方法为 静态。 参数:
saveTranslations
将翻译保存到数据库的主要方法
JSON::saveTranslations( string $from_language, array $translations, integer $level, boolean $overwrite = false, array &$result = array() ): void
- 此方法为 静态。 参数:
getDB
JSON::getDB( ): \Doctrine\DBAL\Connection
- 此方法为 静态。
LanguageException
语言组件异常文件
- 全名:\NovemBit\i18n\component\languages\exceptions\LanguageException
- 父类:\NovemBit\i18n\system\exception\Exception
另请参阅
方法
ActiveRecord 类。Yii ActiveRecord 库的子类
- 全名:\NovemBit\i18n\component\translation\method\models\Method
- 父类: \NovemBit\i18n\component\translation\models\Translation
另请参阅
get
从数据库获取翻译的主要方法
Method::get( array $texts, string $from_language, array $to_languages, boolean $reverse = false ): array
- 此方法为 静态。 参数:
saveTranslations
将翻译保存到数据库的主要方法
Method::saveTranslations( string $from_language, array $translations, integer $level, boolean $overwrite = false, array &$result = array() ): void
- 此方法为 静态。 参数:
getDB
Method::getDB( ): \Doctrine\DBAL\Connection
- 此方法为 静态。
MethodException
语言组件异常文件
- 全名:\NovemBit\i18n\component\translation\method\exceptions\MethodException
- 父类:\NovemBit\i18n\system\exception\Exception
另请参阅
模块
模块类:i18n库的主实例。应用于任何外部连接,提供组件系统。有一些必需的组件,DBAL(RDMS)配置,请求处理器,翻译抽象层等。
它简单但提供了非常有用的功能模块类
- 全名:\NovemBit\i18n\Module
- 父类: \NovemBit\i18n\system\Component
另请参阅
__construct
组件构造函数。
Module::__construct( array $config = array(), null|\NovemBit\i18n\system\Component &$context = null )
参数
commonLateInit
Module::commonLateInit( ): void
加载Yii框架容器以使用不允许独立使用的某些库
mainInit
组件初始化方法:非CLI模式运行在子组件初始化之后
Module::mainInit( ): void
isCli
检查脚本是否在 CLI 上运行
Module::isCli( ): boolean
getLogger
Module::getLogger( ): \Psr\Log\LoggerInterface
setLogger
Module::setLogger( \Psr\Log\LoggerInterface $logger )
参数
getRuntimeDir
Module::getRuntimeDir( ): string
setRuntimeDir
Module::setRuntimeDir( string $runtime_dir )
参数
setCachePool
Module::setCachePool( \Psr\SimpleCache\CacheInterface $cache_pool )
参数
getCachePool
Module::getCachePool( ): \Psr\SimpleCache\CacheInterface
defaultConfig
默认组件配置
Module::defaultConfig( ): array
- 此方法为 静态。
start
启动请求翻译
Module::start( ): void
实例
创建模块主实例
Module::instance( null|array $config = null ): self
- 此方法为 静态。 参数:
RequestException
请求异常类
- 全名:\NovemBit\i18n\component\request\exceptions\RequestException
- 父类:\NovemBit\i18n\system\exception\Exception
另请参阅
Rest
REST组件
它简单但提供了非常有用的功能模块类
- 全名:\NovemBit\i18n\component\rest\Rest
- 父类: \NovemBit\i18n\system\Component
- 此类实现:\NovemBit\i18n\component\rest\interfaces\Rest
另请参阅
__construct
组件构造函数。
Rest::__construct( array $config = array(), null|\NovemBit\i18n\system\Component &$context = null )
参数
isCli
检查脚本是否在 CLI 上运行
Rest::isCli( ): boolean
getLogger
Rest::getLogger( ): \Psr\Log\LoggerInterface
setLogger
Rest::setLogger( \Psr\Log\LoggerInterface $logger )
参数
getRuntimeDir
Rest::getRuntimeDir( ): string
setRuntimeDir
Rest::setRuntimeDir( string $runtime_dir )
参数
setCachePool
Rest::setCachePool( \Psr\SimpleCache\CacheInterface $cache_pool )
参数
getCachePool
Rest::getCachePool( ): \Psr\SimpleCache\CacheInterface
defaultConfig
Rest::defaultConfig( )
- 此方法为 静态。
start
启动REST请求
Rest::start( ): void
actionTranslate
翻译操作方法
Rest::actionTranslate( ): array|integer
actionIndex
索引操作方法
Rest::actionIndex( ): array
actionRestrict
限制操作方法
Rest::actionRestrict( ): array
Rest
翻译的REST方法
- 全名:\NovemBit\i18n\component\translation\method\Rest
- 父类: \NovemBit\i18n\component\translation\method\Method
另请参阅
getLanguagesConfig
从主模块实例 $config 获取语言配置
Rest::getLanguagesConfig( ): array
字符串
- 全名:\NovemBit\i18n\system\helpers\Strings
getStringsDifference
获取字符串差异
Strings::getStringsDifference( string $before, string $after, string|null &$prefix = null, string|null &$suffix = null ): void
- 此方法为 静态。 参数:
文本
ActiveRecord 类。Yii ActiveRecord 库的子类
- 全名:\NovemBit\i18n\component\translation\type\models\Text
- 父类: \NovemBit\i18n\component\translation\models\Translation
另请参阅
get
从数据库获取翻译的主要方法
Text::get( array $texts, string $from_language, array $to_languages, boolean $reverse = false ): array
- 此方法为 静态。 参数:
saveTranslations
将翻译保存到数据库的主要方法
Text::saveTranslations( string $from_language, array $translations, integer $level, boolean $overwrite = false, array &$result = array() ): void
- 此方法为 静态。 参数:
getDB
Text::getDB( ): \Doctrine\DBAL\Connection
- 此方法为 静态。
翻译
ActiveRecord 类。Yii ActiveRecord 库的子类
- 全名:\NovemBit\i18n\component\translation\models\Translation
- 父类:\NovemBit\i18n\models\DataMapper
- 此类实现:\NovemBit\i18n\component\translation\models\interfaces\Translation
另请参阅
getDB
Translation::getDB( ): \Doctrine\DBAL\Connection
- 此方法为 静态。
get
从数据库获取翻译的主要方法
Translation::get( array $texts, string $from_language, array $to_languages, boolean $reverse = false ): array
- 此方法为 静态。 参数:
saveTranslations
将翻译保存到数据库的主要方法
Translation::saveTranslations( string $from_language, array $translations, integer $level, boolean $overwrite = false, array &$result = array() ): void
- 此方法为 静态。 参数:
TranslationException
请求异常类
- 全名:\NovemBit\i18n\component\translation\exceptions\TranslationException
- 父类:\NovemBit\i18n\system\exception\Exception
另请参阅
URL
ActiveRecord 类。Yii ActiveRecord 库的子类
- 全名:\NovemBit\i18n\component\translation\type\models\URL
- 父类: \NovemBit\i18n\component\translation\models\Translation
另请参阅
get
从数据库获取翻译的主要方法
URL::get( array $texts, string $from_language, array $to_languages, boolean $reverse = false ): array
- 此方法为 静态。 参数:
saveTranslations
将翻译保存到数据库的主要方法
URL::saveTranslations( string $from_language, array $translations, integer $level, boolean $overwrite = false, array &$result = array() ): void
- 此方法为 静态。 参数:
getDB
URL::getDB( ): \Doctrine\DBAL\Connection
- 此方法为 静态。
规则
{@inheritdoc}
URL::rules( ): array
URL
一些与URL相关的操作的辅助类
- 全名:\NovemBit\i18n\system\helpers\URL
另请参阅
addQueryVars
向URL添加查询参数
URL::addQueryVars( string $url, string $name, string $value ): string
- 此方法为 静态。 参数:
removeQueryVars
从URL移除查询参数
URL::removeQueryVars( string $url, string $paramName ): string
- 此方法为 静态。 参数:
buildUrl
从部分构建URL:与反向parse_url相同
URL::buildUrl( array $parts ): string
- 此方法为 静态。 参数:
XML
翻译组件的HTML类型
- 全名:\NovemBit\i18n\component\translation\type\XML
- 父类:\NovemBit\i18n\component\translation\type\Type
另请参阅
defaultConfig
{@inheritDoc}
XML::defaultConfig( ): array
- 此方法为 静态。
getParserType
XML::getParserType( ): integer
setParserType
XML::setParserType( integer $parser_type )
参数
buildToTranslateFields
XML::buildToTranslateFields( \DOMNode &$node, array $params, array &$data )
参数
replaceTranslatedFields
XML::replaceTranslatedFields( \DOMNode &$node, array $params, array &$data )
参数
getHelperAttributes
{@inheritDoc}
XML::getHelperAttributes( ): boolean
setHelperAttributes
{@inheritDoc}
XML::setHelperAttributes( boolean $status ): void
参数
html translation including additional attributes |
addBeforeParseCallback
XML::addBeforeParseCallback( callable $callback )
参数
addAfterParseCallback
XML::addAfterParseCallback( callable $callback )
参数
getBeforeParseCallbacks
XML::getBeforeParseCallbacks( ): array
getAfterParseCallbacks
XML::getAfterParseCallbacks( ): array
XML
ActiveRecord 类。Yii ActiveRecord 库的子类
- 全名:\NovemBit\i18n\component\translation\type\models\XML
- 父类: \NovemBit\i18n\component\translation\models\Translation
另请参阅
get
从数据库获取翻译的主要方法
XML::get( array $texts, string $from_language, array $to_languages, boolean $reverse = false ): array
- 此方法为 静态。 参数:
saveTranslations
将翻译保存到数据库的主要方法
XML::saveTranslations( string $from_language, array $translations, integer $level, boolean $overwrite = false, array &$result = array() ): void
- 此方法为 静态。 参数:
getDB
XML::getDB( ): \Doctrine\DBAL\Connection
- 此方法为 静态。
此文档是根据2019-12-03源代码注释自动生成的,使用phpDocumentor和cvuorinen/phpdoc-markdown-public。