sectionPath($section); if (! File::exists($path)) { File::makeDirectory($path, 0755, true); } return $path; } public function storeUploadedFile(UploadedFile $file, string $section): UploadStoredFile { $dir = $this->ensureSection($section); $extension = $this->safeExtension($file); $filename = Str::uuid()->toString() . ($extension !== '' ? '.' . $extension : ''); $file->move($dir, $filename); $path = $dir . DIRECTORY_SEPARATOR . $filename; return UploadStoredFile::fromPath($path); } public function moveToSection(string $path, string $section): string { if (! is_file($path)) { throw new RuntimeException('Source file not found for move.'); } $dir = $this->ensureSection($section); $extension = (string) pathinfo($path, PATHINFO_EXTENSION); $filename = Str::uuid()->toString() . ($extension !== '' ? '.' . $extension : ''); $target = $dir . DIRECTORY_SEPARATOR . $filename; File::move($path, $target); return $target; } public function ensureHashDirectory(string $section, string $hash): string { $segments = $this->hashSegments($hash); $dir = $this->sectionPath($section) . DIRECTORY_SEPARATOR . implode(DIRECTORY_SEPARATOR, $segments); if (! File::exists($dir)) { File::makeDirectory($dir, 0755, true); } return $dir; } public function publicHashDirectory(string $hash): string { $prefix = trim((string) config('uploads.public_img_prefix', 'img'), DIRECTORY_SEPARATOR); $base = $this->sectionPath('public') . DIRECTORY_SEPARATOR . $prefix; if (! File::exists($base)) { File::makeDirectory($base, 0755, true); } $segments = $this->hashSegments($hash); $dir = $base . DIRECTORY_SEPARATOR . implode(DIRECTORY_SEPARATOR, $segments); if (! File::exists($dir)) { File::makeDirectory($dir, 0755, true); } return $dir; } public function publicRelativePath(string $hash, string $filename): string { $prefix = trim((string) config('uploads.public_img_prefix', 'img'), DIRECTORY_SEPARATOR); $segments = $this->hashSegments($hash); return $prefix . '/' . implode('/', $segments) . '/' . ltrim($filename, '/'); } public function sectionRelativePath(string $section, string $hash, string $filename): string { $segments = $this->hashSegments($hash); $section = trim($section, DIRECTORY_SEPARATOR); return $section . '/' . implode('/', $segments) . '/' . ltrim($filename, '/'); } private function safeExtension(UploadedFile $file): string { $extension = (string) $file->guessExtension(); $extension = strtolower($extension); return preg_match('/^[a-z0-9]+$/', $extension) ? $extension : ''; } private function hashSegments(string $hash): array { $hash = strtolower($hash); $hash = preg_replace('/[^a-z0-9]/', '', $hash) ?? ''; $hash = str_pad($hash, 6, '0'); $segments = [ substr($hash, 0, 2), substr($hash, 2, 2), substr($hash, 4, 2), ]; return array_map(static fn (string $part): string => $part === '' ? '00' : $part, $segments); } }