Longhorn PHP 2026 - Call For Papers

    La clase MongoDB\Driver\ServerApi

    (mongodb >=1.10.0)

    Introducción

    Sinopsis de la Clase

    final class MongoDB\Driver\ServerApi implements MongoDB\BSON\Serializable, Serializable {
    /* Constantes */
    const string MongoDB\Driver\ServerAPI::V1 = "1";
    /* Métodos */
    final public bsonSerialize(): stdClass
    final public __construct(string $version, ?bool $strict = null, ?bool $deprecationErrors = null)
    }

    Constantes predefinidas

    MongoDB\Driver\ServerApi::V1
    Versión 1 de la API del servidor.

    Ejemplos

    Ejemplo #1 Declarar una versión de API en un gestor

    <?php

    use MongoDB\Driver\Manager;
    use     MongoDB\Driver\ServerApi;

    $v1 = new ServerApi(ServerApi::v1);
    $manager = new Manager('mongodb://localhost:27017', [], ['serverApi' => $v1]);

    $command = new MongoDB\Driver\Command(['buildInfo' => 1]);

    try {
    $cursor = $manager->executeCommand('admin', $command);
    } catch(    MongoDB\Driver\Exception $e) {
    echo     $e->getMessage(), "\n";
    exit;
    }

    /* El comando buildInfo devuelve un único documento de resultado, por lo que
    * necesitamos acceder al primer resultado en el cursor. */
    $buildInfo = $cursor->toArray()[0];

    echo     $buildInfo->version, "\n";

    ?>

    El ejemplo anterior mostrará:

    4.9.0-alpha7-49-gb968ca0

    Ejemplo #2 Declarar una versión estricta de API en un gestor

    El siguiente ejemplo establece la strict flag, que indica al servidor que rechace cualquier comando que no forme parte de la versión de API declarada. Esto genera un error al ejecutar el comando buildInfo.

    <?php

    use MongoDB\Driver\Manager;
    use     MongoDB\Driver\ServerApi;

    $v1 = new ServerApi(ServerApi::v1, true);
    $manager = new Manager('mongodb://localhost:27017', [], ['serverApi' => $v1]);

    $command = new MongoDB\Driver\Command(['buildInfo' => 1]);

    try {
    $cursor = $manager->executeCommand('admin', $command);
    } catch(    MongoDB\Driver\Exception $e) {
    echo     $e->getMessage(), "\n";
    exit;
    }

    /* El comando buildInfo devuelve un único documento de resultado, por lo que
    * necesitamos acceder al primer resultado en el cursor. */
    $buildInfo = $cursor->toArray()[0];

    echo     $buildInfo->version, "\n";

    ?>

    El ejemplo anterior mostrará:

    Provided apiStrict:true, but the command buildInfo is not in API Version 1

    Tabla de contenidos

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top