Joomla! API

Download
Launch

AbstractDaemonApplication

Extends AbstractCliApplication Implements LoggerAwareInterface

Class to turn Cli applications into daemons. It requires CLI and PCNTL support built into PHP.

abstract deprecated
link
since

1.0
deprecated

2.0 Deprecated without replacement
package

Joomla Framework

Methods

__construct

Class constructor.

__construct(\Joomla\Input\Input input = null, \Joomla\Registry\Registry config = null) : mixed
inherited
since

1.0

Arguments

input

\Joomla\Input\InputAn optional argument to provide dependency injection for the application's input object. If the argument is an Input object that object will become the application's input object, otherwise a default input object is created.

config

\Joomla\Registry\RegistryAn optional argument to provide dependency injection for the application's config object. If the argument is a Registry object that object will become the application's config object, otherwise a default config object is created.

Response

mixed

changeIdentity

Method to change the identity of the daemon process and resources.

changeIdentity() : bool
since

1.0
see posix_setuid()

Response

boolTrue if identity successfully changed

close

Method to close the application.

close(int code) : void
inherited
since

1.0

Arguments

code

intThe exit code (optional; default is 0).

daemonize

Method to put the application into the background.

daemonize() : bool
since

1.0
throws

\RuntimeException

Response

bool

detach

This is truly where the magic happens. This is where we fork the process and kill the parent process, which is essentially what turns the application into a daemon.

detach() : void
since

1.0
throws

\RuntimeException

doExecute

Method to run the application routines. Most likely you will want to instantiate a controller and execute it, or perform some sort of task directly.

doExecute() : mixed
inherited abstract
since

1.0

Response

mixed

execute

Execute the application.

execute() : void
inherited
since

1.0

fork

Method to fork the process.

fork() : int
since

1.0
throws

\RuntimeException

Response

intThe child process id to the parent process, zero to the child process.

gc

Method to perform basic garbage collection and memory management in the sense of clearing the stat cache. We will probably call this method pretty regularly in our main loop.

gc() : void
since

1.0

get

Returns a property of the object or the default value if the property is not set.

get(string key, mixed default = null) : mixed
inherited
since

1.0

Arguments

key

stringThe name of the property.

default

mixedThe default value (optional) if none is set.

Response

mixedThe value of the configuration.

getCliInput

Get a CLI input object.

getCliInput() : \Joomla\Application\Cli\CliInput
inherited
since

1.6.0

Response

\Joomla\Application\Cli\CliInput

getLogger

Get the logger.

getLogger() : \Psr\Log\LoggerInterface
inherited
since

1.0

Response

\Psr\Log\LoggerInterface

getOutput

Get an output object.

getOutput() : \Joomla\Application\Cli\CliOutput
inherited
since

1.0

Response

\Joomla\Application\Cli\CliOutput

in

Get a value from standard input.

in() : string
inherited
since

1.0

Response

stringThe input string from standard input.

initialise

Custom initialisation method.

initialise() : void
inherited

Called at the end of the AbstractApplication::__construct method. This is for developers to inject initialisation code for their application classes.

since

1.0

isActive

Check to see if the daemon is active. This does not assume that $this daemon is active, but only if an instance of the application is active as a daemon.

isActive() : bool
since

1.0

Response

boolTrue if daemon is active.

loadConfiguration

Load an object or array into the application configuration object.

loadConfiguration(mixed data) : \Joomla\Application\AbstractDaemonApplication
since

1.0

Arguments

data

mixedEither an array or object to be loaded into the configuration object.

Response

\Joomla\Application\AbstractDaemonApplicationInstance of $this to allow chaining.

out

Write a string to standard output.

out(string text = '', bool nl = true) : \Joomla\Application\AbstractCliApplication
inherited
since

1.0

Arguments

text

stringThe text to display.

nl

boolTrue (default) to append a new line at the end of the output string.

Response

\Joomla\Application\AbstractCliApplicationInstance of $this to allow chaining.

pcntlChildExitStatus

Method to return the exit code of a terminated child process.

pcntlChildExitStatus(int status) : int
see pcntl_wexitstatus()
since

1.0

Arguments

status

