(mongodb >=1.4.0)
MongoDB\Driver\Server::executeWriteCommand — 在此伺服器上執行寫入資料庫的命令
$db, MongoDB\Driver\Command $command, ?陣列 $options = null): MongoDB\Driver\Cursor在此伺服器上執行指令。
此方法將套用特定於寫入指令的邏輯（例如 » drop）。"writeConcern" 選項的預設值將從活動交易（由 "session" 選項指示）推斷，接著是 連線 URI。
注意： 此方法不適用於執行 » insert、» update 或 » delete 指令。建議使用者針對這些操作使用 MongoDB\Driver\Server::executeBulkWrite()。
db (字串)要執行指令的資料庫名稱。
command (MongoDB\Driver\Command)要執行的指令。
選項
| 選項名稱 | 類型 | 說明 |
|---|---|---|
| session | MongoDB\Driver\Session |
要與操作關聯的階段作業。 |
| writeConcern | MongoDB\Driver\WriteConcern |
要套用至操作的寫入策略。 |
如果您使用的 "session" 具有正在進行的交易，則您不能指定 "readConcern" 或 "writeConcern" 選項。這將導致擲出 MongoDB\Driver\Exception\InvalidArgumentException。您應該在使用 MongoDB\Driver\Session::startTransaction() 建立交易時設定這兩個選項。
成功時傳回 MongoDB\Driver\Cursor。
"session" 選項與相關聯的交易以及 "readConcern" 或 "writeConcern" 選項一起使用，則會擲出 MongoDB\Driver\Exception\InvalidArgumentException。"session" 選項與未確認的寫入策略一起使用，則會擲出 MongoDB\Driver\Exception\InvalidArgumentException。
| 版本 | 說明 |
|---|---|
| PECL mongodb 1.4.4 |
如果在未確認寫入關注的同時使用了 "session" 選項，將會拋出 MongoDB\Driver\Exception\InvalidArgumentException 例外。 |
注意： 確保伺服器能夠執行寫入操作是呼叫者的責任。例如，在次要伺服器（不包括其「local」資料庫）上執行寫入操作將會失敗。