qa: add some more static analysis files regarding plugin managers

Signed-off-by: Maximilian Bösing <[email protected]>

test/StaticAnalysis/CallablePluginManager.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LaminasTest\ServiceManager\StaticAnalysis;
+
+use Laminas\ServiceManager\AbstractPluginManager;
+use Laminas\ServiceManager\Exception\InvalidArgumentException;
+
+use function is_callable;
+
+/**
+ * @template-extends AbstractPluginManager<callable>
+ */
+final class CallablePluginManager extends AbstractPluginManager
+{
+    public function getWhateverPlugin(array|null $options = null): callable
+    {
+        if ($options === null) {
+            return $this->get('foo');
+        }
+
+        return $this->build('foo', $options);
+    }
+
+    public function validateWhateverPlugin(mixed $plugin): callable
+    {
+        $this->validate($plugin);
+        return $plugin;
+    }
+
+    public function getConcretePlugin(): ConcreteCallablePlugin
+    {
+        return self::get(ConcreteCallablePlugin::class);
+    }
+
+    public function buildConcretePlugin(): ConcreteCallablePlugin
+    {
+        return self::build(ConcreteCallablePlugin::class);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function validate(mixed $instance): void
+    {
+        if (! is_callable($instance)) {
+            throw new InvalidArgumentException('Provided instance is not callable.');
+        }
+    }
+}

test/StaticAnalysis/ConcreteCallablePlugin.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LaminasTest\ServiceManager\StaticAnalysis;
+
+final class ConcreteCallablePlugin
+{
+    public function __invoke(): mixed
+    {
+        return null;
+    }
+}

test/StaticAnalysis/UnionPluginManager.php

@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LaminasTest\ServiceManager\StaticAnalysis;
+
+use Laminas\ServiceManager\AbstractPluginManager;
+use Laminas\ServiceManager\Exception\InvalidArgumentException;
+
+use function is_callable;
+
+/**
+ * `laminas-view` HelperPluginManager is providing either an object or a callable and thus needs to provide a union
+ * return type.
+ *
+ * @psalm-type CallableObjectType = object&callable
+ * @template-extends AbstractPluginManager<callable|CallableObjectType>
+ */
+final class UnionPluginManager extends AbstractPluginManager
+{
+    /**
+     * @return callable|CallableObjectType
+     */
+    public function getWhateverPlugin(array|null $options = null): callable|object
+    {
+        if ($options === null) {
+            return $this->get('foo');
+        }
+
+        return $this->build('foo', $options);
+    }
+
+    public function validateWhateverPlugin(mixed $plugin): callable|object
+    {
+        $this->validate($plugin);
+        return $plugin;
+    }
+
+    public function getConcretePlugin(): ConcreteCallablePlugin
+    {
+        return self::get(ConcreteCallablePlugin::class);
+    }
+
+    public function buildConcretePlugin(): ConcreteCallablePlugin
+    {
+        return self::build(ConcreteCallablePlugin::class);
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function validate(mixed $instance): void
+    {
+        if (! is_callable($instance)) {
+            throw new InvalidArgumentException('Provided instance is not callable.');
+        }
+    }
+}