Класс 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 )
Проходит по коллекции и находит самое длинное имя.
Параметры
- массив
$collection - Коллекция для поиска максимальной длины.
Возвращает
целое числоtext()source public
text( integer $width 72 )
Получает справку в формате, подходящем для вывода в командной строке.
Параметры
- целое число
$widthнеобязательно 72 - Ширина вывода справки.
Возвращает
строкаxml()source public
xml( boolean $string true )
Получает справку в виде XML строки.
Параметры
- булево
$stringнеобязательно true - Возвращать объект SimpleXml или строку. По умолчанию true.
Возвращает
строка|SimpleXmlElementСм. $string
Подробное описание свойств
$_maxArgssource
protected целое число
Максимальное количество аргументов, отображаемых при генерации справки по использованию.
6
$_maxOptionssource
protected целое число
Максимальное количество опций, отображаемых при генерации справки по использованию.
6
© 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/3.3/class-Cake.Console.HelpFormatter.html