getClientOriginalExtension(); if ($postId) { // 기존 게시글 수정: 최종 경로에 바로 저장 $path = "{$slug}/".date('Y/m/d')."/{$storedFilename}"; } else { // 신규 게시글: 임시 경로에 저장 (저장 시 최종 경로로 이동) $path = "{$slug}/temp/{$tempKey}/{$storedFilename}"; } // 스토리지에 파일 저장 (category: 'attachments') $this->storage->put('attachments', $path, file_get_contents($file->getRealPath())); // Disk 정보는 스토리지 드라이버에서 가져옴 $disk = $this->storage->getDisk(); // 현재 컬렉션의 최대 order 조회 $maxOrder = $postId ? $this->repository->getMaxOrder($slug, $postId, $collection) : $this->repository->getMaxOrderByTempKey($slug, $tempKey, $collection); // 메타데이터 준비 (이미지인 경우 크기 정보) $meta = []; if (str_starts_with($file->getMimeType(), 'image/')) { $imageSize = @getimagesize($file->getRealPath()); if ($imageSize) { $meta['width'] = $imageSize[0]; $meta['height'] = $imageSize[1]; } } // board_id 설정: postId가 있으면 실제 board_id, 없으면 0(임시 업로드 → p_default 파티션) $boardId = 0; if ($postId) { $board = $this->boardRepository->findBySlug($slug); $boardId = $board?->id ?? 0; } // DB에 저장 (hash는 모델에서 자동 생성) $attachment = $this->repository->create($slug, [ 'board_id' => $boardId, 'post_id' => $postId, 'temp_key' => $postId ? null : $tempKey, 'original_filename' => $file->getClientOriginalName(), 'stored_filename' => $storedFilename, 'disk' => $disk, 'path' => $path, 'mime_type' => $file->getMimeType(), 'size' => $file->getSize(), 'collection' => $collection, 'order' => $maxOrder + 1, 'meta' => ! empty($meta) ? $meta : null, 'created_by' => Auth::id(), ]); Log::info('게시판 첨부파일 업로드 완료', [ 'board_slug' => $slug, 'attachment_id' => $attachment->id, 'post_id' => $postId, 'temp_key' => $tempKey, 'original_filename' => $attachment->original_filename, 'size' => $attachment->size, ]); // After 훅 HookManager::doAction('sirsoft-board.attachment.after_upload', $attachment); return $attachment; } /** * 임시 첨부파일을 게시글에 연결합니다. * * @param string $slug 게시판 슬러그 * @param string $tempKey 임시 업로드 키 * @param int $postId 게시글 ID * @return int 연결된 첨부파일 수 */ public function linkTempAttachments(string $slug, string $tempKey, int $postId): int { return $this->repository->linkTempAttachments($slug, $tempKey, $postId); } /** * 임시 첨부파일을 게시글에 연결하고 최종 경로로 파일을 이동합니다. * * 이커머스 ProductImageService::linkTempImages() 패턴 참고. * StorageInterface에 move()가 없으므로 get+put+delete 조합 사용. * * 경로 패턴: * - 임시 경로: {slug}/temp/{tempKey}/{filename} * - 최종 경로: {slug}/{Y/m/d}/{filename} * * @param string $slug 게시판 슬러그 * @param string $tempKey 임시 업로드 키 * @param int $postId 게시글 ID * @return int 연결된 파일 수 */ public function linkTempAttachmentsWithMove(string $slug, string $tempKey, int $postId): int { // 게시판 조회 (board_id 설정용) $board = $this->boardRepository->findBySlug($slug); if (! $board) { throw new ModelNotFoundException(__('sirsoft-board::messages.errors.board_not_found')); } $tempAttachments = $this->repository->getByTempKey($slug, $tempKey); $linkedCount = 0; foreach ($tempAttachments as $attachment) { // 최종 경로 생성 (기존 경로 규칙 유지) $newPath = "{$slug}/".date('Y/m/d')."/{$attachment->stored_filename}"; // 파일 물리적 이동 (StorageInterface: get + put + delete) $content = $this->storage->get('attachments', $attachment->path); if ($content) { $this->storage->put('attachments', $newPath, $content); $this->storage->delete('attachments', $attachment->path); } // DB 업데이트: board_id 파티션 이동, post_id 설정, temp_key 제거, path 변경 // 임시 첨부파일(board_id=0)을 직접 업데이트 (repository->update()는 board_id=$board->id로 조회하므로 사용 불가) $attachment->update([ 'board_id' => $board->id, 'post_id' => $postId, 'temp_key' => null, 'path' => $newPath, ]); $linkedCount++; } // 임시 디렉토리 정리 $this->storage->deleteDirectory('attachments', "{$slug}/temp/{$tempKey}"); Log::info('게시판 임시 첨부파일 연결 완료', [ 'board_slug' => $slug, 'temp_key' => $tempKey, 'post_id' => $postId, 'linked_count' => $linkedCount, ]); return $linkedCount; } /** * 임시 첨부파일 목록을 조회합니다. * * @param string $slug 게시판 슬러그 * @param string $tempKey 임시 업로드 키 * @param string|null $collection 컬렉션 필터 * @return \Illuminate\Database\Eloquent\Collection */ public function getTempAttachments(string $slug, string $tempKey, ?string $collection = null) { return $this->repository->getByTempKey($slug, $tempKey, $collection); } /** * 해시로 첨부파일 조회 * * @param string $slug 게시판 슬러그 * @param string $hash 첨부파일 해시 * @return Attachment|null 첨부파일 또는 null */ public function getByHash(string $slug, string $hash): ?Attachment { return $this->repository->findByHash($slug, $hash); } /** * ID로 첨부파일 조회 * * @param string $slug 게시판 슬러그 * @param int $id 첨부파일 ID * @return Attachment|null 첨부파일 또는 null */ public function getById(string $slug, int $id): ?Attachment { return $this->repository->findById($slug, $id); } /** * 사용자가 첨부파일을 삭제할 권한이 있는지 확인 * * @param Attachment $attachment 첨부파일 * @param int|null $userId 사용자 ID (null이면 비회원) * @return bool 삭제 권한 여부 */ public function canDelete(Attachment $attachment, ?int $userId): bool { // 비회원은 삭제 불가 if (! $userId) { return false; } // 작성자 본인만 삭제 가능 return $attachment->created_by === $userId; } /** * 첨부파일 삭제 * * @param string $slug 게시판 슬러그 * @param int $id 첨부파일 ID * @return bool 삭제 성공 여부 */ public function delete(string $slug, int $id): bool { $attachment = $this->repository->findById($slug, $id); if (! $attachment) { return false; } // 삭제 후 재정렬을 위해 정보 저장 $postId = $attachment->post_id; $collection = $attachment->collection; // Before 훅 HookManager::doAction('sirsoft-board.attachment.before_delete', $attachment); // 물리 파일은 삭제하지 않음 — 소프트 딜리트만 수행 // 추후 배치 작업(Artisan Command + Scheduler)으로 보존 기간 경과 후 정리 예정 // DB에서 소프트 삭제 $result = $this->repository->delete($slug, $id); Log::info('게시판 첨부파일 삭제 완료', [ 'board_slug' => $slug, 'attachment_id' => $id, 'post_id' => $postId, ]); // 삭제 후 남은 파일들의 순서 재정렬 if ($result && $postId) { $this->reorderAfterDelete($slug, $postId, $collection); } // After 훅 HookManager::doAction('sirsoft-board.attachment.after_delete', $attachment); return $result; } /** * 순서 변경 * * @param string $slug 게시판 슬러그 * @param array $orders 첨부파일 ID => order 매핑 * @return bool 성공 여부 */ public function reorder(string $slug, array $orders): bool { // Before 훅 HookManager::doAction('sirsoft-board.attachment.before_reorder', $slug, $orders); $result = $this->repository->reorder($slug, $orders); // After 훅 HookManager::doAction('sirsoft-board.attachment.after_reorder', $slug, $orders); return $result; } /** * 삭제 후 남은 파일들의 순서를 재정렬합니다. * * @param string $slug 게시판 슬러그 * @param int $postId 게시글 ID * @param string $collection 컬렉션명 */ protected function reorderAfterDelete(string $slug, int $postId, string $collection): void { $attachments = $this->repository->getByPost($slug, $postId, $collection); $orders = []; foreach ($attachments as $index => $attachment) { $orders[$attachment->id] = $index + 1; } if (! empty($orders)) { $this->repository->reorder($slug, $orders); } } /** * 게시글의 첨부파일 목록을 조회합니다. * * @param string $slug 게시판 슬러그 * @param int $postId 게시글 ID * @param string|null $collection 컬렉션 필터 * @return \Illuminate\Database\Eloquent\Collection */ public function getAttachments(string $slug, int $postId, ?string $collection = null) { return $this->repository->getByPost($slug, $postId, $collection); } /** * 업로드된 첨부파일들을 롤백(삭제)합니다. * * 게시글 저장 실패 시 업로드된 파일들을 정리하기 위해 사용됩니다. * * @param string $slug 게시판 슬러그 * @param array $attachmentIds 첨부파일 ID 배열 */ public function rollbackUploadedFiles(string $slug, array $attachmentIds): void { foreach ($attachmentIds as $id) { $this->delete($slug, $id); } } /** * 첨부파일 다운로드 응답 생성 * * @param string $slug 게시판 식별자 * @param int $id 첨부파일 ID * @return StreamedResponse|null 파일 스트림 또는 없을 경우 null */ public function download(string $slug, int $id, string $context = 'admin'): ?StreamedResponse { $attachment = $this->repository->findById($slug, $id); if (! $attachment) { return null; } // 컨텍스트 기반 스코프 접근 검사 $scopePermission = $context === 'admin' ? "sirsoft-board.{$slug}.admin.attachments.download" : "sirsoft-board.{$slug}.attachments.download"; if (! PermissionHelper::checkScopeAccess($attachment, $scopePermission)) { throw new AccessDeniedHttpException(__('auth.scope_denied')); } // RFC 5987에 따라 UTF-8 파일명 인코딩 $encodedFilename = rawurlencode($attachment->original_filename); return $this->storage->response( 'attachments', $attachment->path, $attachment->original_filename, [ 'Content-Type' => $attachment->mime_type, 'Content-Disposition' => "attachment; filename=\"{$attachment->original_filename}\"; filename*=UTF-8''{$encodedFilename}", ] ); } /** * 첨부파일 URL 조회 * * @param string $slug 게시판 식별자 * @param int $id 첨부파일 ID * @return string|null 파일 URL 또는 없을 경우 null */ public function getUrl(string $slug, int $id): ?string { $attachment = $this->repository->findById($slug, $id); if (! $attachment) { return null; } return $this->storage->url('attachments', $attachment->path); } /** * 이미지 미리보기 (권한 체크 없이) * * 이미지 파일을 권한 체크 없이 스트리밍합니다. * 비회원도 이미지를 볼 수 있습니다. * * @param string $slug 게시판 식별자 * @param int $id 첨부파일 ID * @return StreamedResponse|null 이미지 스트림 또는 없을 경우 null */ public function preview(string $slug, int $id): ?StreamedResponse { $attachment = $this->repository->findById($slug, $id); if (! $attachment) { return null; } // 이미지가 아닌 경우 if (! $attachment->is_image) { return null; } return $this->storage->response( 'attachments', $attachment->path, $attachment->original_filename, [ 'Content-Type' => $attachment->mime_type, 'Content-Disposition' => 'inline', ] ); } /** * 이미지 파일 정보 조회 (캐싱 응답용) * * 컨트롤러에서 fileResponse()로 캐싱 헤더와 함께 응답할 수 있도록 * 파일 경로와 메타 정보를 반환합니다. * * @param string $slug 게시판 슬러그 * @param int $id 첨부파일 ID * @return array{path: string, mime_type: string, filename: string}|null 파일 정보 또는 null */ public function getFileInfo(string $slug, int $id): ?array { $attachment = $this->repository->findById($slug, $id); if (! $attachment) { return null; } // 파일 존재 확인 if (! $this->storage->exists('attachments', $attachment->path)) { Log::error('게시판 첨부파일 스토리지에 없음', [ 'board_slug' => $slug, 'attachment_id' => $attachment->id, 'path' => $attachment->path, ]); return null; } // 전체 파일 경로 생성 $basePath = $this->storage->getBasePath('attachments'); $fullPath = $basePath.DIRECTORY_SEPARATOR.$attachment->path; return [ 'path' => $fullPath, 'mime_type' => $attachment->mime_type, 'filename' => $attachment->original_filename, ]; } }