99 lines
2.2 KiB
PHP
99 lines
2.2 KiB
PHP
<?php
|
|
|
|
namespace Friendica;
|
|
|
|
/**
|
|
* The Collection classes inheriting from this abstract class are meant to represent a list of database record.
|
|
* The associated model class has to be provided in the child classes.
|
|
*
|
|
* Collections can be used with foreach(), accessed like an array and counted.
|
|
*/
|
|
abstract class BaseCollection extends \ArrayIterator
|
|
{
|
|
/**
|
|
* This property is used with paginated results to hold the total number of items satisfying the paginated request.
|
|
* @var int
|
|
*/
|
|
protected $totalCount = 0;
|
|
|
|
/**
|
|
* @param BaseModel[] $models
|
|
* @param int|null $totalCount
|
|
*/
|
|
public function __construct(array $models = [], int $totalCount = null)
|
|
{
|
|
parent::__construct($models);
|
|
|
|
$this->totalCount = $totalCount ?? count($models);
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function offsetSet($offset, $value)
|
|
{
|
|
if (is_null($offset)) {
|
|
$this->totalCount++;
|
|
}
|
|
|
|
parent::offsetSet($offset, $value);
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function offsetUnset($offset)
|
|
{
|
|
if ($this->offsetExists($offset)) {
|
|
$this->totalCount--;
|
|
}
|
|
|
|
parent::offsetUnset($offset);
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function getTotalCount()
|
|
{
|
|
return $this->totalCount;
|
|
}
|
|
|
|
/**
|
|
* Return the values from a single field in the collection
|
|
*
|
|
* @param string $column
|
|
* @param int|null $index_key
|
|
* @return array
|
|
* @see array_column()
|
|
*/
|
|
public function column($column, $index_key = null)
|
|
{
|
|
return array_column($this->getArrayCopy(), $column, $index_key);
|
|
}
|
|
|
|
/**
|
|
* Apply a callback function on all elements in the collection and returns a new collection with the updated elements
|
|
*
|
|
* @param callable $callback
|
|
* @return BaseCollection
|
|
* @see array_map()
|
|
*/
|
|
public function map(callable $callback)
|
|
{
|
|
return new static(array_map($callback, $this->getArrayCopy()), $this->getTotalCount());
|
|
}
|
|
|
|
/**
|
|
* Filters the collection based on a callback that returns a boolean whether the current item should be kept.
|
|
*
|
|
* @param callable|null $callback
|
|
* @param int $flag
|
|
* @return BaseCollection
|
|
* @see array_filter()
|
|
*/
|
|
public function filter(callable $callback = null, int $flag = 0)
|
|
{
|
|
return new static(array_filter($this->getArrayCopy(), $callback, $flag));
|
|
}
|
|
}
|