Como atualizo parcialmente um objeto no MongoDB para que o novo objeto se sobreponha/mescle com o existente

Eu resolvi isso com minha própria função. Se você deseja atualizar o campo especificado no documento, você precisa abordá-lo claramente.

Exemplo:

{
    _id : ...,
    some_key: { 
        param1 : "val1",
        param2 : "val2",
        param3 : "val3"
    }
}

Se você deseja atualizar apenas o param2, é errado fazer:

db.collection.update(  { _id:...} , { $set: { some_key : new_info  } }  //WRONG

Você deve usar:

db.collection.update(  { _id:...} , { $set: { some_key.param2 : new_info  } }

Então eu escrevi uma função algo assim:

function _update($id, $data, $options=array()){

    $temp = array();
    foreach($data as $key => $value)
    {
        $temp["some_key.".$key] = $value;
    } 

    $collection->update(
        array('_id' => $id),
        array('$set' => $temp)
    );

}

_update('1', array('param2' => 'some data'));