대용량 파일 저장

개요

이 가이드 에서는 GridFS 를 사용하여 MongoDB 에 대용량 파일을 저장 하고 조회 하는 방법을 학습 수 있습니다. GridFS 는 MongoDB PHP 라이브러리에서 구현한 사양으로, 파일을 저장할 때 청크로 분할 하고 검색할 때 다시 조립하는 방법을 설명합니다. 라이브러리의 GridFS 구현 은 파일 저장 의 운영 및 조직 을 관리하는 추상화입니다.

파일 크기가 BSON 문서 크기 제한인 16MB를 초과하는 경우 GridFS 를 사용하세요. GridFS 가 사용 사례 에 적합한지 여부에 대한 자세한 내용은 MongoDB Server 매뉴얼에서 GridFS 를 참조하세요.

GridFS 작동 방식

GridFS는 파일 청크와 파일을 설명하는 정보가 들어 있는 MongoDB 컬렉션 그룹인 버킷에 파일을 구성합니다. 버킷에는 GridFS 사양에 정의된 규칙을 사용하여 명명된 다음 컬렉션이 포함되어 있습니다.

• chunks 컬렉션은 바이너리 파일 청크를 저장합니다.

• files 0} 컬렉션에 파일 메타데이터가 저장됩니다.

새 GridFS 버킷을 생성하면 라이브러리는 다른 이름을 지정하지 않는 한 기본값 버킷 이름 fs 접두사 앞에 앞의 컬렉션을 생성합니다. 또한 파일 및 관련 메타데이터 를 효율적으로 검색할 수 있도록 각 컬렉션 에 인덱스 를 생성합니다. 라이브러리는 GridFS 버킷이 존재하지 않는 경우 첫 번째 쓰기 (write) 작업이 수행될 때만 생성합니다. 라이브러리는 인덱스가 존재하지 않거나 버킷이 비어 있는 경우에만 인덱스를 생성합니다. GridFS 인덱스에 대한 자세한 내용은 MongoDB Server 매뉴얼에서 GridFS 인덱스 를 참조하세요.

GridFS 를 사용하여 파일을 저장 때 라이브러리는 파일을 작은 청크로 분할하며, 각 chunks 청크는 컬렉션 에서 별도의 문서 로 표시됩니다. 또한 컬렉션 files 에 파일 ID, 파일 이름 및 기타 파일 메타데이터 가 포함된 문서 를 만듭니다. 스트림 을 MongoDB PHP 라이브러리에 전달하여 소비하거나 새 스트림 을 생성하고 직접 작성하여 파일 을 업로드할 수 있습니다. 스트림에 학습 보려면 스트림 를 참조하세요. PHP 매뉴얼에서 확인할 수 있습니다.

다음 다이어그램을 보고 버킷에 업로드할 때 GridFS 가 파일을 분할하는 방법을 확인할 수 있습니다.

파일을 검색할 때 GridFS 는 지정된 버킷의 files 컬렉션 에서 메타데이터 를 가져오고 이 정보를 사용하여 chunks 컬렉션 의 문서에서 파일 을 재구성합니다. 파일 내용을 기존 스트림 에 쓰거나 파일 을 가리키는 새 스트림 을 만들어 파일 을 읽을 수 있습니다.

GridFS 버킷 만들기

GridFS 에서 파일을 저장 하거나 조회 하려면 데이터베이스 에서 MongoDB\Database::selectGridFSBucket() 메서드를 호출합니다. 이 메서드는 기존 버킷에 액세스하거나 버킷이 없는 경우 새 버킷을 생성합니다.

다음 예시 에서는 db 데이터베이스 에서 selectGridFSBucket() 메서드를 호출합니다.

$bucket = $client->db->selectGridFSBucket();

$custom_bucket = $client->db->selectGridFSBucket(
    ['bucketName' => 'myCustomBucket']
);

파일 업로드

다음 방법을 사용하여 GridFS 버킷에 파일을 업로드할 수 있습니다.

• MongoDB\GridFS\Bucket::openUploadStream(): 파일 콘텐츠를 쓰기 (write) 수 있는 새 업로드 스트림 을 엽니다.

• MongoDB\GridFS\Bucket::uploadFromStream(): 기존 스트림 의 콘텐츠를 GridFS 파일 에 업로드합니다.

