Component

Type
Class
Namespace
craft\helpers
Inherits
craft\helpers\Component
Since
3.0

Component helper

View source

Public Methods

MethodDescription
createComponent()Instantiates and populates a component, and ensures that it is an instance of a given interface.
mergeSettings()Extracts settings from a given component config, and returns a new config array with the settings merged in.
validateComponentClass()Returns whether a component class exists, is an instance of a given interface, and doesn't belong to a disabled plugin.

createComponent()

Instantiates and populates a component, and ensures that it is an instance of a given interface.

View source

Arguments

  • $config (mixed) – The component’s class name, or its config, with a type value and optionally a settings value.
  • $instanceOf (string, null) – The class or interface that the component must be an instance of.

Returns

craft\base\ComponentInterface – The component

Throws

mergeSettings()

Extracts settings from a given component config, and returns a new config array with the settings merged in.

View source

Arguments

Returns

array

validateComponentClass()

Returns whether a component class exists, is an instance of a given interface, and doesn't belong to a disabled plugin.

View source

Arguments

  • $class (string) – The component’s class name.
  • $instanceOf (string, null) – The class or interface that the component must be an instance of.
  • $throwException (boolean) – Whether an exception should be thrown if an issue is encountered

Returns

boolean

Throws