Method getFileList

src/FileRise/Domain/FileModel.php:3582–3928

* Retrieves the list of files in a given folder, enriched with metadata, along with global tags. * * @param string $folder The folder name (e.g., "root" or a subfolder). * @return array Returns an associative array with keys "files" and "globalTags". */

(string $folder, array $options = [])

     * @return array Returns an associative array with keys "files" and "globalTags".
     */
    public static function getFileList(string $folder, array $options = []): array
    {
        // --- caps for safe inlining ---
        if (!defined('LISTING_CONTENT_BYTES_MAX')) {
            define('LISTING_CONTENT_BYTES_MAX', 8192);          // 8 KB snippet
        }
        if (!defined('INDEX_TEXT_BYTES_MAX')) {
            define('INDEX_TEXT_BYTES_MAX', 5 * 1024 * 1024);     // only sample files ≤ 5 MB
        }

        $includeContent = !empty($options['includeContent']);
        $pageSizeRaw = isset($options['pageSize']) ? (int)$options['pageSize'] : 0;
        $pageSize = ($pageSizeRaw > 0) ? max(1, min(500, $pageSizeRaw)) : 0;
        $cursorRaw = isset($options['cursor']) ? trim((string)$options['cursor']) : '';
        $cursorOffset = (ctype_digit($cursorRaw)) ? (int)$cursorRaw : 0;
        if ($cursorOffset < 0) {
            $cursorOffset = 0;
        }

        $sortByRaw = trim((string)($options['sortBy'] ?? ''));
        $sortBy = strtolower($sortByRaw);
        if (!in_array($sortBy, ['name', 'modified', 'uploaded', 'size', 'uploader'], true)) {
            $sortBy = '';
        }
        if ($sortBy === '' && $pageSize > 0) {
            $sortBy = 'modified';
        }
        $sortDir = strtolower(trim((string)($options['sortDir'] ?? '')));
        if ($sortDir !== 'asc' && $sortDir !== 'desc') {
            $sortDir = ($sortBy === 'name' || $sortBy === 'uploader') ? 'asc' : 'desc';
        }
        $uploaderExact = trim((string)($options['uploaderExact'] ?? ''));

        $folder = trim($folder) ?: 'root';
        $storage = self::storage();
        $activeSourceId = class_exists('SourceContext') ? SourceContext::getActiveId() : '';
        $parseUploadedTs = static function (string $v): int {
            $v = trim($v);
            if ($v === '' || strcasecmp($v, 'Unknown') === 0) {
                return 0;
            }
            $ts = @strtotime($v);
            return ($ts === false) ? 0 : (int)$ts;
        };

        // Determine the target directory.
        $baseDir = rtrim(self::uploadRoot(), '/\\');
        if (strtolower($folder) !== 'root') {
            $directory = $baseDir . DIRECTORY_SEPARATOR . $folder;
        } else {
            $directory = $baseDir;
        }

        // Validate folder.
        if (strtolower($folder) !== 'root' && !preg_match(REGEX_FOLDER_NAME, $folder)) {
            return ["error" => "Invalid folder name."];
        }