Spec-Zone.ru › CakePHP 3.2

Класс 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

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

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

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

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

Параметры

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

$_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–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

Spec-Zone.ru

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