HandlersService.php

Go to the documentation of this file.

<?php

namespace Elgg;

use Elgg\HooksRegistrationService\Event as HrsEvent;
use Elgg\HooksRegistrationService\Hook as HrsHook;
use Elgg\Traits\Loggable;

class HandlersService {
    
    use Loggable;
    
    protected const CLASS_NAME_PATTERN_53 = '/^(\\\\?[a-z_\x7f-\xff][a-z0-9_\x7f-\xff]*)+$/i';
    
    public function call($callable, $object, $args) {
        $original = $callable;

        $callable = $this->resolveCallable($callable);
        if (!is_callable($callable)) {
            $type = is_string($object) ? $object : $object::EVENT_TYPE;
            $description = $type . " [{$args[0]}, {$args[1]}]";

            $this->getLogger()->warning("Handler for {$description} is not callable: " . $this->describeCallable($original));

            return [false, null, $object];
        }

        if (is_string($object)) {
            switch ($object) {
                case 'hook' :
                    $object = new HrsHook(elgg(), $args[0], $args[1], $args[2], $args[3]);
                    break;

                case 'event' :
                    $object = new HrsEvent(elgg(), $args[0], $args[1], $args[2]);
                    break;

                case 'middleware' :
                case 'controller' :
                case 'action' :
                    $object = new Request(elgg(), $args[0]);
                    break;
            }
        }

        $result = call_user_func($callable, $object);

        return [true, $result, $object];
    }

    public function isCallable($callback) {
        $callback = $this->resolveCallable($callback);
        return $callback && is_callable($callback);
    }

    public function resolveCallable($callable) {
        if (is_callable($callable)) {
            return $callable;
        }

        if (is_string($callable)
            && preg_match(self::CLASS_NAME_PATTERN_53, $callable)
            && class_exists($callable)) {
            $callable = new $callable;
        }

        return is_callable($callable) ? $callable : null;
    }

    public function describeCallable($callable, $file_root = '') {
        if (is_string($callable)) {
            return $callable;
        }
        if (is_array($callable) && array_keys($callable) === [0, 1] && is_string($callable[1])) {
            if (is_string($callable[0])) {
                return "{$callable[0]}::{$callable[1]}";
            }
            return "(" . get_class($callable[0]) . ")->{$callable[1]}";
        }
        if ($callable instanceof \Closure) {
            $ref = new \ReflectionFunction($callable);
            $file = $ref->getFileName();
            $line = $ref->getStartLine();

            if ($file_root && 0 === strpos($file, $file_root)) {
                $file = substr($file, strlen($file_root));
            }

            return "(Closure {$file}:{$line})";
        }
        if (is_object($callable)) {
            return "(" . get_class($callable) . ")->__invoke()";
        }
        return print_r($callable, true);
    }
}