EntityPreloader.php

Go to the documentation of this file.

<?php

namespace Elgg;

class EntityPreloader {

    protected $properties;

    public function __construct(array $guid_properties) {
        $this->properties = $guid_properties;
    }

    public function preload($objects) {
        $guids = $this->getGuidsToLoad($objects);
        // If only 1 to load, not worth the overhead of elgg_get_entities(),
        // get_entity() will handle it later.
        if (count($guids) > 1) {
            call_user_func($this->_callable_entity_loader, array(
                'guids' => $guids,
            ));
        }
    }

    protected function getGuidsToLoad($objects) {
        if (!is_array($objects) || count($objects) < 2) {
            return array();
        }
        $preload_guids = array();
        foreach ($objects as $object) {
            if (is_object($object)) {
                foreach ($this->properties as $property) {
                    if (empty($object->{$property})) {
                        continue;
                    }
                    $guid = $object->{$property};
                    if ($guid && !call_user_func($this->_callable_cache_checker, $guid)) {
                        $preload_guids[] = $guid;
                    }
                }
            }
        }
        return array_unique($preload_guids);
    }

    public $_callable_cache_checker = '_elgg_retrieve_cached_entity';

    public $_callable_entity_loader = 'elgg_get_entities';
}