MongoDB\BSON\Binary 클래스
(mongodb >=1.0.0)
소개
바이너리 데이터에 대한 BSON 유형(즉, 바이트 배열). 이진 값에는 바이트 배열에 어떤 종류의 데이터가 있는지 나타내는 데 사용되는 하위 유형도 있습니다. 0에서 127까지의 하위 유형은 미리 정의되거나 예약되어 있습니다. 128-255의 하위 유형은 사용자 정의입니다.
클래스 개요
final class MongoDB\BSON\Binary implements MongoDB\BSON\BinaryInterface, MongoDB\BSON\Type, Serializable, JsonSerializable, Stringable {
/* Constants */
const int TYPE_GENERIC = 0;
const int TYPE_FUNCTION = 1;
const int TYPE_OLD_BINARY = 2;
const int TYPE_OLD_UUID = 3;
const int TYPE_UUID = 4;
const int TYPE_MD5 = 5;
const int TYPE_ENCRYPTED = 6;
const int TYPE_COLUMN = 7;
const int TYPE_USER_DEFINED = 128;
/* Methods */
final public __construct(string $data, int $type)
final public getData(): string
final public getType(): int
final public jsonSerialize(): mixed
final public serialize(): string
final public __toString(): string
final public unserialize(string $serialized): void
}
미리 정의된 상수
MongoDB\BSON\Binary::TYPE_GENERIC
- 일반 바이너리 데이터.
MongoDB\BSON\Binary::TYPE_FUNCTION
- 함수
MongoDB\BSON\Binary::TYPE_OLD_BINARY
- 일반 바이너리 데이터(
MongoDB\BSON\Binary::TYPE_GENERIC
에 대해 더 이상 사용되지 않음). MongoDB\BSON\Binary::TYPE_OLD_UUID
- 범용 고유 식별자(
MongoDB\BSON\Binary::TYPE_UUID
를 위해 더 이상 사용되지 않음). 이 유형을 사용할 때 Binary의 데이터 길이는 16바이트여야 합니다.역사적으로 다른 드라이버는 언어 규칙(예: 다양한 엔디안)을 기반으로 이 유형으로 값을 인코딩하므로 이식성이 없습니다. PHP 드라이버는 이 유형으로 데이터를 인코딩하거나 디코딩하는 데 특별한 처리를 적용하지 않습니다.
MongoDB\BSON\Binary::TYPE_UUID
- 보편적으로 고유한 식별자입니다. 이 유형을 사용할 때 바이너리의 데이터는 길이가 16바이트이고 » RFC 4122에 따라 인코딩되어야 합니다.
MongoDB\BSON\Binary::TYPE_MD5
- MD5 해시. 이 유형을 사용할 때 Binary의 데이터 길이는 16바이트여야 합니다.
MongoDB\BSON\Binary::TYPE_ENCRYPTED
- 암호화된 값. 이 하위 유형은 클라이언트 측 암호화에 사용됩니다.
MongoDB\BSON\Binary::TYPE_COLUMN
- 열 데이터. 이 하위 유형은 시계열 컬렉션에 사용됩니다.
MongoDB\BSON\Binary::TYPE_USER_DEFINED
- 사용자 정의 유형. 0에서 127 사이의 유형은 미리 정의되거나 예약되어 있지만 128에서 255 사이의 유형은 사용자 정의이며 무엇이든 사용할 수 있습니다.
변경 로그
버전 | 설명 |
---|---|
PECL mongodb 1.12.0 | PHP 8.0 이상에서 Stringable을 구현합니다.
PHP 8.0 이상에서 Stringable을 구현합니다. |
PECL mongodb 1.7.0 | MongoDB\BSON\Binary::TYPE_ENCRYPTED 를 추가했습니다. |
PECL mongodb 1.3.0 | MongoDB\BSON\BinaryInterface를 구현합니다. |
PECL mongodb 1.2.0 | Serializable 및 JsonSerializable을 구현합니다. |
목차
- MongoDB\BSON\Binary::__construct — 새 바이너리 구성
- MongoDB\BSON\Binary::getData — 바이너리의 데이터를 반환합니다.
- MongoDB\BSON\Binary::getType — 바이너리의 유형을 반환합니다.
- MongoDB\BSON\Binary::jsonSerialize — JSON으로 변환할 수 있는 표현을 반환합니다.
- MongoDB\BSON\Binary::serialize — 바이너리 직렬화
- MongoDB\BSON\Binary::__toString — 바이너리의 데이터를 반환합니다.
- MongoDB\BSON\Binary::unserialize — 바이너리 직렬화 해제