MongoDB\BSON\toPHP
bson
(string)- 직렬화 해제할 BSON 값입니다.
typeMap
(array)- Type map configuration.
- 유형 맵의 클래스를 인스턴스화할 수 없거나 MongoDB\BSON\Unserializable을 구현하지 않는 경우 MongoDB\Driver\Exception\InvalidArgumentException을 던집니다.
- 입력에 정확히 하나의 BSON 문서가 포함되지 않은 경우 MongoDB\Driver\Exception\UnexpectedValueException이 발생합니다. 가능한 원인에는 잘못된 BSON, 추가 데이터(BSON 문서 하나를 읽은 후) 또는 예기치 않은 » libbson 오류가 포함되지만 이에 국한되지 않습니다.
(mongodb >=1.0.0)
MongoDB\BSON\toPHP — BSON 값의 PHP 표현을 반환합니다.
설명
MongoDB\BSON\toPHP(string $bson
, array $typeMap
= array()): array|object
BSON 문서(즉, 바이너리 문자열)를 PHP 표현으로 직렬화 해제합니다. typeMap
매개변수는 BSON 배열 및 문서(루트 및 임베디드 모두) 변환에 사용되는 PHP 유형을 제어하는 데 사용할 수 있습니다.
경고 문서가 키-값 쌍의 목록으로 저장되기 때문에 BSON 문서는 기술적으로 중복 키를 포함할 수 있습니다. 그러나 응용 프로그램은 서버 및 드라이버 동작이 정의되지 않을 수 있으므로 중복 키가 있는 문서를 생성하지 않아야 합니다. PHP 개체와 배열은 중복 키를 가질 수 없으므로 중복 키로 BSON 문서를 디코딩할 때도 데이터가 손실될 수 있습니다.
매개변수
반환 값
직렬화되지 않은 PHP 값입니다.
오류/예외
변경 로그
버전 | 설명 |
---|---|
PECL mongodb 1.4.0 | 입력에 지원되지 않는 더 이상 사용되지 않는 BSON 유형이 포함된 경우 드라이버는 이제 더 이상 디버그 로그에 경고를 기록하지 않고 대신 이 유형을 나타내는 개체를 생성합니다. |
PECL mongodb 1.3.2 | 입력에 지원되지 않고 더 이상 사용되지 않는 BSON 유형이 포함된 경우 MongoDB\Driver\Exception\UnexpectedValueException이 더 이상 발생하지 않습니다. 드라이버가 이제 디버그 로그에 경고를 기록하지만(1.3.0 이전 버전에서와 같이) 이러한 유형은 무시됩니다(mongodb.debug 참조). |
PECL mongodb 1.3.0 | 입력에 지원되지 않고 사용되지 않는 BSON 유형이 포함된 경우 MongoDB\Driver\Exception\UnexpectedValueException이 발생합니다. 이전에는 이러한 유형이 무시되었습니다. |
Examples
예제 #1 MongoDB\BSON\toPHP() 예제
<?php
$bson = hex2bin('0e00000010666f6f000100000000');
$value = MongoDB\BSON\toPHP($bson);
var_dump($value);
?>
위의 예는 다음을 출력합니다.
object(stdClass)#1 (1) { ["foo"]=> int(1) }
기타
- MongoDB\BSON\fromPHP() - PHP 값의 BSON 표현을 반환합니다.
- » MongoDB BSON
- Persisting Data