¿Cómo actualizo parcialmente un objeto en MongoDB para que el nuevo objeto se superponga/fusione con el existente?

Lo resolví con mi propia función. Si desea actualizar un campo específico en el documento, debe abordarlo claramente.

Ejemplo:

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

Si desea actualizar solo param2, está mal hacerlo:

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

Debe utilizar:

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

Así que escribí una función algo así:

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'));