Method buildSnapshot

src/FileRise/Domain/DiskUsageModel.php:214–547

* Build a fresh snapshot of disk usage under UPLOAD_DIR and write it to disk. * * Returns the structured snapshot array (same shape as stored JSON). * * @throws RuntimeException on configuration or IO errors. */

(string $sourceId = '')

     * @throws RuntimeException on configuration or IO errors.
     */
    public static function buildSnapshot(string $sourceId = ''): array
    {
        $start = microtime(true);

        $ctx = self::resolveSourceContext($sourceId);
        if (empty($ctx['ok'])) {
            throw new RuntimeException($ctx['message'] ?? 'Invalid source for disk usage scan.');
        }

        $rootPath = (string)($ctx['uploadRoot'] ?? UPLOAD_DIR);
        $root = realpath($rootPath);
        if ($root === false || !is_dir($root)) {
            $msg = ($sourceId !== '')
                ? 'Source upload root is not configured correctly.'
                : 'Uploads directory is not configured correctly.';
            throw new RuntimeException($msg);
        }
        $root = rtrim($root, DIRECTORY_SEPARATOR);

        $SKIP   = FS::SKIP();

        // Folder map: key => [
        //   'key'    => string,
        //   'parent' => string|null,
        //   'name'   => string,
        //   'bytes'  => int,
        //   'files'  => int,
        //   'dirs'   => int,
        //   'latest_mtime' => int
        // ]
        $folders = [];

        // Root entry
        $folders['root'] = [
            'key'          => 'root',
            'parent'       => null,
            'name'         => 'root',
            'bytes'        => 0,
            'files'        => 0,
            'dirs'         => 0,
            'latest_mtime' => 0,
        ];

        // File records (we may trim to TOP_FILE_LIMIT later)
        // Each item: [
        //   'folder' => folderKey,
        //   'name'   => file name,
        //   'path'   => "folder/name" or just name if root,
        //   'bytes'  => int,
        //   'mtime'  => int
        // ]
        $files = [];

        $rootLen = strlen($root);

        $dirIter = new RecursiveDirectoryIterator(
            $root,
            FilesystemIterator::SKIP_DOTS