$stream = $bucket->openUploadStream('my_file', [
    'metadata' => ['contentType' => 'text/plain']
]);
fwrite($stream, 'Data to store');
fclose($stream);

$file = fopen('/path/to/input_file', 'rb');
$bucket->uploadFromStream('new_file', $file);

파일 정보 검색

이 섹션에서는 GridFS 버킷의 files 컬렉션에 저장된 파일 메타데이터를 검색하는 방법을 알아볼 수 있습니다. 메타데이터에는 다음을 포함하여 참조하는 파일에 대한 정보가 포함됩니다.

• 파일의 _id입니다.

• 파일 이름

• 파일의 길이/크기

• 업로드 날짜 및 시간

• 다른 정보를 저장할 수 있는 metadata 문서입니다.

GridFS 버킷에서 파일을 조회 하려면 MongoDB\GridFS\Bucket 인스턴스 에서 MongoDB\GridFS\Bucket::find() 메서드를 호출합니다. 이 메서드는 결과에 액세스 할 수 있는 MongoDB\Driver\Cursor 인스턴스 를 반환합니다. MongoDB PHP 라이브러리의 Cursor 객체에 학습 보려면 커서에서 데이터 액세스 가이드 를 참조하세요.

$files = $bucket->find();
foreach ($files as $file_doc) {
    echo toJSON($file_doc), PHP_EOL;
}

function toJSON(object $document): string
{
    return MongoDB\BSON\Document::fromPHP($document)->toRelaxedExtendedJSON();
}

파일 다운로드

다음 방법을 사용하여 GridFS 버킷에서 파일을 다운로드 할 수 있습니다.

• MongoDB\GridFS\Bucket::openDownloadStreamByName() 또는 MongoDB\GridFS\Bucket::openDownloadStream(): 파일 내용을 읽을 수 있는 새 다운로드 스트림 을 엽니다.

• MongoDB\GridFS\Bucket::downloadToStream(): 전체 파일 을 기존 다운로드 스트림 에 씁니다.

$stream = $bucket->openDownloadStreamByName('my_file');
$contents = stream_get_contents($stream);
echo $contents, PHP_EOL;
fclose($stream);

$stream = $bucket->openDownloadStream(new ObjectId('66e0a5487c880f844c0a32b1'));
$contents = stream_get_contents($stream);
fclose($stream);

$stream = $bucket->openDownloadStreamByName('my_file', ['revision' => 0]);
$contents = stream_get_contents($stream);
fclose($stream);

$file = fopen('/path/to/output_file', 'wb');
$bucket->downloadToStream(
	new ObjectId('66e0a5487c880f844c0a32b1'),
	$file,
);

파일 이름 바꾸기

MongoDB\GridFS\Bucket::rename() 메서드를 사용하여 버킷에 있는 GridFS 파일의 이름을 업데이트합니다. 파일 이름이 아닌 _id 필드로 이름을 바꾸도록 파일을 지정해야 합니다.

다음 예에서는 문서의 _id 필드를 참조하여 filename 필드를 'new_file_name' 로 업데이트하는 방법을 보여 줍니다.

$bucket->rename(new ObjectId('66e0a5487c880f844c0a32b1'), 'new_file_name');

파일 삭제

버킷에서 파일의 컬렉션 문서와 관련 청크를 제거하려면 MongoDB\GridFS\Bucket::delete() 메서드를 사용합니다. 이렇게 하면 파일이 효과적으로 삭제됩니다. 파일 이름이 아닌 _id 필드로 파일을 지정해야 합니다.

다음 예제에서는 _id 필드를 참고하여 파일을 삭제하는 방법을 보여 줍니다.

$bucket->delete(new ObjectId('66e0a5487c880f844c0a32b1'));

API 문서

MongoDB PHP 라이브러리를 사용하여 대용량 파일을 저장 하고 조회 하는 방법에 학습 보려면 다음 API 설명서를 참조하세요.

• MongoDB\Database::selectGridFSBucket()

• MongoDB\GridFS\Bucket::openUploadStream()

• MongoDB\GridFS\Bucket::uploadFromStream()

• MongoDB\GridFS\Bucket::find()

• MongoDB\GridFS\Bucket::openDownloadStreamByName()

• MongoDB\GridFS\Bucket::openDownloadStream()

• MongoDB\GridFS\Bucket::downloadToStream()

• MongoDB\GridFS\Bucket::rename()

• MongoDB\GridFS\Bucket::delete()