SymfonyStyle

class SymfonyStyle extends OutputStyle

Output decorator helpers for the Symfony Style Guide.

Constants

MAX_LINE_LENGTH

Methods

__construct(InputInterface $input, OutputInterface $output)
newLine(int $count = 1)

Add newline(s).

ProgressBar createProgressBar(int $max)
write(string|array $messages, bool $newline = false, $type = self::OUTPUT_NORMAL)

Writes a message to the output.

writeln(string|array $messages, $type = self::OUTPUT_NORMAL)

Writes a message to the output and adds a newline at the end.

setVerbosity(int $level)

Sets the verbosity of the output.

from OutputStyle
int getVerbosity()

Gets the current verbosity of the output.

from OutputStyle
setDecorated(bool $decorated)

Sets the decorated flag.

from OutputStyle
bool isDecorated()

Gets the decorated flag.

from OutputStyle
setFormatter(OutputFormatterInterface $formatter) from OutputStyle
OutputFormatterInterface getFormatter()

Returns current output formatter instance.

from OutputStyle
bool isQuiet()

Returns whether verbosity is quiet (-q).

from OutputStyle
bool isVerbose()

Returns whether verbosity is verbose (-v).

from OutputStyle
bool isVeryVerbose()

Returns whether verbosity is very verbose (-vv).

from OutputStyle
bool isDebug()

Returns whether verbosity is debug (-vvv).

from OutputStyle
block(string|array $messages, string|null $type = null, string|null $style = null, string $prefix = ' ', bool $padding = false, bool $escape = true)

Formats a message as a block of text.

title(string $message)

Formats a command title.

section(string $message)

Formats a section title.

listing(array $elements)

Formats a list.

text(string|array $message)

Formats informational text.

comment(string|array $message)

Formats a command comment.

success(string|array $message)

Formats a success result bar.

error(string|array $message)

Formats an error result bar.

warning(string|array $message)

Formats an warning result bar.

note(string|array $message)

Formats a note admonition.

caution(string|array $message)

Formats a caution admonition.

table(array $headers, array $rows)

Formats a table.

string ask(string $question, string|null $default = null, callable|null $validator = null)

Asks a question.

string askHidden(string $question, callable|null $validator = null)

Asks a question with the user input hidden.

bool confirm(string $question, bool $default = true)

Asks for confirmation.

string choice(string $question, array $choices, string|int|null $default = null)

Asks a choice question.

progressStart(int $max)

Starts the progress output.

progressAdvance(int $step = 1)

Advances the progress output X steps.

progressFinish()

Finishes the progress output.

string askQuestion(Question $question)
SymfonyStyle getErrorStyle()

Returns a new instance which makes use of stderr if available.

Details

__construct(InputInterface $input, OutputInterface $output)

Parameters

InputInterface $input
OutputInterface $output

newLine(int $count = 1)

Add newline(s).

Parameters

int $count The number of newlines

ProgressBar createProgressBar(int $max)

Parameters

int $max

Return Value

ProgressBar

write(string|array $messages, bool $newline = false, $type = self::OUTPUT_NORMAL)

Writes a message to the output.

Parameters

string|array $messages The message as an array of lines or a single string
bool $newline Whether to add a newline
$type

writeln(string|array $messages, $type = self::OUTPUT_NORMAL)

Writes a message to the output and adds a newline at the end.

Parameters

string|array $messages The message as an array of lines of a single string
$type

setVerbosity(int $level)

Sets the verbosity of the output.

Parameters

int $level The level of verbosity (one of the VERBOSITY constants)

int getVerbosity()

Gets the current verbosity of the output.

Return Value

int The current level of verbosity (one of the VERBOSITY constants)

setDecorated(bool $decorated)

Sets the decorated flag.

Parameters

bool $decorated Whether to decorate the messages

bool isDecorated()

Gets the decorated flag.

Return Value

bool true if the output will decorate messages, false otherwise

setFormatter(OutputFormatterInterface $formatter)

Parameters

OutputFormatterInterface $formatter

OutputFormatterInterface getFormatter()

Returns current output formatter instance.

Return Value

OutputFormatterInterface

bool isQuiet()

Returns whether verbosity is quiet (-q).

Return Value

bool true if verbosity is set to VERBOSITY_QUIET, false otherwise

bool isVerbose()

Returns whether verbosity is verbose (-v).

Return Value

bool true if verbosity is set to VERBOSITY_VERBOSE, false otherwise

bool isVeryVerbose()

Returns whether verbosity is very verbose (-vv).

Return Value

bool true if verbosity is set to VERBOSITYVERYVERBOSE, false otherwise

bool isDebug()

Returns whether verbosity is debug (-vvv).

Return Value

bool true if verbosity is set to VERBOSITY_DEBUG, false otherwise

block(string|array $messages, string|null $type = null, string|null $style = null, string $prefix = ' ', bool $padding = false, bool $escape = true)

Formats a message as a block of text.

Parameters

string|array $messages The message to write in the block
string|null $type The block type (added in [] on first line)
string|null $style The style to apply to the whole block
string $prefix The prefix for the block
bool $padding Whether to add vertical padding
bool $escape Whether to escape the message

title(string $message)

Formats a command title.

Parameters

string $message

section(string $message)

Formats a section title.

Parameters

string $message

listing(array $elements)

Formats a list.

Parameters

array $elements

text(string|array $message)

Formats informational text.

Parameters

string|array $message

comment(string|array $message)

Formats a command comment.

Parameters

string|array $message

success(string|array $message)

Formats a success result bar.

Parameters

string|array $message

error(string|array $message)

Formats an error result bar.

Parameters

string|array $message

warning(string|array $message)

Formats an warning result bar.

Parameters

string|array $message

note(string|array $message)

Formats a note admonition.

Parameters

string|array $message

caution(string|array $message)

Formats a caution admonition.

Parameters

string|array $message

table(array $headers, array $rows)

Formats a table.

Parameters

array $headers
array $rows

string ask(string $question, string|null $default = null, callable|null $validator = null)

Asks a question.

Parameters

string $question
string|null $default
callable|null $validator

Return Value

string

string askHidden(string $question, callable|null $validator = null)

Asks a question with the user input hidden.

Parameters

string $question
callable|null $validator

Return Value

string

bool confirm(string $question, bool $default = true)

Asks for confirmation.

Parameters

string $question
bool $default

Return Value

bool

string choice(string $question, array $choices, string|int|null $default = null)

Asks a choice question.

Parameters

string $question
array $choices
string|int|null $default

Return Value

string

progressStart(int $max)

Starts the progress output.

Parameters

int $max Maximum steps (0 if unknown)

progressAdvance(int $step = 1)

Advances the progress output X steps.

Parameters

int $step Number of steps to advance

progressFinish()

Finishes the progress output.

string askQuestion(Question $question)

Parameters

Question $question

Return Value

string

SymfonyStyle getErrorStyle()

Returns a new instance which makes use of stderr if available.

Return Value

SymfonyStyle

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/4.0/Symfony/Component/Console/Style/SymfonyStyle.html