abstract class Component implements IComponent

Base class for all components. Components have a parent, name, and can be monitored by ancestors.

Properties

string read-only $name
IContainer|null read-only $parent

Methods

IComponent|null
lookup(string|null $type, bool $throw = true)

Finds the closest ancestor of specified type.

string|null
lookupPath(string|null $type = null, bool $throw = true)

Finds the closest ancestor specified by class or interface name and returns backtrace path.

void
monitor(string $type, callable|null $attached = null, callable|null $detached = null)

Starts monitoring ancestors for attach/detach events.

void
unmonitor(string $type)

Stops monitoring ancestors of specified type.

void
attached(IComponent $obj) deprecated

This method will be called when the component (or component's parent) becomes attached to a monitored object. Do not call this method yourself.

void
detached(IComponent $obj) deprecated

This method will be called before the component (or component's parent) becomes detached from a monitored object. Do not call this method yourself.

string|null
getName()

No description

IContainer|null
getParent()

Returns the parent container if any.

setParent(IContainer|null $parent, string|null $name = null)

Sets or removes the parent of this component. This method is managed by containers and should not be called by applications

void
validateParent(IContainer $parent)

Validates the new parent before it's set.

__clone()

Object cloning.

__sleep()

Prevents serialization.

__wakeup()

Prevents unserialization.

Details

at line 37
final IComponent|null lookup(string|null $type, bool $throw = true)

Finds the closest ancestor of specified type.

Parameters

string|null $type
bool $throw

throw exception if component doesn't exist?

Return Value

IComponent|null

at line 81
final string|null lookupPath(string|null $type = null, bool $throw = true)

Finds the closest ancestor specified by class or interface name and returns backtrace path.

A path is the concatenation of component names separated by self::NAME_SEPARATOR.

Parameters

string|null $type
bool $throw

Return Value

string|null

at line 91
final void monitor(string $type, callable|null $attached = null, callable|null $detached = null)

Starts monitoring ancestors for attach/detach events.

Parameters

string $type
callable|null $attached
callable|null $detached

Return Value

void

at line 113
final void unmonitor(string $type)

Stops monitoring ancestors of specified type.

Parameters

string $type

Return Value

void

at line 124
protected void attached(IComponent $obj) deprecated

deprecated use monitor($type, $attached)

This method will be called when the component (or component's parent) becomes attached to a monitored object. Do not call this method yourself.

Parameters

IComponent $obj

Return Value

void

at line 134
protected void detached(IComponent $obj) deprecated

deprecated use monitor($type, null, $detached)

This method will be called before the component (or component's parent) becomes detached from a monitored object. Do not call this method yourself.

Parameters

IComponent $obj

Return Value

void

at line 142
final string|null getName()

No description

Return Value

string|null

at line 151
final IContainer|null getParent()

Returns the parent container if any.

Return Value

IContainer|null

at line 163
IComponent setParent(IContainer|null $parent, string|null $name = null)

internal  
 

Sets or removes the parent of this component. This method is managed by containers and should not be called by applications

Parameters

IContainer|null $parent
string|null $name

Return Value

IComponent

Exceptions

InvalidStateException

at line 203
protected void validateParent(IContainer $parent)

Validates the new parent before it's set.

Descendant classes can override this to implement custom validation logic.

Parameters

IContainer $parent

Return Value

void

Exceptions

InvalidStateException

at line 280
__clone()

Object cloning.

at line 300
final __sleep()

Prevents serialization.

at line 309
final __wakeup()

Prevents unserialization.

Traits

SmartObject