Method createAuthFileLink

src/FileRise/Domain/FileModel.php:2880–2939

(
        string $folder,
        string $file,
        string $sourceId = '',
        string $createdBy = '',
        ?int $expiresAt = null
    )

    }

    public static function createAuthFileLink(
        string $folder,
        string $file,
        string $sourceId = '',
        string $createdBy = '',
        ?int $expiresAt = null
    ): array {
        if (strtolower($folder) !== 'root' && !preg_match(REGEX_FOLDER_NAME, $folder)) {
            return ['error' => 'Invalid folder name.'];
        }

        $file = basename(trim($file));
        if (!preg_match(REGEX_FILE_NAME, $file)) {
            return ['error' => 'Invalid file name.'];
        }

        $sourceId = trim($sourceId);
        if ($sourceId !== '' && !preg_match('/^[A-Za-z0-9_-]{1,64}$/', $sourceId)) {
            $sourceId = '';
        }

        $expiresAtInt = $expiresAt ? (int)$expiresAt : 0;
        if ($expiresAtInt < 0) {
            $expiresAtInt = 0;
        }

        $createdBy = trim($createdBy);
        $createdBy = preg_replace('/[\x00-\x1F\x7F]/', '', $createdBy);
        $createdAt = time();
        $token = bin2hex(random_bytes(32));

        $path = self::authFileLinksPathForMetaRoot(self::metaRoot());
        $links = self::readAuthFileLinks($path);
        $links = self::cleanAuthFileLinks($links, $createdAt);
        while (isset($links[$token])) {
            $token = bin2hex(random_bytes(32));
        }

        $record = [
            'folder' => $folder,
            'file' => $file,
            'path' => ($folder === 'root') ? $file : ($folder . '/' . $file),
            'sourceId' => $sourceId,
            'createdBy' => is_string($createdBy) ? $createdBy : '',
            'createdAt' => $createdAt,
        ];
        if ($expiresAtInt > 0) {
            $record['expiresAt'] = $expiresAtInt;
        }
        $links[$token] = $record;

        if (file_put_contents($path, json_encode($links, JSON_PRETTY_PRINT), LOCK_EX) === false) {
            return ['error' => 'Could not save auth file link.'];
        }

        return [
            'token' => $token,
            'expiresAt' => $expiresAtInt > 0 ? $expiresAtInt : null,