Spec-Zone.ru › CakePHP 3.3

Класс ConsoleOutput

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

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

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

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

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

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

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

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

Непосредственные подклассы

  • Cake\TestSuite\Stub\ConsoleOutput
Пространство имен: Cake\Console
Расположение: Console/ConsoleOutput.php

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

  • integer

    COLOR
    2
  • string

    LF
    PHP_EOL
  • integer

    PLAIN
    1
  • integer

    RAW
    0

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

  • $_backgroundColors protected static
    array
    Цвета фона, используемые в цветном выводе.
  • $_foregroundColors protected static
    array
    Цвета текста, используемые в цветном выводе.
  • $_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
    Получить/установить тип вывода. Тип вывода, как теги форматирования обрабатываются.
  • styleText() public
    Применение стилей к тексту.
  • styles() public
    Получить текущие доступные стили или добавить новые.
  • write() public

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

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

__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|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 )

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

Параметры

строка|массив $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 массив

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

[
    '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,
]

$_outputsource

protected resource

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

$_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–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.ConsoleOutput.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API