Method createFolder

src/FileRise/Domain/FolderModel.php:1526–1629

* Create a folder on disk and register it in ACL with the creator as owner. * @param string $folderName leaf name * @param string $parent 'root' or nested key (e.g. 'team/reports') * @param string $creator username to set as initial owner (falls back to 'admin') */

(string $folderName, string $parent, string $creator)

     * @param string $creator    username to set as initial owner (falls back to 'admin')
     */
    public static function createFolder(string $folderName, string $parent, string $creator): array
    {
        // -------- Normalize incoming values (use ONLY the parameters) --------
        $folderName = trim((string)$folderName);
        $parentIn   = trim((string)$parent);

        // If the client sent a path in folderName (e.g., "bob/new-sub") and parent is root/empty,
        // derive parent = "bob" and folderName = "new-sub" so permission checks hit "bob".
        $normalized = ACL::normalizeFolder($folderName);
        if (
            $normalized !== 'root' && strpos($normalized, '/') !== false &&
            ($parentIn === '' || strcasecmp($parentIn, 'root') === 0)
        ) {
            $parentIn  = trim(str_replace('\\', '/', dirname($normalized)), '/');
            $folderName = basename($normalized);
            if ($parentIn === '' || strcasecmp($parentIn, 'root') === 0) {
                $parentIn = 'root';
            }
        }

        $parent = ($parentIn === '' || strcasecmp($parentIn, 'root') === 0) ? 'root' : $parentIn;
        $folderName = trim($folderName);
        if ($folderName === '') {
            return ['success' => false, 'error' => 'Folder name required'];
        }

        $parentParts = self::splitFolderSegments($parent);
        if ($parentParts === null) {
            return ['success' => false, 'error' => 'Invalid parent folder name'];
        }
        $folderParts = self::splitFolderSegments($folderName, false);
        if ($folderParts === null || count($folderParts) !== 1) {
            return ['success' => false, 'error' => 'Invalid folder name'];
        }

        $parent = $parentParts === [] ? 'root' : implode('/', $parentParts);
        $folderName = $folderParts[0];

        // ACL key for new folder
        $newKey = ($parent === 'root') ? $folderName : ($parent . '/' . $folderName);

        // -------- Compose filesystem paths --------
        $base = rtrim(self::uploadRoot(), "/\\");
        $parentRel = ($parent === 'root') ? '' : str_replace('/', DIRECTORY_SEPARATOR, $parent);
        $parentAbs = $parentRel ? ($base . DIRECTORY_SEPARATOR . $parentRel) : $base;
        $storage = self::storage();
        $isLocal = $storage->isLocal();

        // -------- Exists / sanity checks --------
        $parentStat = $isLocal ? null : $storage->stat($parentAbs);
        $parentExists = $isLocal
            ? is_dir($parentAbs)
            : ($parentStat !== null && ($parentStat['type'] ?? '') === 'dir');
        if (!$parentExists) {
            return ['success' => false, 'error' => 'Parent folder does not exist'];
        }

        if ($isLocal) {