OutputInterface.php 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111
  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. * OutputInterface is the interface implemented by all Output classes.
  14. *
  15. * @author Fabien Potencier <fabien@symfony.com>
  16. */
  17. interface OutputInterface
  18. {
  19. public const VERBOSITY_QUIET = 16;
  20. public const VERBOSITY_NORMAL = 32;
  21. public const VERBOSITY_VERBOSE = 64;
  22. public const VERBOSITY_VERY_VERBOSE = 128;
  23. public const VERBOSITY_DEBUG = 256;
  24. public const OUTPUT_NORMAL = 1;
  25. public const OUTPUT_RAW = 2;
  26. public const OUTPUT_PLAIN = 4;
  27. /**
  28. * Writes a message to the output.
  29. *
  30. * @param bool $newline Whether to add a newline
  31. * @param int $options A bitmask of options (one of the OUTPUT or VERBOSITY constants),
  32. * 0 is considered the same as self::OUTPUT_NORMAL | self::VERBOSITY_NORMAL
  33. *
  34. * @return void
  35. */
  36. public function write(string|iterable $messages, bool $newline = false, int $options = 0);
  37. /**
  38. * Writes a message to the output and adds a newline at the end.
  39. *
  40. * @param int $options A bitmask of options (one of the OUTPUT or VERBOSITY constants),
  41. * 0 is considered the same as self::OUTPUT_NORMAL | self::VERBOSITY_NORMAL
  42. *
  43. * @return void
  44. */
  45. public function writeln(string|iterable $messages, int $options = 0);
  46. /**
  47. * Sets the verbosity of the output.
  48. *
  49. * @param self::VERBOSITY_* $level
  50. *
  51. * @return void
  52. */
  53. public function setVerbosity(int $level);
  54. /**
  55. * Gets the current verbosity of the output.
  56. *
  57. * @return self::VERBOSITY_*
  58. */
  59. public function getVerbosity(): int;
  60. /**
  61. * Returns whether verbosity is quiet (-q).
  62. */
  63. public function isQuiet(): bool;
  64. /**
  65. * Returns whether verbosity is verbose (-v).
  66. */
  67. public function isVerbose(): bool;
  68. /**
  69. * Returns whether verbosity is very verbose (-vv).
  70. */
  71. public function isVeryVerbose(): bool;
  72. /**
  73. * Returns whether verbosity is debug (-vvv).
  74. */
  75. public function isDebug(): bool;
  76. /**
  77. * Sets the decorated flag.
  78. *
  79. * @return void
  80. */
  81. public function setDecorated(bool $decorated);
  82. /**
  83. * Gets the decorated flag.
  84. */
  85. public function isDecorated(): bool;
  86. /**
  87. * @return void
  88. */
  89. public function setFormatter(OutputFormatterInterface $formatter);
  90. /**
  91. * Returns current output formatter instance.
  92. */
  93. public function getFormatter(): OutputFormatterInterface;
  94. }