JetBrains PHPverse 2026

    MongoDB\Driver\Manager::executeReadWriteCommand

    (mongodb >=1.4.0)

    MongoDB\Driver\Manager::executeReadWriteCommand — Ejecuta un comando de base de datos que lee y escribe

    Descripción

    final public MongoDB\Driver\Manager::executeReadWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

    Ejecuta un comando en el servidor primario.

    Este método aplicará una lógica específica a los comandos que leen y escriben (por ejemplo » aggregate). Los valores por omisión de las opciones "readConcern" y "writeConcern" serán deducidos a partir de una transacción activa (indicada por la opción "session"), seguida de la URI de conexión.

    Parámetros

    db (string)
    El nombre de la base de datos sobre la cual se ejecutará el comando.
    command (MongoDB\Driver\Command)
    El comando a ejecutar.
    options

    options
    Option Type Description
    readConcern MongoDB\Driver\ReadConcern Una preocupación de lectura a aplicar a la operación. Esta opción está disponible en MongoDB 3.2+ y se traducirá en una excepción en el momento de la ejecución si se especifica para una versión más antigua del servidor.
    session MongoDB\Driver\Session Una sesión a asociar a la operación.
    writeConcern MongoDB\Driver\WriteConcern Una preocupación de escritura a aplicar a la operación.

    Advertencia

    Si se utiliza una "session" que tiene una transacción en curso, no se puede especificar la opción "readConcern" o "writeConcern". Intentar hacer esto lanzará una excepción MongoDB\Driver\Exception\InvalidArgumentException. En su lugar, debe definir estas opciones cuando se crea la transacción con MongoDB\Driver\Session::startTransaction().

    Valores devueltos

    Retorna un MongoDB\Driver\Cursor en caso de éxito.

    Errores/Excepciones

    • Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza con una transacción asociada en combinación con una opción "readConcern" o "writeConcern".
    • Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza junto con una preocupación de escritura no reconocida.
    • Lanza una excepción MongoDB\Driver\InvalidArgumentException en caso de error durante el análisis de un argumento.
    • Lanza una excepción MongoDB\Driver\ConnectionException si la conexión al servidor falla por una razón distinta a un problema de identificación
    • Lanza una excepción MongoDB\Driver\AuthenticationException si se requiere una identificación pero falla
    • Lanza una MongoDB\Driver\Exception\RuntimeException en caso de otros errores (por ejemplo: comando inválido).

    Historial de cambios

    Versión Descripción
    PECL mongodb 1.4.4 Una MongoDB\Driver\Exception\InvalidArgumentException será lanzada si la opción "session" es utilizada en combinación con un criterio de lectura o escritura no reconocido.

    Ver también

    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