Method createFile

src/FileRise/Domain/FileModel.php:3977–4033

* Create an empty file plus metadata entry. * * @param string $folder * @param string $filename * @param string $uploader * @return array ['success'=>bool, 'error'=>string, 'code'=>int] */

(string $folder, string $filename, string $uploader)

     * @return array ['success'=>bool, 'error'=>string, 'code'=>int]
     */
    public static function createFile(string $folder, string $filename, string $uploader): array
    {
        // 1) basic validation
        $filename = basename(trim($filename));
        if (!UploadNamePolicy::isAllowedForWrite($filename)) {
            return ['success' => false, 'error' => 'Invalid filename', 'code' => 400];
        }

        $storage = self::storage();

        // 2) resolve target folder
        list($baseDir, $err) = self::resolveFolderPath($folder, true);
        if ($err) {
            return ['success' => false, 'error' => $err, 'code' => ($err === 'Invalid folder name.' ? 400 : 500)];
        }

        $path = $baseDir . DIRECTORY_SEPARATOR . $filename;

        // 3) no overwrite
        if ($storage->stat($path) !== null) {
            return ['success' => false, 'error' => 'File already exists', 'code' => 400];
        }

        // 4) touch the file (seed minimal DOCX to keep ONLYOFFICE happy)
        $seed = self::seedFileContents($filename);
        $data = ($seed !== null) ? $seed : '';
        if (!$storage->write($path, $data, LOCK_EX)) {
            $detail = self::adapterErrorDetail($storage);
            return [
                'success' => false,
                'error' => $detail !== '' ? ('Could not create file: ' . $detail) : 'Could not create file',
                'code' => 500
            ];
        }

        // 5) write metadata
        $metaPath = self::getMetadataFilePath($folder);

        $collection = [];
        if (file_exists($metaPath)) {
            $json = file_get_contents($metaPath);
            $collection = json_decode($json, true) ?: [];
        }

        $now = date(DATE_TIME_FORMAT);
        $collection[$filename] = [
            'uploaded' => $now,
            'modified' => $now,
            'uploader' => $uploader
        ];

        if (false === file_put_contents($metaPath, json_encode($collection, JSON_PRETTY_PRINT), LOCK_EX)) {
            return ['success' => false, 'error' => 'Failed to update metadata', 'code' => 500];
        }

        return ['success' => true];
    }
}