call()¶

Calls a function or callable with validated models: BaseModel parameters hydrate from the raw data array through the same engine validate() uses, and every other parameter is injected from a dependencies array or ArrayAccess container.

<?php
namespace Attributes\Strictify;

function call(string|callable $function, array $params, array|ArrayAccess $dependencies = []): mixed

<?php
use function Attributes\Strictify\call;

$result = call(myFunction(...), $rawData, $dependencies);

Parameters¶

Model hydration¶

Every BaseModel-typed parameter of the callable is hydrated from $params through the full validate() flow: strict/loose mode, aliases, array type-hint attributes, hooks and ValidationException with dot-notation field paths all behave identically.

<?php
use Attributes\Strictify\BaseModel;
use function Attributes\Strictify\call;

class User extends BaseModel
{
    public int $age;
    public string $name;
}

function registerUser(User $user): string
{
    return "registered {$user->name}";
}

call('registerUser', ['age' => 30, 'name' => 'Andre']);
// "registered Andre"

A ValidationException thrown while hydrating a parameter propagates out of call() unchanged.

Dependencies¶

Non-model parameters take their values from $dependencies:

• Matched by parameter name first, then in positional order.
• Internal functions (whose signatures cannot declare models) receive them positionally: call('str_repeat', [], ['x', 3]) returns xxx.
• A missing value for an optional parameter lets the engine apply the declared default.
• A missing value for a required parameter throws an Error: No value provided for parameter $second of registerUser()..
• Variadic targets receive the leftover positional dependencies.

Lazy ArrayAccess containers¶

Instead of an array, pass any ArrayAccess instance — ArrayObject or a lazy DI container. The container is only asked for the dependencies the call actually consumes: offsetGet() runs solely for parameters that look a value up by name or position, so a service inside a lazy container is constructed only when a parameter needs it.

<?php
$container = new ArrayObject(['logger' => $logger]);

function ship(stdClass $logger): string
{
    return "shipping with {$logger->name}";
}

call('ship', [], $container);

Exceptions thrown by a container's offsetExists()/offsetGet() propagate as-is. Passing anything other than an array or ArrayAccess (an integer, a plain object, a string) throws a TypeError.

Return value¶

call() returns the callable's return value, unchanged.