FileInfo.php

См. документацию.

<?php
 
namespace Bitrix\UI\FileUploader;
 
use Bitrix\Main\Type\Dictionary;
 
class FileInfo extends FileData implements \JsonSerializable
{
    protected $id;
    protected int $fileId = 0;
    protected bool $treatImageAsFile = false;
    protected ?string $downloadUrl = null;
    protected ?string $previewUrl = null;
    protected int $previewWidth = 0;
    protected int $previewHeight = 0;
    protected ?Dictionary $customData = null;
    protected ?Dictionary $viewerAttrs = null;

    public function __construct($id, string $name, string $contentType, int $size)
    {
        parent::__construct($name, $contentType, $size);
        $this->id = $id;
    }
 
    public static function createFromBFile(int $id): ?FileInfo
    {
        $file = \CFile::getFileArray($id);
        if (!is_array($file))
        {
            return null;
        }
 
        $fileName = !empty($file['ORIGINAL_NAME']) ? $file['ORIGINAL_NAME'] : $file['FILE_NAME'];
        $fileInfo = new static($id, $fileName, $file['CONTENT_TYPE'], (int)$file['FILE_SIZE']);
        $fileInfo->setWidth($file['WIDTH']);
        $fileInfo->setHeight($file['HEIGHT']);
        $fileInfo->setFileId($id);
 
        return $fileInfo;
    }
 
    public static function createFromTempFile(string $tempFileId): ?FileInfo
    {
        [$guid, $signature] = explode('.', $tempFileId);
 
        $tempFile = TempFileTable::getList([
            'filter' => [
                '=GUID' => $guid,
                '=UPLOADED' => true,
            ],
        ])->fetchObject();
 
        if (!$tempFile)
        {
            return null;
        }
 
        $fileInfo = new static($tempFileId, $tempFile->getFilename(), $tempFile->getMimetype(), $tempFile->getSize());
        $fileInfo->setWidth($tempFile->getWidth());
        $fileInfo->setHeight($tempFile->getHeight());
        $fileInfo->setFileId($tempFile->getFileId());
 
        return $fileInfo;
    }

    public function getId()
    {
        return $this->id;
    }
 
    public function setId($id): void
    {
        if (is_int($id) || is_string($id))
        {
            $this->id = $id;
        }
    }
 
    public function getFileId(): int
    {
        return $this->fileId;
    }
 
    public function setFileId(int $fileId): void
    {
        $this->fileId = $fileId;
    }
 
    public function shouldTreatImageAsFile(): bool
    {
        return $this->treatImageAsFile;
    }
 
    public function setTreatImageAsFile(bool $flag): void
    {
        $this->treatImageAsFile = $flag;
    }
 
    public function getDownloadUrl(): ?string
    {
        return $this->downloadUrl;
    }
 
    public function setDownloadUrl(string $downloadUrl): void
    {
        $this->downloadUrl = $downloadUrl;
    }
 
    public function getPreviewUrl(): ?string
    {
        return $this->previewUrl;
    }
 
    public function setPreviewUrl(string $previewUrl, int $previewWidth, int $previewHeight): void
    {
        $this->previewUrl = $previewUrl;
        $this->previewWidth = $previewWidth;
        $this->previewHeight = $previewHeight;
    }
 
    public function getPreviewWidth(): int
    {
        return $this->previewWidth;
    }
 
    public function getPreviewHeight(): int
    {
        return $this->previewHeight;
    }
 
    public function setCustomData(array $customData): self
    {
        $this->getCustomData()->setValues($customData);
 
        return $this;
    }

    public function getCustomData(): Dictionary
    {
        if ($this->customData === null)
        {
            $this->customData = new Dictionary();
        }
 
        return $this->customData;
    }
 
    public function setViewerAttrs(array $viewerAttrs): self
    {
        $this->getViewerAttrs()->setValues($viewerAttrs);
 
        return $this;
    }
 
    public function getViewerAttrs(): Dictionary
    {
        if ($this->viewerAttrs === null)
        {
            $this->viewerAttrs = new Dictionary();
        }
 
        return $this->viewerAttrs;
    }
 
    public function jsonSerialize(): array
    {
        return [
            'serverFileId' => $this->getId(),
            'serverId' => $this->getId(), // compatibility
            'type' => $this->getContentType(),
            'name' => $this->getName(),
            'size' => $this->getSize(),
            'width' => $this->getWidth(),
            'height' => $this->getHeight(),
            'isImage' => $this->isImage(),
            'isVideo' => $this->isVideo(),
            'treatImageAsFile' => $this->isImage() && $this->shouldTreatImageAsFile(),
            'downloadUrl' => $this->getDownloadUrl(),
            'serverPreviewUrl' => $this->getPreviewUrl(),
            'serverPreviewWidth' => $this->getPreviewWidth(),
            'serverPreviewHeight' => $this->getPreviewHeight(),
            'customData' => $this->customData !== null ? $this->getCustomData()->getValues() : [],
            'viewerAttrs' => $this->viewerAttrs !== null ? $this->getViewerAttrs()->getValues() : [],
        ];
    }
}