Класс ConsoleOutput

Обёртка объекта для вывода информации из оболочки приложения. Может быть подключена к любому ресурсу потока, который может использоваться с fopen()

Может генерировать цветной вывод на консолях, которые его поддерживают. Есть несколько встроенных стилей

error Сообщения об ошибках.
warning Предупреждающие сообщения.
info Информационные сообщения.
comment Дополнительный текст.
question Фиолетовый текст, используемый для запросов к пользователю

Определяя стили с помощью addStyle(), вы можете создавать пользовательские стили консоли.

Использование стилей в выводе

Вы можете форматировать вывод консоли, используя теги с именем стиля, который нужно применить. Изнутри объекта оболочки

$this->out('<warning>Overwrite:</warning> foo.php was overwritten.');

Это создаст оранжевый текст 'Overwrite:', в то время как остальной текст останется в обычном цвете. См. ConsoleOutput::styles(), чтобы узнать больше о создании собственных стилей. Вложенные стили в настоящее время не поддерживаются.

Пакет: Cake\Console
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Console/ConsoleOutput.php

Краткое описание констант

integer

COLOR

2
string

LF

PHP_EOL
integer

PLAIN

1
integer

RAW

0

Краткое описание свойств

$_backgroundColors protected static

array
цвета фона, используемые в цветном выводе.
$_foregroundColors protected static

array
цвета текста, используемые в цветном выводе.
$_lastWritten protected

integer

Количество байтов, последний раз записанных в поток вывода, используемое при перезаписи предыдущего сообщения.
$_options protected static

string
параметры форматирования для цветного вывода
$_output protected

resource
Дескриптор файла для вывода.
$_outputAs protected

integer
Текущий тип вывода. Изменяется с помощью ConsoleOutput::outputAs();
$_styles protected static

array

Стили, доступные как теги в выводе консоли. Вы можете изменить эти стили с помощью ConsoleOutput::styles()

Краткое описание методов

__construct() public
Конструктор объекта вывода.
__destruct() public
Очистка и закрытие дескрипторов
_replaceTags() protected
Замена тегов на цветовые коды.
_write() protected
Запись сообщения в поток вывода.
outputAs() public
Получить/установить тип вывода для использования. Тип вывода, как теги форматирования обрабатываются.
overwrite() public
Перезапись некоторого уже выведенного текста.
styleText() public
Применение стилей к тексту.
styles() public
Получить текущие предлагаемые стили или добавить новые.
write() public

Выводит одно или несколько сообщений в stdout. Если параметры не переданы, выводит только символ новой строки.

Подробное описание методов

__construct()source public

__construct( string $stream 'php://stdout' )

Конструктор объекта вывода.

Проверяет наличие среды красивой консоли. Ansicon и ConEmu позволяют красивую консоль в Windows и поддерживаются.

Параметры

строка $stream необязательно 'php://stdout': Идентификатор потока, в который будет записан вывод.

__destruct()source public

__destruct( )

Очистка и закрытие дескрипторов

_replaceTags()source protected

_replaceTags( array $matches )

Замена тегов на цветовые коды.

Параметры

массив $matches: Массив совпадений для замены.

Возвращает

строка

_write()source protected

_write( string $message )

Запись сообщения в поток вывода.

Параметры

строка $message: Сообщения для записи.

Возвращает

логическое значение
успех

outputAs()source public

outputAs( integer $type null )

Получить/установить тип вывода для использования. Тип вывода, как теги форматирования обрабатываются.

Параметры

целое число $type необязательно null: Тип вывода для использования. Должен быть равен одной из констант класса.

Возвращает

смешанный тип
Либо null, либо значение, если происходит получение.

overwrite()source public

overwrite( array|string $message , integer $newlines 1 , integer|null $size null )

Перезапись некоторого уже выведенного текста.

Полезно для построения полосок выполнения или когда нужно заменить текст, уже выведенный на экран, новым текстом.

Предупреждение Вы не можете перезаписать текст, содержащий символы новой строки.

Параметры

массив или строка $message: Сообщения для вывода.
целое число $newlines необязательно 1: Количество символов новой строки для добавления.
целое число или null $size необязательно null: Количество байтов для перезаписи. По умолчанию равно длине последнего выведенного сообщения.

styleText()source public

styleText( string $text )

Применение стилей к тексту.

Параметры

строка $text: Текст со стилизующими тегами.

Возвращает

строка
Строка с добавленными цветовыми кодами.

styles()source public

styles( string $style null , array $definition null )

Получить текущие предлагаемые стили или добавить новые.

Получение определения стиля

$this->output->styles('error');

Получение всех определений стилей

$this->output->styles();

Создание или изменение существующего стиля

$this->output->styles('annoy', array('text' => 'purple', 'background' => 'yellow', 'blink' => true));

Удаление стиля

$this->output->styles('annoy', false);

Параметры

строка $style необязательно null: Стиль для получения или создания.
массив $definition необязательно null: Массив определения стиля для изменения или создания стиля или false для удаления стиля.

Возвращает

смешанный тип

Если вы получаете стили, будет возвращен стиль или null. Если вы создаёте/изменяете стили, будет возвращено true.

END_OF_DOCUMENT_MARKER

write()source public

write( string|array $message , integer $newlines 1 )

Выводит одно или несколько сообщений в стандартный вывод. Если параметры не переданы, выводится только символ новой строки.

Параметры

string|array $message: Строка или массив строк для вывода
integer $newlines необязательно 1: Количество добавляемых символов новой строки

Возвращает

integer
Возвращает количество байтов, возвращенных при записи в стандартный вывод.

Подробное описание свойств

$_backgroundColorssource

protected static array

Цвета фона, используемые в цветном выводе.

array(
    'black' => 40,
    'red' => 41,
    'green' => 42,
    'yellow' => 43,
    'blue' => 44,
    'magenta' => 45,
    'cyan' => 46,
    'white' => 47
)

$_foregroundColorssource

protected static array

Цвета текста, используемые в цветном выводе.

array(
    'black' => 30,
    'red' => 31,
    'green' => 32,
    'yellow' => 33,
    'blue' => 34,
    'magenta' => 35,
    'cyan' => 36,
    'white' => 37
)

$_lastWrittensource

protected integer

Количество байтов, последне записанных в поток вывода, используемое при перезаписи предыдущего сообщения.

$_optionssource

protected static string

Параметры форматирования для цветного вывода

array(
    'bold' => 1,
    'underline' => 4,
    'blink' => 5,
    'reverse' => 7,
)

$_outputsource

protected resource

Дескриптор файла для вывода.

$_outputAssource

protected integer

Текущий тип вывода. Изменяется с помощью ConsoleOutput::outputAs();

self::COLOR

$_stylessource

protected static array

Стили, доступные в виде тегов в выводе консоли. Вы можете изменить эти стили с помощью ConsoleOutput::styles()

array(
    'emergency' => array('text' => 'red', 'underline' => true),
    'alert' => array('text' => 'red', 'underline' => true),
    'critical' => array('text' => 'red', 'underline' => true),
    'error' => array('text' => 'red', 'underline' => true),
    'warning' => array('text' => 'yellow'),
    'info' => array('text' => 'cyan'),
    'debug' => array('text' => 'yellow'),
    'success' => array('text' => 'green'),
    'comment' => array('text' => 'blue'),
    'question' => array('text' => 'magenta'),
    'notice' => array('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.
https://api.cakephp.org/2.9/class-ConsoleOutput.html