intThe status parameter is the status parameter supplied to a successful call to pcntl_waitpid().

Response

intThe child process exit code.

pcntlFork

Method to return the exit code of a terminated child process.

pcntlFork() : int
see pcntl_fork()
since

1.0

Response

intOn success, the PID of the child process is returned in the parent's thread of execution, and a 0 is returned in the child's thread of execution. On failure, a -1 will be returned in the parent's context, no child process will be created, and a PHP error is raised.

pcntlSignal

Method to install a signal handler.

pcntlSignal(int signal, callable handler, bool restart = true) : bool
see pcntl_signal()
since

1.0

Arguments

signal

intThe signal number.

handler

callableThe signal handler which may be the name of a user created function, or method, or either of the two global constants SIG_IGN or SIG_DFL.

restart

boolSpecifies whether system call restarting should be used when this signal arrives.

Response

boolTrue on success.

pcntlWait

Method to wait on or return the status of a forked child.

pcntlWait(int &status, int options) : int
see pcntl_wait()
since

1.0

Arguments

status

intStatus information.

options

intIf wait3 is available on your system (mostly BSD-style systems), you can provide the optional options parameter.

Response

intThe process ID of the child which exited, -1 on error or zero if WNOHANG was provided as an option (on wait3-available systems) and no child was available.

postFork

Method to handle post-fork triggering of the onFork event.

postFork() : void
since

1.0

restart

Restart daemon process.

restart() : void
since

1.0

set

Modifies a property of the object, creating it if it does not already exist.

set(string key, mixed value = null) : mixed
inherited
since

1.0

Arguments

key

stringThe name of the property.

value

mixedThe value of the property to set (optional).

Response

mixedPrevious value of the property

setConfiguration

Sets the configuration for the application.

setConfiguration(\Joomla\Registry\Registry config) : \Joomla\Application\AbstractApplication
inherited
since

1.0

Arguments

config

\Joomla\Registry\RegistryA registry object holding the configuration.

Response

\Joomla\Application\AbstractApplicationReturns itself to support chaining.

setLogger

Set the logger.

setLogger(\Psr\Log\LoggerInterface logger) : \Joomla\Application\AbstractApplication
inherited
since

1.0

Arguments

logger

\Psr\Log\LoggerInterfaceThe logger.

Response

\Joomla\Application\AbstractApplicationReturns itself to support chaining.

setupSignalHandlers

Method to attach the AbstractDaemonApplication signal handler to the known signals. Applications can override these handlers by using the pcntl_signal() function and attaching a different callback method.

setupSignalHandlers() : bool
since

1.0
see pcntl_signal()

Response

bool

shutdown

Method to shut down the daemon and optionally restart it.

shutdown(bool restart = false) : void
since

1.0

Arguments

restart

boolTrue to restart the daemon on exit.

signal

Method to handle POSIX signals.

signal(int signal) : void
since

1.0
see pcntl_signal()
throws

\RuntimeException

Arguments

signal

intThe received POSIX signal.

stop

Stop daemon process.

stop() : void
since

1.0

writeProcessIdFile

Method to write the process id file out to disk.

writeProcessIdFile() : bool
since

1.0

Response

bool

Properties

signals

The available POSIX signals to be caught by default.

static
link
since

1.0

Type(s)

array

exiting

True if the daemon is in the process of exiting.

since

1.0

Type(s)

bool

parentId

The parent process id.

since

1.0

Type(s)

int

processId

The process id of the daemon.

since

1.0

Type(s)

int

running

True if the daemon is currently running.

since

1.0

Type(s)

bool

output

Output object

inherited
since

1.0

Type(s)

\Joomla\Application\Cli\CliOutput

cliInput

CLI Input object

inherited
since

1.6.0

Type(s)

\Joomla\Application\Cli\CliInput

config

The application configuration object.

inherited
since

1.0

Type(s)

\Joomla\Registry\Registry

input

The application input object.

inherited
since

1.0

Type(s)

\Joomla\Input\Input

logger

A logger.

inherited
since

1.0

Type(s)

\Psr\Log\LoggerInterface
  • \ Joomla
  • \ Application
  • \ AbstractDaemonApplication