Класс ExtractTask
Экстрактор строк языка
- AppShell
-
ExtractTask
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Console/Command/Task/ExtractTask.php
Краткое описание свойств
-
$_excludeprotectedМассив директорий для исключения.array -
$_extractCoreprotectedУказывает, следует ли извлекать сообщения CakePHP Lib.boolean -
$_extractValidationprotectedУказывает, следует ли извлекать сообщения валидации моделей.boolean -
$_fileprotectedОбрабатываемый в данный момент файл.string -
$_filesprotectedФайлы, из которых необходимо извлечь данные.array -
$_mergeprotectedОбъединить все строки доменов и категорий в файл default.pot.boolean -
$_outputprotectedПуть назначения.string -
$_pathsprotectedПути для поиска строк.string -
$_storageprotectedСодержит все данные, ожидающие записи.string -
$_tokensprotectedИзвлечённые токены.array -
$_translationsprotectedИзвлечённые строки, индексированные по категории, домену, msgid и контексту.array -
$_validationDomainprotectedДомен строк валидации для использования при извлечении сообщений валидации.boolean
Краткое описание методов
- _addTranslation() protectedДобавляет перевод в свойство внутренних переводов.
- _buildFiles() protectedСоздаёт содержимое шаблона файла перевода из полученных строк.
- _extract() protectedИзвлекает текст.
- _extractPluginValidationMessages() protectedИзвлекает сообщения валидации из моделей приложения или плагинов.
- _extractTokens() protectedИзвлекает токены из всех обрабатываемых файлов.
- _extractValidationMessages() protected
Ищет модели в приложении и извлекает сообщения валидации, которые нужно добавить в карту переводов
- _formatString() protectedФорматирует строку для добавления в качестве переводимой строки.
- _getPaths() protectedМетод взаимодействия с пользователем для получения выбора путей.
- _getStrings() protectedПолучение строк с указанной позиции.
- _isExtractingApp() protected
Возвращает, предназначена ли эта операция для извлечения строк только из директорий в папке, представленной константой APP, т.е. этот задача извлекает строки из того же приложения.
- _isPathUsable() protectedПроверяет, можно ли использовать заданный путь для записи.
- _markerError() protectedУказывает на недопустимый маркер в обработанном файле.
- _parse() protectedОбрабатывает токены.
- _processValidationRules() protected
Обрабатывает правило валидации для поля и ищет сообщение, которое нужно добавить в карту переводов.
- _searchFiles() protectedПоиск файлов, которые могут содержать переводимые строки.
- _store() protectedПодготовка файла для сохранения.
- _writeFiles() protectedЗапись файлов, которые нужно сохранить.
- _writeHeader() protectedСоздание заголовка шаблона перевода.
- execute() publicМетод выполнения, всегда используемый для задач.
- getOptionParser() publicПолучение экземпляра анализатора опций и его настройка.
Подробное описание методов
_addTranslation()source protected
_addTranslation( string $category , string $domain , string $msgid , array $details array() )
Добавляет перевод в внутреннее свойство переводов.
Обрабатывает дублирующие переводы.
Параметры
- строка
$category - Категория
- строка
$domain - Домен
- строка
$msgid - Строка сообщения
- массив
$detailsнеобязательно array() - Ссылоки на файл и строку
_buildFiles()source protected
_buildFiles( )
Создаёт содержимое шаблона файла перевода из полученных строк.
_extractPluginValidationMessages()source protected
_extractPluginValidationMessages( string $plugin null )
Извлекает сообщения валидации из моделей приложения или плагинов.
Параметры
- строка
$pluginнеобязательно null - Имя плагина или
nullдля обработки моделей приложения
_extractValidationMessages()source protected
_extractValidationMessages( )
Ищет модели в приложении и извлекает сообщения валидации, которые нужно добавить в карту переводов.
_formatString()source protected
_formatString( string $string )
Форматирует строку для добавления в качестве переводимой строки.
Параметры
- строка
$string - Строка для форматирования
Возвращает
строкаОтформатированная строка
_getPaths()source protected
_getPaths( )
Метод взаимодействия с пользователем для получения выбора путей.
_getStrings()source protected
_getStrings( integer $position , integer $target )
Получить строки с указанной позиции.
Параметры
- целое число
$position - $position Текущая позиция в массиве токенов
- целое число
$target - Количество строк для извлечения
Возвращает
массивИзвлеченные строки
_isExtractingApp()source protected
_isExtractingApp( )
Возвращает, предназначено ли текущее выполнение для извлечения строк только из каталогов в папке, представленной константой APP, т.е. эта задача извлекает строки из того же приложения.
Возвращает
boolean_isPathUsable()source protected
_isPathUsable( string $path )
Проверяет, доступен ли заданный путь для записи.
Параметры
- строка
$path - Путь к папке
Возвращает
booleantrue, если путь существует и доступен для записи, иначе false
_markerError()source protected
_markerError( string $file , integer $line , string $marker , integer $count )
Указывает на неверный маркер в обработанном файле.
Параметры
- строка
$file - Файл, в котором находится неверный маркер
- целое число
$line - Номер строки
- строка
$marker - Найденный маркер
- целое число
$count - Счетчик
_parse()source protected
_parse( string $functionName , array $map )
Обработка токенов.
Параметры
- строка
$functionName - Имя функции, указывающее на переводимую строку (например: '__')
- массив
$map - Массив, содержащий переменные, которые будут найдены (например: категория, домен, единственное число, множественное число)
_processValidationRules()source protected
_processValidationRules( string $field , array $rules , string $file , string $domain , string $category 'LC_MESSAGES' )
Обрабатывает правило валидации для поля и ищет сообщение, которое нужно добавить в карту переводов.
Параметры
- строка
$field - имя поля, которое обрабатывается
- массив
$rules - набор правил валидации для поля
- строка
$file - имя файла, в котором было найдено это правило валидации
- строка
$domain - домен по умолчанию для привязки валидации
- строка
$categoryнеобязательно 'LC_MESSAGES' - категория перевода
_searchFiles()source protected
_searchFiles( )
Поиск файлов, которые могут содержать переводимые строки.
_store()source protected
_store( string $category , string $domain , string $header , string $sentence )
Подготовка файла для хранения.
Параметры
- строка
$category - Категория
- строка
$domain - Домен
- строка
$header - Контент заголовка.
- строка
$sentence - Предложение для хранения.
_writeHeader()source protected
_writeHeader( )
Создание заголовка шаблона перевода.
Возвращает
строкаЗаголовок шаблона перевода
getOptionParser()source public
getOptionParser( )
Получает экземпляр парсера опций и настраивает его.
Возвращает
ConsoleOptionParserПодробное описание свойств
$_extractCoresource
protected boolean
Содержит информацию о том, следует ли извлекать сообщения CakePHP Lib.
false
$_extractValidationsource
protected boolean
Содержит информацию о том, следует ли извлекать сообщения валидации модели.
true
$_translationssource
protected массив
Извлеченные строки, индексированные по категории, домену, msgid и контексту.
array()
$_validationDomainsource
protected boolean
Содержит домен строк валидации, используемый для сообщений о валидации при извлечении.
'default'
© 2005–2017 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/2.10/class-ExtractTask.html