Cecil

Serve extends AbstractCommand

Serve command.

This command starts the built-in web server with live reloading capabilities. It allows users to serve their website locally and automatically rebuild it when changes are detected. It also supports opening the web browser automatically and includes options for drafts, optimization, and more.

Table of Contents

Constants

CONFIG_FILE  = ['cecil.yml', 'config.yml']
EXCLUDED_CMD  = ['about', 'new:site', 'self-update']
TMP_DIR  = '.cecil'

Properties

$input  : InputInterface
$io  : SymfonyStyle
$output  : OutputInterface
$watcherEnabled  : bool

Methods

getProcessedHelp()  : string
Override default help message.
run()  : int
{@inheritdoc}
tearDownServer()  : void
Removes temporary directory.
validateUrl()  : string
Validate URL.
binName()  : string
Returns the "binary name" in the console context.
configure()  : mixed
{@inheritdoc}
execute()  : mixed
{@inheritdoc}
getBuilder()  : Builder
Creates or returns a Builder instance.
getConfigFiles()  : array<string|int, mixed>
Returns config file(s) path.
getPath()  : string|null
Returns the working path.
initialize()  : mixed
{@inheritdoc}
locateAdditionalConfigFiles()  : array<string|int, mixed>
Locates additional configuration file(s) from the given list of files, relative to the given path or absolute.
locateConfigFile()  : array<string|int, mixed>
Locates the configuration in the given path, as an array of the file name and path, if file exists, otherwise default name and false.
openEditor()  : void
Opens path with editor.
buildSuccessActions()  : void
Build success actions.
setUpServer()  : void
Prepares server's files.
setupWatcher()  : ResourceWatcher
Sets up the watcher.

Constants

EXCLUDED_CMD

public mixed EXCLUDED_CMD = ['about', 'new:site', 'self-update']

Properties

$watcherEnabled

protected bool $watcherEnabled

Methods

getProcessedHelp()

Override default help message.

public getProcessedHelp() : string
Return values
string

run()

{@inheritdoc}

public run(InputInterface $input, OutputInterface $output) : int
Parameters
$input : InputInterface
$output : OutputInterface
Return values
int

validateUrl()

Validate URL.

public static validateUrl(string $url) : string
Parameters
$url : string
Tags
throws
RuntimeException
Return values
string

binName()

Returns the "binary name" in the console context.

protected binName() : string
Return values
string

configure()

{@inheritdoc}

protected configure() : mixed

execute()

{@inheritdoc}

protected execute(InputInterface $input, OutputInterface $output) : mixed
Parameters
$input : InputInterface
$output : OutputInterface
Tags
throws
RuntimeException

getBuilder()

Creates or returns a Builder instance.

protected getBuilder([array<string|int, mixed> $config = [] ]) : Builder
Parameters
$config : array<string|int, mixed> = []
Tags
throws
RuntimeException
Return values
Builder

getConfigFiles()

Returns config file(s) path.

protected getConfigFiles() : array<string|int, mixed>
Return values
array<string|int, mixed>

getPath()

Returns the working path.

protected getPath([bool $exist = true ]) : string|null
Parameters
$exist : bool = true
Return values
string|null

initialize()

{@inheritdoc}

protected initialize(InputInterface $input, OutputInterface $output) : mixed
Parameters
$input : InputInterface
$output : OutputInterface

locateAdditionalConfigFiles()

Locates additional configuration file(s) from the given list of files, relative to the given path or absolute.

protected locateAdditionalConfigFiles(string $path, string $configFilesList) : array<string|int, mixed>
Parameters
$path : string
$configFilesList : string
Return values
array<string|int, mixed>

locateConfigFile()

Locates the configuration in the given path, as an array of the file name and path, if file exists, otherwise default name and false.

protected locateConfigFile(string $path) : array<string|int, mixed>
Parameters
$path : string
Return values
array<string|int, mixed>

openEditor()

Opens path with editor.

protected openEditor(string $path, string $editor) : void
Parameters
$path : string
$editor : string
Tags
throws
RuntimeException

buildSuccessActions()

Build success actions.

private buildSuccessActions(OutputInterface $output) : void
Parameters
$output : OutputInterface

setUpServer()

Prepares server's files.

private setUpServer(string $host, string $port) : void
Parameters
$host : string
$port : string
Tags
throws
RuntimeException

setupWatcher()

Sets up the watcher.

private setupWatcher([bool $noignorevcs = false ]) : ResourceWatcher
Parameters
$noignorevcs : bool = false
Return values
ResourceWatcher
 
On this page

Search results