EntityPreloader.php

Go to the documentation of this file.

<?php

namespace Elgg;

use Elgg\Database\EntityTable;
use Elgg\Database\Entities;
use Elgg\Cache\EntityCache;

class EntityPreloader {

    public $_callable_cache_checker;

    public $_callable_entity_loader;

    public function __construct(EntityTable $entity_table) {
        $this->_callable_cache_checker = function ($guid) use ($entity_table) {
            return $entity_table->getFromCache($guid);
        };
        $this->_callable_entity_loader = function ($options) {
            return Entities::find($options);
        };
    }

    public function preload($objects, array $guid_properties) {
        $guids = $this->getGuidsToLoad($objects, $guid_properties);
        
        // 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, [
                'guids' => $guids,
                'limit' => EntityCache::MAX_SIZE,
                'order_by' => false,
            ]);
        }
    }

    protected function getGuidsToLoad($objects, array $guid_properties) {
        if (!is_array($objects) || count($objects) < 2) {
            return [];
        }
        
        $preload_guids = [];
        foreach ($objects as $object) {
            if (is_object($object)) {
                foreach ($guid_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);
    }
}