ServeCommand
class ServeCommand extends Command (View source)
Traits
Properties
| protected Factory | $components | The console components factory. |
from InteractsWithIO |
| protected InputInterface | $input | The input interface implementation. |
from InteractsWithIO |
| protected OutputStyle | $output | The output interface implementation. |
from InteractsWithIO |
| protected int | $verbosity | The default verbosity of output commands. |
from InteractsWithIO |
| protected array | $verbosityMap | The mapping between human readable verbosity levels and Symfony's OutputInterface. |
from InteractsWithIO |
| protected Signals|null | $signals | The signal registrar instance. |
from InteractsWithSignals |
| static protected array | $macros | The registered string macros. |
from Macroable |
| protected Application | $laravel | The Laravel application instance. |
from Command |
| protected string | $signature | The name and signature of the console command. |
from Command |
| protected string | $name | The console command name. |
|
| protected string | $description | The console command description. |
|
| protected string | $help | The console command help text. |
from Command |
| $hidden | Indicates whether the command should be shown in the Artisan command list. |
from Command | |
| protected bool | $isolated | Indicates whether only one instance of the command can run at any given time. |
from Command |
| protected int | $isolatedExitCode | The default exit code for isolated commands. |
from Command |
| protected array | $aliases | The console command name aliases. |
from Command |
| protected int<2, max>|false | $phpServerWorkers | The number of PHP CLI server workers. |
|
| protected int | $portOffset | The current port offset. |
|
| protected string | $outputBuffer | The list of lines that are pending to be output. |
|
| protected Carbon> | $requestsPool | The list of requests being handled and their start time. |
|
| protected bool | $serverRunningHasBeenDisplayed | Indicates if the "Server running on..." output message has been displayed. |
|
| static string[] | $passthroughVariables | The environment variables that should be passed from host machine to the PHP server process. |
Methods
Resolve the console command instance for the given command.
Call another console command.
Call another console command without output.
Call another console command without output.
Run the given console command.
Create an input instance from the given arguments.
Prompt the user until the given validation callback passes.
Validate the given prompt value using the validator.
Get the validator instance that should be used to validate prompts.
Get the validation messages that should be used during prompt validation.
Get the validation attributes that should be used during prompt validation.
Get the console command options.
Get the value of a command argument.
Determine whether the option is defined in the command signature.
Get the value of a command option.
Confirm a question with the user.
Prompt the user for input.
Prompt the user for input with auto completion.
Prompt the user for input with auto completion.
Prompt the user for input but hide the answer from the console.
Give the user a single choice from an array of answers.
Format input to textual table.
Execute a given callback while advancing a progress bar.
Write a string as information output.
Write a string as standard output.
Write a string as comment output.
Write a string as question output.
Write a string as error output.
Write a string as warning output.
Write a string in an alert box.
Get the verbosity level in terms of Symfony's OutputInterface level.
Interact with the user before validating the input.
Prompt the user for any missing arguments.
Prompt for missing input arguments using the returned questions.
Perform actions after the user was prompted for missing arguments.
Whether the input contains any options that differ from the default values.
Mix another object into the class.
Dynamically handle calls to the class.
Dynamically handle calls to the class.
Configure the console command using a fluent definition.
Execute the console command.
Get a command isolation mutex instance for the command.
Get the number of seconds until the given DateTime.
If the given value is an interval, convert it to a DateTime instance.
Given a start time, format the total run time for human readability.
{@inheritdoc}
Execute the console command.
Start a new server process.
Get the full server command.
Get the host for the command.
Get the port for the command.
Get the host and port from the host option string.
Check if the command has reached its maximum number of port tries.
Returns a "callable" to handle the process output.
Flush the output buffer.
Get the date from the given PHP server output.
Get the request port from the given PHP server output.
Details
abstract protected Command
resolveCommand(Command|string $command)
Resolve the console command instance for the given command.
int
call(Command|string $command, array $arguments = [])
Call another console command.
int
callSilent(Command|string $command, array $arguments = [])
Call another console command without output.
int
callSilently(Command|string $command, array $arguments = [])
Call another console command without output.
protected int
runCommand(Command|string $command, array $arguments, OutputInterface $output)
Run the given console command.
protected ArrayInput
createInputFromArguments(array $arguments)
Create an input instance from the given arguments.
protected array
context()
Get all of the context passed to the command.
protected void
configurePrompts(InputInterface $input)
Configure the prompt fallbacks.
protected mixed
promptUntilValid(Closure $prompt, bool|string $required, Closure|null $validate)
Prompt the user until the given validation callback passes.
protected ?string
validatePrompt(mixed $value, mixed $rules)
Validate the given prompt value using the validator.
protected Validator
getPromptValidatorInstance(mixed $field, mixed $value, mixed $rules, array $messages = [], array $attributes = [])
Get the validator instance that should be used to validate prompts.
protected array
validationMessages()
Get the validation messages that should be used during prompt validation.
protected array
validationAttributes()
Get the validation attributes that should be used during prompt validation.
protected void
restorePrompts()
Restore the prompts output.
protected void
specifyParameters()
Specify the arguments and options on the command.
protected array
getArguments()
Get the console command arguments.
protected array
getOptions()
Get the console command options.
bool
hasArgument(string|int $name)
Determine if the given argument is present.
array|string|bool|null
argument(string|null $key = null)
Get the value of a command argument.
array
arguments()
Get all of the arguments passed to the command.
bool
hasOption(string $name)
Determine whether the option is defined in the command signature.
string|array|bool|null
option(string|null $key = null)
Get the value of a command option.
array
options()
Get all of the options passed to the command.
bool
confirm(string $question, bool $default = false)
Confirm a question with the user.
mixed
ask(string $question, string|null $default = null)
Prompt the user for input.
mixed
anticipate(string $question, array|callable $choices, string|null $default = null)
Prompt the user for input with auto completion.
mixed
askWithCompletion(string $question, array|callable $choices, string|null $default = null)
Prompt the user for input with auto completion.
mixed
secret(string $question, bool $fallback = true)
Prompt the user for input but hide the answer from the console.
string|array
choice(string $question, array $choices, string|int|null $default = null, mixed $attempts = null, bool $multiple = false)
Give the user a single choice from an array of answers.
void
table(array $headers, Arrayable|array $rows, TableStyle|string $tableStyle = 'default', array $columnStyles = [])
Format input to textual table.
mixed|void
withProgressBar(iterable|int $totalSteps, Closure $callback)
Execute a given callback while advancing a progress bar.
void
info(string $string, int|string|null $verbosity = null)
Write a string as information output.
void
line(string $string, string|null $style = null, int|string|null $verbosity = null)
Write a string as standard output.
void
comment(string $string, int|string|null $verbosity = null)
Write a string as comment output.
void
question(string $string, int|string|null $verbosity = null)
Write a string as question output.
void
error(string $string, int|string|null $verbosity = null)
Write a string as error output.
void
warn(string $string, int|string|null $verbosity = null)
Write a string as warning output.
void
alert(string $string, int|string|null $verbosity = null)
Write a string in an alert box.
$this
newLine(int $count = 1)
Write a blank line.
void
setInput(InputInterface $input)
Set the input interface implementation.
void
setOutput(OutputStyle $output)
Set the output interface implementation.
protected void
setVerbosity(string|int $level)
Set the verbosity level.
protected int
parseVerbosity(string|int|null $level = null)
Get the verbosity level in terms of Symfony's OutputInterface level.
OutputStyle
getOutput()
Get the output implementation.
Factory
outputComponents()
Get the output component factory implementation.
trap($signals, $callback)
No description
void
untrap()
| internal |
Untrap signal handlers set within the command's handler.
protected void
interact(InputInterface $input, OutputInterface $output)
Interact with the user before validating the input.
protected void
promptForMissingArguments(InputInterface $input, OutputInterface $output)
Prompt the user for any missing arguments.
protected array
promptForMissingArgumentsUsing()
Prompt for missing input arguments using the returned questions.
protected void
afterPromptingForMissingArguments(InputInterface $input, OutputInterface $output)
Perform actions after the user was prompted for missing arguments.
protected bool
didReceiveOptions(InputInterface $input)
Whether the input contains any options that differ from the default values.
static void
macro(string $name, object|callable $macro)
Register a custom macro.
static void
mixin(object $mixin, bool $replace = true)
Mix another object into the class.
static bool
hasMacro(string $name)
Checks if macro is registered.
static void
flushMacros()
Flush the existing macros.
static mixed
__callStatic(string $method, array $parameters)
Dynamically handle calls to the class.
mixed
__call(string $method, array $parameters)
Dynamically handle calls to the class.
__construct()
Create a new console command instance.
protected void
configureUsingFluentDefinition()
Configure the console command using a fluent definition.
protected void
configureIsolation()
Configure the console command for isolation.
int
run(InputInterface $input, OutputInterface $output)
Run the console command.
protected int
execute(InputInterface $input, OutputInterface $output)
Execute the console command.
protected CommandMutex
commandIsolationMutex()
Get a command isolation mutex instance for the command.
never
fail(Throwable|string|null $exception = null)
Fail the command manually.
bool
isHidden()
{@inheritdoc}
Command
setHidden(bool $hidden = true)
{@inheritdoc}
Application
getLaravel()
Get the Laravel application instance.
void
setLaravel(Container $laravel)
Set the Laravel application instance.
protected int
secondsUntil(DateTimeInterface|DateInterval|int $delay)
Get the number of seconds until the given DateTime.
protected int
availableAt(DateTimeInterface|DateInterval|int $delay = 0)
Get the "available at" UNIX timestamp.
protected DateTimeInterface|int
parseDateInterval(DateTimeInterface|DateInterval|int $delay)
If the given value is an interval, convert it to a DateTime instance.
protected int
currentTime()
Get the current system time as a UNIX timestamp.
protected string
runTimeForHumans(float $startTime, float|null $endTime = null)
Given a start time, format the total run time for human readability.
protected
initialize(InputInterface $input, OutputInterface $output)
{@inheritdoc}
int
handle()
Execute the console command.
protected Process
startProcess(bool $hasEnvironment)
Start a new server process.
protected array
serverCommand()
Get the full server command.
protected string
host()
Get the host for the command.
protected string
port()
Get the port for the command.
protected array
getHostAndPort()
Get the host and port from the host option string.
protected bool
canTryAnotherPort()
Check if the command has reached its maximum number of port tries.
protected
handleProcessOutput()
Returns a "callable" to handle the process output.
protected void
flushOutputBuffer()
Flush the output buffer.
protected Carbon
getDateFromLine(string $line)
Get the date from the given PHP server output.
static int
getRequestPortFromLine(string $line)
Get the request port from the given PHP server output.