AzuraCast/src/Entity/StorageLocation.php

482 lines
13 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Entity;
use App\Entity\Enums\StorageLocationAdapters;
use App\Entity\Enums\StorageLocationTypes;
use App\Entity\Interfaces\IdentifiableEntityInterface;
use App\Exception\StorageLocationFullException;
use App\Radio\Quota;
use App\Validator\Constraints as AppAssert;
use Brick\Math\BigInteger;
use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;
use Doctrine\ORM\Mapping as ORM;
use Stringable;
use Symfony\Component\Filesystem\Path;
#[
ORM\Entity,
ORM\Table(name: 'storage_location'),
Attributes\Auditable,
AppAssert\StorageLocation
]
class StorageLocation implements Stringable, IdentifiableEntityInterface
{
use Traits\HasAutoIncrementId;
use Traits\TruncateStrings;
public const DEFAULT_BACKUPS_PATH = '/var/azuracast/backups';
#[ORM\Column(type: 'string', length: 50, enumType: StorageLocationTypes::class)]
protected StorageLocationTypes $type;
#[ORM\Column(type: 'string', length: 50, enumType: StorageLocationAdapters::class)]
protected StorageLocationAdapters $adapter;
#[ORM\Column(length: 255, nullable: false)]
protected string $path = '';
#[ORM\Column(name: 's3_credential_key', length: 255, nullable: true)]
protected ?string $s3CredentialKey = null;
#[ORM\Column(name: 's3_credential_secret', length: 255, nullable: true)]
protected ?string $s3CredentialSecret = null;
#[ORM\Column(name: 's3_region', length: 150, nullable: true)]
protected ?string $s3Region = null;
#[ORM\Column(name: 's3_version', length: 150, nullable: true)]
protected ?string $s3Version = 'latest';
#[ORM\Column(name: 's3_bucket', length: 255, nullable: true)]
protected ?string $s3Bucket = null;
#[ORM\Column(name: 's3_endpoint', length: 255, nullable: true)]
protected ?string $s3Endpoint = null;
#[ORM\Column(name: 'dropbox_app_key', length: 50, nullable: true)]
protected ?string $dropboxAppKey = null;
#[ORM\Column(name: 'dropbox_app_secret', length: 150, nullable: true)]
protected ?string $dropboxAppSecret = null;
#[ORM\Column(name: 'dropbox_auth_token', length: 255, nullable: true)]
protected ?string $dropboxAuthToken = null;
#[ORM\Column(name: 'dropbox_refresh_token', length: 255, nullable: true)]
protected ?string $dropboxRefreshToken = null;
#[ORM\Column(name: 'sftp_host', length: 255, nullable: true)]
protected ?string $sftpHost = null;
#[ORM\Column(name: 'sftp_username', length: 255, nullable: true)]
protected ?string $sftpUsername = null;
#[ORM\Column(name: 'sftp_password', length: 255, nullable: true)]
protected ?string $sftpPassword = null;
#[ORM\Column(name: 'sftp_port', nullable: true)]
protected ?int $sftpPort = null;
#[ORM\Column(name: 'sftp_private_key', type: 'text', nullable: true)]
protected ?string $sftpPrivateKey = null;
#[ORM\Column(name: 'sftp_private_key_pass_phrase', length: 255, nullable: true)]
protected ?string $sftpPrivateKeyPassPhrase = null;
#[ORM\Column(name: 'storage_quota', type: 'bigint', nullable: true)]
protected ?string $storageQuota = null;
#[ORM\Column(name: 'storage_used', type: 'bigint', nullable: true)]
#[Attributes\AuditIgnore]
protected ?string $storageUsed = null;
/** @var Collection<int, StationMedia> */
#[ORM\OneToMany(mappedBy: 'storage_location', targetEntity: StationMedia::class)]
protected Collection $media;
public function __construct(
StorageLocationTypes $type,
StorageLocationAdapters $adapter
) {
$this->type = $type;
$this->adapter = $adapter;
$this->media = new ArrayCollection();
}
public function getType(): StorageLocationTypes
{
return $this->type;
}
public function getAdapter(): StorageLocationAdapters
{
return $this->adapter;
}
public function getPath(): string
{
return $this->path;
}
public function setPath(string $path): void
{
$this->path = $this->truncateString(
Path::canonicalize($path)
);
}
public function getS3CredentialKey(): ?string
{
return $this->s3CredentialKey;
}
public function setS3CredentialKey(?string $s3CredentialKey): void
{
$this->s3CredentialKey = $this->truncateNullableString($s3CredentialKey);
}
public function getS3CredentialSecret(): ?string
{
return $this->s3CredentialSecret;
}
public function setS3CredentialSecret(?string $s3CredentialSecret): void
{
$this->s3CredentialSecret = $this->truncateNullableString($s3CredentialSecret);
}
public function getS3Region(): ?string
{
return $this->s3Region;
}
public function setS3Region(?string $s3Region): void
{
$this->s3Region = $s3Region;
}
public function getS3Version(): ?string
{
return $this->s3Version;
}
public function setS3Version(?string $s3Version): void
{
$this->s3Version = $s3Version;
}
public function getS3Bucket(): ?string
{
return $this->s3Bucket;
}
public function setS3Bucket(?string $s3Bucket): void
{
$this->s3Bucket = $s3Bucket;
}
public function getS3Endpoint(): ?string
{
return $this->s3Endpoint;
}
public function setS3Endpoint(?string $s3Endpoint): void
{
$this->s3Endpoint = $this->truncateNullableString($s3Endpoint);
}
public function getDropboxAppKey(): ?string
{
return $this->dropboxAppKey;
}
public function setDropboxAppKey(?string $dropboxAppKey): void
{
$this->dropboxAppKey = $dropboxAppKey;
}
public function getDropboxAppSecret(): ?string
{
return $this->dropboxAppSecret;
}
public function setDropboxAppSecret(?string $dropboxAppSecret): void
{
$this->dropboxAppSecret = $dropboxAppSecret;
}
public function getDropboxAuthToken(): ?string
{
return $this->dropboxAuthToken;
}
public function setDropboxAuthToken(?string $dropboxAuthToken): void
{
$this->dropboxAuthToken = $dropboxAuthToken;
}
public function getDropboxRefreshToken(): ?string
{
return $this->dropboxRefreshToken;
}
public function setDropboxRefreshToken(?string $dropboxRefreshToken): void
{
$this->dropboxRefreshToken = $dropboxRefreshToken;
}
public function getSftpHost(): ?string
{
return $this->sftpHost;
}
public function setSftpHost(?string $sftpHost): void
{
$this->sftpHost = $sftpHost;
}
public function getSftpUsername(): ?string
{
return $this->sftpUsername;
}
public function setSftpUsername(?string $sftpUsername): void
{
$this->sftpUsername = $sftpUsername;
}
public function getSftpPassword(): ?string
{
return $this->sftpPassword;
}
public function setSftpPassword(?string $sftpPassword): void
{
$this->sftpPassword = $sftpPassword;
}
public function getSftpPort(): ?int
{
return $this->sftpPort;
}
public function setSftpPort(?int $sftpPort): void
{
$this->sftpPort = $sftpPort;
}
public function getSftpPrivateKey(): ?string
{
return $this->sftpPrivateKey;
}
public function setSftpPrivateKey(?string $sftpPrivateKey): void
{
$this->sftpPrivateKey = $sftpPrivateKey;
}
public function getSftpPrivateKeyPassPhrase(): ?string
{
return $this->sftpPrivateKeyPassPhrase;
}
public function setSftpPrivateKeyPassPhrase(?string $sftpPrivateKeyPassPhrase): void
{
$this->sftpPrivateKeyPassPhrase = $sftpPrivateKeyPassPhrase;
}
public function isLocal(): bool
{
return $this->getAdapter()->isLocal();
}
public function getStorageQuota(): ?string
{
$rawQuota = $this->getStorageQuotaBytes();
return ($rawQuota instanceof BigInteger)
? Quota::getReadableSize($rawQuota)
: '';
}
/**
* @param string|BigInteger|null $storageQuota
*/
public function setStorageQuota(BigInteger|string|null $storageQuota): void
{
$storageQuota = (string)Quota::convertFromReadableSize($storageQuota);
$this->storageQuota = !empty($storageQuota) ? $storageQuota : null;
}
public function getStorageQuotaBytes(): ?BigInteger
{
$size = $this->storageQuota;
return (null !== $size && '' !== $size)
? BigInteger::of($size)
: null;
}
public function getStorageUsed(): ?string
{
$rawSize = $this->getStorageUsedBytes();
return Quota::getReadableSize($rawSize);
}
/**
* @param string|BigInteger|null $storageUsed
*/
public function setStorageUsed(BigInteger|string|null $storageUsed): void
{
$storageUsed = (string)Quota::convertFromReadableSize($storageUsed);
$this->storageUsed = !empty($storageUsed) ? $storageUsed : null;
}
public function getStorageUsedBytes(): BigInteger
{
$size = $this->storageUsed;
return (null !== $size && '' !== $size)
? BigInteger::of($size)
: BigInteger::zero();
}
/**
* Increment the current used storage total.
*
* @param int|string|BigInteger $newStorageAmount
*/
public function addStorageUsed(BigInteger|int|string $newStorageAmount): void
{
if (empty($newStorageAmount)) {
return;
}
$currentStorageUsed = $this->getStorageUsedBytes();
$this->storageUsed = (string)$currentStorageUsed->plus($newStorageAmount);
}
/**
* Decrement the current used storage total.
*
* @param int|string|BigInteger $amountToRemove
*/
public function removeStorageUsed(BigInteger|int|string $amountToRemove): void
{
if (empty($amountToRemove)) {
return;
}
$storageUsed = $this->getStorageUsedBytes()->minus($amountToRemove);
if ($storageUsed->isLessThan(0)) {
$storageUsed = BigInteger::zero();
}
$this->storageUsed = (string)$storageUsed;
}
public function getStorageAvailable(): string
{
$rawSize = $this->getStorageAvailableBytes();
return ($rawSize instanceof BigInteger)
? Quota::getReadableSize($rawSize)
: '';
}
public function getStorageAvailableBytes(): ?BigInteger
{
$quota = $this->getStorageQuotaBytes();
if ($this->isLocal()) {
$localPath = $this->getPath();
$totalSpaceFloat = disk_total_space($localPath);
if (is_float($totalSpaceFloat)) {
$totalSpace = BigInteger::of($totalSpaceFloat);
if (null === $quota || $quota->isGreaterThan($totalSpace)) {
return $totalSpace;
}
}
}
return $quota ?? null;
}
public function isStorageFull(): bool
{
$available = $this->getStorageAvailableBytes();
if ($available === null) {
return false;
}
$used = $this->getStorageUsedBytes();
return ($used->compareTo($available) !== -1);
}
public function canHoldFile(BigInteger|int|string $size): bool
{
if (empty($size)) {
return true;
}
$available = $this->getStorageAvailableBytes();
if ($available === null) {
return true;
}
$newStorageUsed = $this->getStorageUsedBytes()->plus($size);
return ($newStorageUsed->compareTo($available) === -1);
}
public function errorIfFull(): void
{
if ($this->isStorageFull()) {
throw new StorageLocationFullException();
}
}
public function getStorageUsePercentage(): int
{
$storageUsed = $this->getStorageUsedBytes();
$storageAvailable = $this->getStorageAvailableBytes();
if (null === $storageAvailable) {
return 0;
}
return Quota::getPercentage($storageUsed, $storageAvailable);
}
/**
* @return Collection<int, StationMedia>
*/
public function getMedia(): Collection
{
return $this->media;
}
public function getUri(?string $suffix = null): string
{
$adapterClass = $this->getAdapter()->getAdapterClass();
return $adapterClass::getUri($this, $suffix);
}
public function getFilteredPath(): string
{
$adapterClass = $this->getAdapter()->getAdapterClass();
return $adapterClass::filterPath($this->path);
}
public function __toString(): string
{
return $this->getAdapter()->getName() . ': ' . $this->getUri();
}
}