Method getDownloadInfo

src/FileRise/Domain/FileModel.php:1332–1457

* Validates and retrieves information needed to download a file. * * @param string $folder The folder from which to download (e.g., "root" or a subfolder). * @param string $file The file name. * @return array An associative array with "error" key on failure, * or "filePath" and "mimeType" keys on success. */

($folder, $file)

     *               or "filePath" and "mimeType" keys on success.
     */
    public static function getDownloadInfo($folder, $file)
    {
        $storage = self::storage();
        $isLocal = $storage->isLocal();
        $root = self::uploadRoot();

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

        if (!$isLocal) {
            // Remote adapter path resolution (no realpath).
            if (strtolower($folder) !== 'root' && trim($folder) !== '') {
                if (strpos($folder, '..') !== false) {
                    return ["error" => "Invalid folder name."];
                }
                $parts = explode('/', trim((string)$folder, "/\\ "));
                foreach ($parts as $part) {
                    if ($part === '' || !preg_match(REGEX_FOLDER_NAME, $part)) {
                        return ["error" => "Invalid folder name."];
                    }
                }
                $directory = rtrim($root, '/\\') . DIRECTORY_SEPARATOR . trim($folder, "/\\ ");
            } else {
                $directory = rtrim($root, '/\\');
            }

            $filePath = $directory . DIRECTORY_SEPARATOR . $file;
            $stat = $storage->stat($filePath);
            if ($stat === null || ($stat['type'] ?? '') !== 'file') {
                $probe = $storage->openReadStream($filePath, 1, 0);
                if ($probe === false) {
                    return ["error" => "File not found."];
                }
                if (is_resource($probe)) {
                    @fclose($probe);
                } elseif (is_object($probe) && method_exists($probe, 'close')) {
                    $probe->close();
                }
                $stat = [
                    'type' => 'file',
                    'size' => 0,
                ];
            }

            $downloadName = $file;
            $downloadExt = $stat['downloadExt'] ?? '';
            if (is_string($downloadExt)) {
                $downloadExt = ltrim($downloadExt, '.');
                if ($downloadExt !== '') {
                    $suffix = '.' . strtolower($downloadExt);
                    if (!str_ends_with(strtolower($downloadName), $suffix)) {
                        $downloadName .= '.' . $downloadExt;
                    }
                }
            }