ConsoleOutput.php 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153
  1. <?php
  2. /*
  3. * This file is part of the Symfony package.
  4. *
  5. * (c) Fabien Potencier <fabien@symfony.com>
  6. *
  7. * For the full copyright and license information, please view the LICENSE
  8. * file that was distributed with this source code.
  9. */
  10. namespace Symfony\Component\Console\Output;
  11. use Symfony\Component\Console\Formatter\OutputFormatterInterface;
  12. /**
  13. * ConsoleOutput is the default class for all CLI output. It uses STDOUT and STDERR.
  14. *
  15. * This class is a convenient wrapper around `StreamOutput` for both STDOUT and STDERR.
  16. *
  17. * $output = new ConsoleOutput();
  18. *
  19. * This is equivalent to:
  20. *
  21. * $output = new StreamOutput(fopen('php://stdout', 'w'));
  22. * $stdErr = new StreamOutput(fopen('php://stderr', 'w'));
  23. *
  24. * @author Fabien Potencier <fabien@symfony.com>
  25. */
  26. class ConsoleOutput extends StreamOutput implements ConsoleOutputInterface
  27. {
  28. private OutputInterface $stderr;
  29. private array $consoleSectionOutputs = [];
  30. /**
  31. * @param int $verbosity The verbosity level (one of the VERBOSITY constants in OutputInterface)
  32. * @param bool|null $decorated Whether to decorate messages (null for auto-guessing)
  33. * @param OutputFormatterInterface|null $formatter Output formatter instance (null to use default OutputFormatter)
  34. */
  35. public function __construct(int $verbosity = self::VERBOSITY_NORMAL, ?bool $decorated = null, ?OutputFormatterInterface $formatter = null)
  36. {
  37. parent::__construct($this->openOutputStream(), $verbosity, $decorated, $formatter);
  38. if (null === $formatter) {
  39. // for BC reasons, stdErr has it own Formatter only when user don't inject a specific formatter.
  40. $this->stderr = new StreamOutput($this->openErrorStream(), $verbosity, $decorated);
  41. return;
  42. }
  43. $actualDecorated = $this->isDecorated();
  44. $this->stderr = new StreamOutput($this->openErrorStream(), $verbosity, $decorated, $this->getFormatter());
  45. if (null === $decorated) {
  46. $this->setDecorated($actualDecorated && $this->stderr->isDecorated());
  47. }
  48. }
  49. /**
  50. * Creates a new output section.
  51. */
  52. public function section(): ConsoleSectionOutput
  53. {
  54. return new ConsoleSectionOutput($this->getStream(), $this->consoleSectionOutputs, $this->getVerbosity(), $this->isDecorated(), $this->getFormatter());
  55. }
  56. public function setDecorated(bool $decorated): void
  57. {
  58. parent::setDecorated($decorated);
  59. $this->stderr->setDecorated($decorated);
  60. }
  61. public function setFormatter(OutputFormatterInterface $formatter): void
  62. {
  63. parent::setFormatter($formatter);
  64. $this->stderr->setFormatter($formatter);
  65. }
  66. public function setVerbosity(int $level): void
  67. {
  68. parent::setVerbosity($level);
  69. $this->stderr->setVerbosity($level);
  70. }
  71. public function getErrorOutput(): OutputInterface
  72. {
  73. return $this->stderr;
  74. }
  75. public function setErrorOutput(OutputInterface $error): void
  76. {
  77. $this->stderr = $error;
  78. }
  79. /**
  80. * Returns true if current environment supports writing console output to
  81. * STDOUT.
  82. */
  83. protected function hasStdoutSupport(): bool
  84. {
  85. return false === $this->isRunningOS400();
  86. }
  87. /**
  88. * Returns true if current environment supports writing console output to
  89. * STDERR.
  90. */
  91. protected function hasStderrSupport(): bool
  92. {
  93. return false === $this->isRunningOS400();
  94. }
  95. /**
  96. * Checks if current executing environment is IBM iSeries (OS400), which
  97. * doesn't properly convert character-encodings between ASCII to EBCDIC.
  98. */
  99. private function isRunningOS400(): bool
  100. {
  101. $checks = [
  102. \function_exists('php_uname') ? php_uname('s') : '',
  103. getenv('OSTYPE'),
  104. \PHP_OS,
  105. ];
  106. return false !== stripos(implode(';', $checks), 'OS400');
  107. }
  108. /**
  109. * @return resource
  110. */
  111. private function openOutputStream()
  112. {
  113. if (!$this->hasStdoutSupport()) {
  114. return fopen('php://output', 'w');
  115. }
  116. // Use STDOUT when possible to prevent from opening too many file descriptors
  117. return \defined('STDOUT') ? \STDOUT : (@fopen('php://stdout', 'w') ?: fopen('php://output', 'w'));
  118. }
  119. /**
  120. * @return resource
  121. */
  122. private function openErrorStream()
  123. {
  124. if (!$this->hasStderrSupport()) {
  125. return fopen('php://output', 'w');
  126. }
  127. // Use STDERR when possible to prevent from opening too many file descriptors
  128. return \defined('STDERR') ? \STDERR : (@fopen('php://stderr', 'w') ?: fopen('php://output', 'w'));
  129. }
  130. }