MongoCollection
PHP Manual

MongoCollection::save

(PECL mongo >=0.9.0)

MongoCollection::saveオブジェクトをコレクションに保存する

説明

public mixed MongoCollection::save ( array $a [, array $options = array() ] )

データベースから取得したオブジェクトの場合はデータベース上の既存のオブジェクトを更新し、 それ以外の場合はオブジェクトを追加します。

パラメータ

a

保存したい配列。

options

保存時のオプション。

  • "safe"

    保存に成功したかどうかをチェックします。

返り値

オブジェクトが保存されたかどうかを返します。

エラー / 例外

"safe" オプションが設定されていて保存に失敗した場合に MongoCursorException をスローします。

変更履歴

バージョン 説明
1.0.5 "options" パラメータが追加されました。

例1 MongoCollection::save() の例

<?php

$obj 
= array('x' => 1);

// $obj を db に追加します
$collection->save($obj);

// 別のフィールドを追加します
$obj['foo'] = 'bar';

// $obj をもう一度追加することはできません。_id が重複しているからです
$collection->insert($obj);

// 新しいフィールドつきの $obj で上書きします
$collection->save($obj);

?>

MongoCollection
PHP Manual