Skip to content
docs

CapabilityRequirement

A `requires` capability record. Declares a HARD dependency on a contract: at least one installed provider must satisfy `interface` within the semver `constraint` range. `oneOf` optionally lists provider capability ids any of which satisfies the requirement. Legacy bare-FQCN declarations are accepted via {@see fromInterface()}.

CapabilityRequirement::__construct()

public function __construct(string $id, string $interface, string $constraint = '*', array $oneOf = []):

Parameters

Parámetros de __construct()
NombreTipoDescripción
$idstring
$interfacestring
$constraintstring
$oneOflist<string>

CapabilityRequirement::fromArray()

public static function fromArray(array $record): self

Build a requirement record from a decoded `requires` manifest entry, validating `id` and `interface`, defaulting `constraint` to `*`, and normalizing `oneOf` to a list of non-empty strings.

Parameters

Parámetros de fromArray()
NombreTipoDescripción
$recordarray<string, mixed>

Throws

\InvalidArgumentException If `id` or `interface` is empty.

CapabilityRequirement::fromInterface()

public static function fromInterface(string $interface): self

Wrap a legacy bare-FQCN declaration as an any-version requirement.

Parameters

Parámetros de fromInterface()
NombreTipoDescripción
$interfacestring

CapabilityRequirement::parse()

public static function parse(array|string $record): self

Parse a `requires` manifest entry in either the legacy bare-FQCN string form or the structured-record array form, dispatching to {@see fromInterface()} or {@see fromArray()}.

Parameters

Parámetros de parse()
NombreTipoDescripción
$record(string | array<string, mixed>)