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을 구현합니다. MongoDB\BSON\Binary::TYPE_COLUMN이 추가되었습니다.

PECL mongodb 1.7.0 MongoDB\BSON\Binary::TYPE_ENCRYPTED를 추가했습니다.
PECL mongodb 1.3.0 MongoDB\BSON\BinaryInterface를 구현합니다.
PECL mongodb 1.2.0 SerializableJsonSerializable을 구현합니다.
목차