Класс HelpFormatter
HelpFormatter форматирует справку для консольных оболочек. Может форматировать в текстовом или XML формате. Использует методы ConsoleOptionParser для генерации справки.
Обычно не используется напрямую. Обычно вы обращаетесь к справке, используя $parser->help($command, 'xml');. Или через параметр --help=xml в командной строке.
Вывод в формате XML полезен для интеграции с другими инструментами, такими как IDE или другие инструменты сборки.
Краткое описание свойств
-
$_maxArgsprotectedМаксимальное количество аргументов, отображаемых при генерации использования.integer -
$_maxOptionsprotectedМаксимальное количество опций, отображаемых при генерации использования.integer - Парсер опций.
$_parserprotected
Краткое описание методов
- __construct() publicСоздать форматировщик справки для OptionParser
- _generateUsage() protected
Сгенерировать справку для оболочки на основе её аргументов и опций. Строки справки используют короткие опции вместо длинных. Необязательные аргументы будут указаны в квадратных скобках.
- _getMaxLength() protectedПройтись по коллекции и найти самое длинное наименование.
- text() publicПолучить справку в формате текста, подходящем для вывода в командной строке.
- xml() publicПолучить справку в формате XML.
Подробное описание методов
__construct()source public
__construct( Cake\Console\ConsoleOptionParser $parser )
Создать форматировщик справки для OptionParser
Параметры
-
Cake\Console\ConsoleOptionParser$parser - Парсер опций, для которого генерируется справка.
_generateUsage()source protected
_generateUsage( )
Сгенерировать справку для оболочки на основе её аргументов и опций. Строки справки используют короткие опции вместо длинных. Необязательные аргументы будут указаны в квадратных скобках.
Возвращаемое значение
string_getMaxLength()source protected
_getMaxLength( array $collection )
Пройтись по коллекции и найти самое длинное наименование.
Параметры
- array
$collection - Коллекция, для которой нужно найти максимальную длину.
Возвращаемое значение
integertext()source public
text( integer $width 72 )
Получить справку в формате текста, подходящем для вывода в командной строке.
Параметры
- integer
$widthoptional 72 - Ширина вывода справки.
Возвращаемое значение
stringxml()source public
xml( boolean $string true )
Получить справку в формате XML.
Параметры
- boolean
$stringoptional true - Возвратить объект SimpleXml или строку. По умолчанию — true.
Возвращаемое значение
string|SimpleXmlElementСм. $string
Подробное описание свойств
$_maxArgssource
protected integer
Максимальное количество аргументов, отображаемых при генерации использования.
6
$_maxOptionssource
protected integer
Максимальное количество опций, отображаемых при генерации использования.
6
© 2005–2016 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.
http://api.cakephp.org/3.2/class-Cake.Console.HelpFormatter.html