Класс ConsoleOutput
Обёртка для вывода информации из приложения оболочки. Может быть подключена к любому ресурсу потока, который может быть использован с fopen()
Может генерировать цветной вывод на консолях, которые его поддерживают. Существует несколько встроенных стилей
-
errorСообщения об ошибках. -
warningСообщения об ошибках. -
infoИнформационные сообщения. -
commentДополнительный текст. -
questionФиолетовый текст, используемый для запросов пользователя
Определяя стили с помощью addStyle(), вы можете создавать пользовательские стили консоли.
Использование стилей в выводе
Вы можете форматировать вывод консоли, используя теги с именем стиля, который нужно применить. Изнутри объекта оболочки
$this->out('<warning>Overwrite:</warning> foo.php was overwritten.'); Это создаст оранжевый текст 'Overwrite:', а остальной текст сохранит свой нормальный цвет. Подробнее о определении собственных стилей см. ConsoleOutput::styles(). Вложенные стили в настоящее время не поддерживаются.
Прямые подклассы
Резюме констант
-
integer2 -
stringPHP_EOL -
integer1 -
integer0
Резюме свойств
- цвета фона, используемые в цветном выводе.
array - цвета текста, используемые в цветном выводе.
array - варианты форматирования для цветного вывода
string -
$_outputprotectedДескриптор файла для вывода.resource -
$_outputAsprotectedТекущий тип вывода. Изменяется с помощью ConsoleOutput::outputAs();integer -
arrayСтили, доступные в виде тегов в выводе консоли. Вы можете изменить эти стили с помощью ConsoleOutput::styles()
Резюме методов
- __construct() publicКонструирует объект вывода.
- __destruct() publicОчистка и закрытие дескрипторов
- _replaceTags() protectedЗамена тегов кодами цвета.
- _write() protectedЗапись сообщения в поток вывода.
- outputAs() publicПолучение/установка типа вывода для использования. Тип вывода, как теги форматирования обрабатываются.
- styleText() publicПрименение стилей к тексту.
- styles() publicПолучить текущие доступные стили или добавить новые.
- write() public
Выводит одно или несколько сообщений в стандартный вывод. Если параметры не переданы, выводит только символ новой строки.
Подробное описание метода
__construct()source public
__construct( string $stream 'php://stdout' )
Конструирует объект вывода.
Проверяет среду красивой консоли. Ansicon и ConEmu позволяют создавать красивые консоли в Windows и поддерживаются.
Параметры
- строка
$streamнеобязательно 'php://stdout' - Идентификатор потока для записи вывода.
_replaceTags()source protected
_replaceTags( array $matches )
Замена тегов кодами цвета.
Параметры
- массив
$matches - Массив совпадений для замены.
Возвращает
строка_write()source protected
_write( string $message )
Запись сообщения в поток вывода.
Параметры
- строка
$message - Сообщение для записи.
Возвращает
логическое значениеуспех
outputAs()source public
outputAs( integer|null $type null )
Получение/установка типа вывода для использования. Тип вывода, как теги форматирования обрабатываются.
Параметры
- целое число|null
$typeнеобязательно null - Тип вывода для использования. Должен быть одной из констант класса.
Возвращает
целое число|nullЛибо null, либо значение, если извлекается.
styleText()source public
styleText( string $text )
Применение стилей к тексту.
Параметры
- строка
$text - Текст со стилизованными тегами.
Возвращает
строкаСтрока с добавленными кодами цвета.
styles()source public
styles( string|null $style null , array|boolean|null $definition null )
Получить текущие доступные стили или добавить новые.
Получить определение стиля
$output->styles('error'); Получить все определения стилей
$output->styles();
Создать или изменить существующий стиль
$output->styles('annoy', ['text' => 'purple', 'background' => 'yellow', 'blink' => true]); Удалить стиль
$this->output->styles('annoy', false); Параметры
- строка|null
$styleнеобязательно null - Стиль для получения или создания.
- массив|логическое значение|null
$definitionнеобязательно null Массивовое определение стиля для изменения или создания стиля или false для удаления стиля.
Возвращает
смешанный типЕсли вы получаете стили, будет возвращён стиль или null. Если вы создаёте/изменяете стили, будет возвращено true.
write()source public
write( string|array $message , integer $newlines 1 )
Выводит одно или несколько сообщений в стандартный вывод. Если параметры не переданы, выводит только символ новой строки.
Параметры
- строка|массив
$message - Строка или массив строк для вывода
- целое число
$newlinesнеобязательно 1 - Количество символов новой строки для добавления
Возвращает
целое числоВозвращает количество байтов, возвращённых при записи в стандартный вывод.
Подробное описание свойств
$_backgroundColorssource
protected static массив
цвета фона, используемые в цветном выводе.
[
'black' => 40,
'red' => 41,
'green' => 42,
'yellow' => 43,
'blue' => 44,
'magenta' => 45,
'cyan' => 46,
'white' => 47
] $_foregroundColorssource
protected static array
Цвета текста, используемые в цветном выводе.
[
'black' => 30,
'red' => 91,
'green' => 32,
'yellow' => 33,
'blue' => 34,
'magenta' => 35,
'cyan' => 36,
'white' => 37
] $_optionssource
protected static string
Параметры форматирования для цветного вывода.
[
'bold' => 1,
'underline' => 4,
'blink' => 5,
'reverse' => 7,
] $_outputAssource
protected integer
Текущий тип вывода. Изменяется с помощью ConsoleOutput::outputAs();
self::COLOR
$_stylessource
protected static array
Стили, доступные как теги в консольном выводе. Вы можете изменить эти стили с помощью ConsoleOutput::styles()
[
'emergency' => ['text' => 'red'],
'alert' => ['text' => 'red'],
'critical' => ['text' => 'red'],
'error' => ['text' => 'red'],
'warning' => ['text' => 'yellow'],
'info' => ['text' => 'cyan'],
'debug' => ['text' => 'yellow'],
'success' => ['text' => 'green'],
'comment' => ['text' => 'blue'],
'question' => ['text' => 'magenta'],
'notice' => ['text' => 'cyan']
]
© 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.ConsoleOutput.html