MediaWiki  REL1_22
Public Member Functions | Public Attributes | Static Public Attributes | Protected Member Functions
ForkController Class Reference
Maintenance

Class for managing forking command line scripts. More...

List of all members.

Public Member Functions

 __construct ($numProcs, $flags=0)
 start ()
 Start the child processes.

Public Attributes

 $children = array()
 $flags = 0
 $procsToStart = 0
 $termReceived = false
const RESTART_ON_ERROR = 1
 Pass this flag to __construct() to cause the class to automatically restart workers that exit with non-zero exit status or a signal such as SIGSEGV.

Static Public Attributes

static $restartableSignals

Protected Member Functions

 forkWorkers ($numProcs)
 Fork a number of worker processes.
 handleTermSignal ($signal)
 initChild ()
 prepareEnvironment ()

Detailed Description

Class for managing forking command line scripts.

Currently just does forking and process control, but it could easily be extended to provide IPC and job dispatch.

This class requires the posix and pcntl extensions.

Definition at line 32 of file ForkController.php.

Constructor & Destructor Documentation

ForkController::__construct ( $  numProcs,
$  flags = 0 
)

Definition at line 55 of file ForkController.php.

References $flags, and flags.

Member Function Documentation

ForkController::forkWorkers ( $  numProcs) [protected]

Fork a number of worker processes.

Returns:
string

Definition at line 155 of file ForkController.php.

References initChild(), and prepareEnvironment().

Referenced by start().

ForkController::handleTermSignal ( $  signal) [protected]

Definition at line 186 of file ForkController.php.

ForkController::initChild ( ) [protected]

Definition at line 179 of file ForkController.php.

References $wgMainCacheType, $wgMemc, global, and wfGetCache().

Referenced by forkWorkers().

ForkController::prepareEnvironment ( ) [protected]

Definition at line 140 of file ForkController.php.

References $wgMemc, ObjectCache\clear(), FileBackendGroup\destroySingleton(), LockManagerGroup\destroySingletons(), global, and wfGetLBFactory().

Referenced by forkWorkers().

ForkController::start ( )

Start the child processes.

This should only be called from the command line. It should be called as early as possible during execution.

This will return 'child' in the child processes. In the parent process, it will run until all the child processes exit or a TERM signal is received. It will then return 'done'.

Returns:
string

Definition at line 74 of file ForkController.php.

References array(), as, flags, and forkWorkers().

Member Data Documentation

ForkController::$children = array()

Definition at line 33 of file ForkController.php.

ForkController::$flags = 0

Definition at line 35 of file ForkController.php.

Referenced by __construct().

ForkController::$procsToStart = 0

Definition at line 35 of file ForkController.php.

ForkController::$restartableSignals [static]
Initial value:
 array(
        SIGFPE,
        SIGILL,
        SIGSEGV,
        SIGBUS,
        SIGABRT,
        SIGSYS,
        SIGPIPE,
        SIGXCPU,
        SIGXFSZ,
    )

Definition at line 37 of file ForkController.php.

ForkController::$termReceived = false

Definition at line 34 of file ForkController.php.

const ForkController::RESTART_ON_ERROR = 1

Pass this flag to __construct() to cause the class to automatically restart workers that exit with non-zero exit status or a signal such as SIGSEGV.

Definition at line 53 of file ForkController.php.

The documentation for this class was generated from the following file: