Component Model Laravel Package

Getting Started

Install via Composer: composer require nette/component-model. This package delivers a minimal, standalone component model adapted from Nette Framework—ideal for building hierarchical, reusable objects (e.g., UI widgets, domain models with parent-child semantics). Start by extending Component and using Container to manage children. Minimal setup example:

use Nette\ComponentModel\Component;
use Nette\ComponentModel\Container;

class Alert extends Component
{
    public function __construct(string $message)
    {
        $this->monitor(Component::class, fn($c, $p) => $this->message = $message);
        $this->message = $message;
    }

    public function render(): void
    {
        echo "<div>{$this->message}</div>";
    }
}

$container = new Container;
$container->addComponent(new Alert('Hello'), 'alert');
$container['alert']->render(); // Using ArrayAccess

First reference: src/ComponentModel/Component.php and src/ComponentModel/Container.php. Core methods (addComponent, getComponent, removeComponent) and lifecycle hooks (monitor) are the primary API surface.

Implementation Patterns

• Component Inheritance: Extend Component as your base class. Use getComponent($name) internally to access children—this auto-handles discovery and lazy initialization.
• Lifecycle Monitoring: Prefer monitor($classNameOrTrait, callable) over legacy attached()/detached() (deprecated since v2.4). Callbacks receive ($component, ?Component $parent) and fire only on state change.
• Container as Hierarchical Registry: Use Container to build component trees (e.g., form controls, widget groups). Support both named ($container->getComponent('submit')) and array-style ($container['submit']) access via ArrayAccess trait.
• Component Trees for Debugging: Use Container::getComponentTree() (v3.1.0+) to serialize component hierarchies—ideal for admin dashboards or middleware logs.
• Strict Typing Integration: Leverage PHP 8.2+ features: named arguments (new Container(name: 'main')), typed properties in subclasses, and strict declare(strict_types=1) in your codebase.

Gotchas and Tips

• Component Constructor Changes: Component has no constructor in v3.x. If you override __construct, do not pass $parent or $name—they are auto-assigned via Component. Passing them manually triggers deprecation warnings (v2.2+).
• Name Encoding Quirks: Container::getComponent() requires string names (v3.0+). Using integers throws NotFoundException, but ArrayAccess accepts 123 as key. Prefer string names like 'btn_submit' over numeric IDs.
• Deprecation in v3.1.0: getComponents($deep = false) now returns always an array (not void when $deep omitted) and $deep is silently deprecated. Prefer getComponentTree() for introspection.
• Exception Messages: NotFoundException from getComponent() includes suggestions for typoed names (e.g., “Component 'submt' not found. Did you mean 'submit'?”). Log these for dev feedback.
• PHP 8.5 Compatibility: Avoid dynamic properties ($this->$key = $val) in monitor() callbacks—PHP 8.5 deprecates them. Use typed properties or #[AllowDynamicProperties] only when necessary.
• No Auto-Wiring: Unlike full Nette DI, this package offers no automatic dependency injection or config-based wiring. You must attach components explicitly.