Class to implement stub globals, which are globals that delay loading the their associated module code by deferring initialisation until the first method call. More...

Inheritance diagram for StubObject:

[legend]

List of all members.

Public Member Functions
	__call ($name, $args)
	Function called by PHP if no function with that name exists in this object.
	__construct ($global=null, $class=null, $params=array())
	Constructor.
	_call ($name, $args)
	Function called if any function exists with that name in this object.
	_newObject ()
	Create a new object to replace this stub object.
	_unstub ($name= '_unstub', $level=2)
	This function creates a new object of the real class and replace it in the global variable.
Static Public Member Functions
static	isRealObject ($obj)
	Returns a bool value whetever $obj is a stub object.
Public Attributes
	$mClass
	$mGlobal
	$mParams

Detailed Description

Class to implement stub globals, which are globals that delay loading the their associated module code by deferring initialisation until the first method call.

Note on unstub loops:

Unstub loops (infinite recursion) sometimes occur when a constructor calls another function, and the other function calls some method of the stub. The best way to avoid this is to make constructors as lightweight as possible, deferring any initialisation which depends on other modules. As a last resort, you can use StubObject::isRealObject() to break the loop, but as a general rule, the stub object mechanism should be transparent, and code which refers to it should be kept to a minimum.

Definition at line 18 of file StubObject.php.

Constructor & Destructor Documentation

StubObject::__construct	(	$	global = `null`,
		$	class = `null`,
		$	params = `array()`
	)

Constructor.

Parameters:

$global	String: name of the global variable.
$class	String: name of the class of the real object.
$params	Array: parameters to pass to contructor of the real object.

Definition at line 29 of file StubObject.php.

Member Function Documentation

StubObject::__call	(	$	name,
		$	args
	)

Function called by PHP if no function with that name exists in this object.

Parameters:

$name	String: name of the function called
$args	Array: arguments

Reimplemented in StubUserLang, and StubContLang.

Definition at line 76 of file StubObject.php.

References _call().

Here is the call graph for this function:

StubObject::_call	(	$	name,
		$	args
	)

Function called if any function exists with that name in this object.

It is used to unstub the object. Only used internally, PHP will call self::__call() function and that function will call this function. This function will also call the function with the same name in the real object.

Parameters: