type = $type; $this->adapter = $adapter; $this->media = new ArrayCollection(); } public function getId(): ?int { return $this->id; } public function getType(): string { return $this->type; } public function getAdapter(): string { return $this->adapter; } public function getPath(): ?string { return $this->path; } public function getFilteredPath(): ?string { return match ($this->adapter) { self::ADAPTER_S3, self::ADAPTER_DROPBOX => trim($this->path, '/'), default => rtrim($this->path, '/') }; } public function applyPath(?string $suffix = null): string { $suffix = (null !== $suffix) ? '/' . ltrim($suffix, '/') : ''; return $this->path . $suffix; } public function setPath(?string $path): void { $this->path = $this->truncateString($path); } public function getS3CredentialKey(): ?string { return $this->s3CredentialKey; } public function setS3CredentialKey(?string $s3CredentialKey): void { $this->s3CredentialKey = $this->truncateString($s3CredentialKey); } public function getS3CredentialSecret(): ?string { return $this->s3CredentialSecret; } public function setS3CredentialSecret(?string $s3CredentialSecret): void { $this->s3CredentialSecret = $this->truncateString($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->truncateString($s3Endpoint); } public function getDropboxAuthToken(): ?string { return $this->dropboxAuthToken; } public function setDropboxAuthToken(?string $dropboxAuthToken): void { $this->dropboxAuthToken = $dropboxAuthToken; } public function isLocal(): bool { return self::ADAPTER_LOCAL === $this->adapter; } public function getStorageQuota(): ?string { $raw_quota = $this->getStorageQuotaBytes(); return ($raw_quota instanceof BigInteger) ? Quota::getReadableSize($raw_quota) : ''; } /** * @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 { $raw_size = $this->getStorageUsedBytes(); return Quota::getReadableSize($raw_size); } /** * @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; } $currentStorageUsed = $this->getStorageUsedBytes(); $storageUsed = $currentStorageUsed->minus($amountToRemove); if ($storageUsed->isLessThan(0)) { $storageUsed = BigInteger::zero(); } $this->storageUsed = (string)$storageUsed; } public function getStorageAvailable(): string { $raw_size = $this->getRawStorageAvailable(); return ($raw_size instanceof BigInteger) ? Quota::getReadableSize($raw_size) : ''; } public function getRawStorageAvailable(): ?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->getRawStorageAvailable(); if ($available === null) { return false; } $used = $this->getStorageUsedBytes(); return ($used->compareTo($available) !== -1); } public function getStorageUsePercentage(): int { $storageUsed = $this->getStorageUsedBytes(); $storageAvailable = $this->getRawStorageAvailable(); if (null === $storageAvailable) { return 0; } return Quota::getPercentage($storageUsed, $storageAvailable); } /** * @return Collection|StationMedia[] */ public function getMedia(): Collection { return $this->media; } public function getUri(?string $suffix = null): string { $path = $this->applyPath($suffix); return match ($this->adapter) { self::ADAPTER_S3 => $this->getS3ObjectUri($suffix), self::ADAPTER_DROPBOX => 'dropbox://' . $this->dropboxAuthToken . ltrim($path, '/'), default => $path, }; } protected function getS3ObjectUri(?string $suffix = null): string { $path = $this->applyPath($suffix); try { $client = $this->getS3Client(); if (empty($path)) { $objectUrl = $client->getObjectUrl($this->s3Bucket, '/'); return rtrim($objectUrl, '/'); } return $client->getObjectUrl($this->s3Bucket, ltrim($path, '/')); } catch (InvalidArgumentException $e) { return 'Invalid URI (' . $e->getMessage() . ')'; } } public function validate(): void { if (self::ADAPTER_S3 === $this->adapter) { $client = $this->getS3Client(); $client->listObjectsV2( [ 'Bucket' => $this->s3Bucket, 'max-keys' => 1, ] ); } $adapter = $this->getStorageAdapter(); $adapter->fileExists('/test'); } public function getStorageAdapter(): ExtendedAdapterInterface { $filteredPath = $this->getFilteredPath(); return match ($this->adapter) { self::ADAPTER_S3 => new AwsS3Adapter($this->getS3Client(), $this->s3Bucket, $filteredPath), self::ADAPTER_DROPBOX => new DropboxAdapter($this->getDropboxClient(), $filteredPath), default => new LocalFilesystemAdapter($filteredPath) }; } protected function getS3Client(): S3Client { if (self::ADAPTER_S3 !== $this->adapter) { throw new InvalidArgumentException('This storage location is not using the S3 adapter.'); } $s3Options = array_filter( [ 'credentials' => [ 'key' => $this->s3CredentialKey, 'secret' => $this->s3CredentialSecret, ], 'region' => $this->s3Region, 'version' => $this->s3Version, 'endpoint' => $this->s3Endpoint, ] ); return new S3Client($s3Options); } protected function getDropboxClient(): Client { if (self::ADAPTER_DROPBOX !== $this->adapter) { throw new InvalidArgumentException('This storage location is not using the Dropbox adapter.'); } return new Client($this->dropboxAuthToken); } public function getFilesystem(): ExtendedFilesystemInterface { $adapter = $this->getStorageAdapter(); return ($adapter instanceof LocalAdapterInterface) ? new LocalFilesystem($adapter) : new RemoteFilesystem($adapter); } public function __toString(): string { $adapterNames = [ self::ADAPTER_LOCAL => 'Local', self::ADAPTER_S3 => 'S3', self::ADAPTER_DROPBOX => 'Dropbox', ]; return $adapterNames[$this->adapter] . ': ' . $this->getUri(); } }