openvk/Web/Models/Entities/MediaCollection.php
Alexander Minkin 6ec54a379d
feat: add linting of code (#1220)
* feat(lint): add php-cs-fixer for linting

Removing previous CODE_STYLE as it was not enforced anyway and using PER-CS 2.0.

This is not the reformatting commit.

* style: format code according to PER-CS 2.0 with php-cs-fixer

* ci(actions): add lint action

Resolves #1132.
2025-01-31 18:20:13 +03:00

225 lines
5.7 KiB
PHP

<?php
declare(strict_types=1);
namespace openvk\Web\Models\Entities;
use Nette\Database\Table\ActiveRow;
use openvk\Web\Util\DateTime;
use openvk\Web\Models\RowModel;
use openvk\Web\Models\Repositories\Clubs;
use openvk\Web\Models\Repositories\Users;
use openvk\Web\Models\Repositories\Util\EntityStream;
use Chandler\Database\DatabaseConnection;
abstract class MediaCollection extends RowModel
{
use Traits\TOwnable;
protected $relTableName;
protected $entityTableName;
protected $entityClassName;
protected $allowDuplicates = true;
protected $specialNames = [];
protected $relations;
/**
* Maximum amount of items Collection can have
*/
public const MAX_ITEMS = INF;
/**
* Maximum amount of Collections with same "owner" allowed
*/
public const MAX_COUNT = INF;
public function __construct(?ActiveRow $ar = null)
{
parent::__construct($ar);
$this->relations = DatabaseConnection::i()->getContext()->table($this->relTableName);
}
private function entitySuitable(RowModel $entity): bool
{
if (($class = get_class($entity)) !== $this->entityClassName) {
throw new \UnexpectedValueException("This MediaCollection can only store '$this->entityClassName' (not '$class').");
}
return true;
}
public function getOwner(): RowModel
{
$oid = $this->getRecord()->owner;
if ($oid > 0) {
return (new Users())->get($oid);
} else {
return (new Clubs())->get($oid * -1);
}
}
public function getPrettyId(): string
{
return $this->getRecord()->owner . "_" . $this->getRecord()->id;
}
public function getName(): string
{
$special = $this->getRecord()->special_type;
if ($special === 0) {
return $this->getRecord()->name;
}
$sName = $this->specialNames[$special];
if (!$sName) {
return $this->getRecord()->name;
}
if ($sName[0] === "_") {
$sName = tr(substr($sName, 1));
}
return $sName;
}
public function getDescription(): ?string
{
return $this->getRecord()->description;
}
abstract public function getCoverURL(): ?string;
public function fetchClassic(int $offset = 0, ?int $limit = null): \Traversable
{
$related = $this->getRecord()->related("$this->relTableName.collection")
->limit($limit ?? OPENVK_DEFAULT_PER_PAGE, $offset)
->order("media ASC");
foreach ($related as $rel) {
$media = $rel->ref($this->entityTableName, "media");
if (!$media) {
continue;
}
yield new $this->entityClassName($media);
}
}
public function fetch(int $page = 1, ?int $perPage = null): \Traversable
{
$page = max(1, $page);
$perPage ??= OPENVK_DEFAULT_PER_PAGE;
return $this->fetchClassic($perPage * ($page - 1), $perPage);
}
public function size(): int
{
return sizeof($this->getRecord()->related("$this->relTableName.collection"));
}
public function getCreationTime(): DateTime
{
return new DateTime($this->getRecord()->created);
}
public function getPublicationTime(): DateTime
{
return $this->getCreationTime();
}
public function getEditTime(): ?DateTime
{
$edited = $this->getRecord()->edited;
if (is_null($edited)) {
return null;
}
return new DateTime($edited);
}
public function isCreatedBySystem(): bool
{
return $this->getRecord()->special_type !== 0;
}
public function add(RowModel $entity): bool
{
$this->entitySuitable($entity);
if (!$this->allowDuplicates) {
if ($this->has($entity)) {
return false;
}
}
if (self::MAX_ITEMS != INF) {
if (sizeof($this->relations->where("collection", $this->getId())) > self::MAX_ITEMS) {
throw new \OutOfBoundsException("Collection is full");
}
}
$this->relations->insert([
"collection" => $this->getId(),
"media" => $entity->getId(),
]);
return true;
}
public function remove(RowModel $entity): bool
{
$this->entitySuitable($entity);
return $this->relations->where([
"collection" => $this->getId(),
"media" => $entity->getId(),
])->delete() > 0;
}
public function has(RowModel $entity): bool
{
$this->entitySuitable($entity);
$rel = $this->relations->where([
"collection" => $this->getId(),
"media" => $entity->getId(),
])->fetch();
return !is_null($rel);
}
public function save(?bool $log = false): void
{
$thisTable = DatabaseConnection::i()->getContext()->table($this->tableName);
if (self::MAX_COUNT != INF) {
if (isset($this->changes["owner"])) {
if (sizeof($thisTable->where("owner", $this->changes["owner"])) > self::MAX_COUNT) {
throw new \OutOfBoundsException("Maximum amount of collections");
}
}
}
if (is_null($this->getRecord())) {
if (!isset($this->changes["created"])) {
$this->stateChanges("created", time());
} else {
$this->stateChanges("edited", time());
}
}
parent::save($log);
}
public function delete(bool $softly = true): void
{
if (!$softly) {
$this->relations->where("collection", $this->getId())
->delete();
}
parent::delete($softly);
}
}