feat: add exception MissingMethodException

Author: efureev

CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog][keepachangelog] and this project adheres to [Semantic Versioning][semver].
 
+## v4.7.0
+
+### Added
+
+- Add exception `MissingMethodException`
+- Add global function `remoteStaticCallOrTrow`
+
 ## v4.6.0
 
 ### Added

src/Exceptions/MissingMethodException.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Php\Support\Exceptions;
+
+use BadMethodCallException;
+use Php\Support\Traits\Thrower;
+
+class MissingMethodException extends BadMethodCallException
+{
+    use Thrower;
+
+    public function __construct(protected ?string $method = null, string $message = null)
+    {
+        parent::__construct(
+            $message ??
+            ($this->getName() . ($this->method ? ': "' . $this->method . '"' : ''))
+        );
+    }
+
+    /**
+     * @return string
+     */
+    public function getName(): string
+    {
+        return 'Missing method';
+    }
+
+    /**
+     * @return null|string
+     */
+    public function getMethod(): ?string
+    {
+        return $this->method;
+    }
+}

src/Global/base.php

@@ -198,6 +198,33 @@ function remoteStaticCall(object|string|null $class, string $method, mixed ...$p
     }
 }
 
+if (!function_exists('remoteStaticCall')) {
+    /**
+     * Returns result of an object's method if it exists in the object or trow exception.
+     *
+     * @param string|object|null $class
+     * @param string $method
+     * @param mixed ...$params
+     *
+     * @return mixed
+     */
+    function remoteStaticCallOrTrow(object|string|null $class, string $method, mixed ...$params): mixed
+    {
+        if (!$class) {
+            throw new RuntimeException('Target Class is absent');
+        }
+
+        if (
+            (is_object($class) || (is_string($class) && class_exists($class))) &&
+            method_exists($class, $method)
+        ) {
+            return $class::$method(...$params);
+        }
+
+        \Php\Support\Exceptions\MissingMethodException::throw("$class::$method");
+    }
+}
+
 if (!function_exists('remoteCall')) {
     /**
      * Returns result of an object's method if it exists in the object.