MongoDB\GridFS\Bucket::uploadFromStream()

정의

MongoDB\GridFS\Bucket::uploadFromStream()

새 GridFS 파일을 생성하고 읽을 수 있는 스트림의 내용을 해당 파일에 복사합니다.

function uploadFromStream(
    string $filename,
    resource $source,
    array $options = []
): mixed

매개변수

$filename : 문자열

만들 파일의 filename 입니다.

$source : 리소스

새 GridFS 파일의 콘텐츠를 읽을 읽기 가능한 스트림입니다.

$options : 배열

원하는 옵션을 지정하는 배열입니다.

이름	유형	설명
_id	혼합	파일 문서 식별자로 사용할 값입니다. 기본값은 새 MongoDB\BSON\ObjectId 입니다. 객체.
청크 크기 바이트	integer	청크 크기(바이트)입니다. 기본값은 버킷의 chunkSizeBytes 옵션입니다.
disableMD5	부울	파일 저장 시 자동 MD5 생성을 비활성화할지 여부입니다. 기본값은 false 입니다. 2.0 에서는 true 만 지원됩니다. 버전 1.4에 새로 추가되었습니다.
메타 데이터	배열|객체	파일 문서의 metadata 필드에 대한 사용자 데이터입니다. 지정하지 않으면 파일 문서에 metadata 필드가 설정되지 않습니다.

반환 값

새로 생성된 GridFS 파일과 연결된 메타데이터 문서의 _id 필드입니다. 옵션을 지정하지 않으면 새 MongoDB\BSON\ObjectId 기본적으로 _id 객체가 사용됩니다.

오류/예외

MongoDB\Exception\InvalidArgumentException 매개변수 또는 옵션의 구문 분석과 관련된 오류의 경우입니다.

MongoDB\Driver\Exception\RuntimeException 확장 수준의 기타 오류(예: 연결 오류)의 경우.

예제

<?php
$bucket = (new MongoDB\Client)->test->selectGridFSBucket();
$stream = fopen('php://temp', 'w+b');
fwrite($stream, "foobar");
rewind($stream);
$id = $bucket->uploadFromStream('filename', $stream);
var_dump($id);

이 경우 출력은 다음과 유사합니다:

object(MongoDB\BSON\ObjectId)#3009 (1) {
  ["oid"]=>
  string(24) "5acf81017e21e816e538d883"
}

다음도 참조하세요.

• MongoDB\GridFS\Bucket::openUploadStream()