->update()
->update() – オブジェクト変数でデータベースを更新する
Synopsis
int $DB_DataObject->update (
dataobject|boolean $original|$useWhere
)
Description
現在のオブジェクト変数でデータベースを更新します。 もしデータオブジェクトを引数として提供した場合、 新旧データの間での違いだけが更新されます。
引数に DB_DATAOBJECT_WHEREADD_ONLY のみを指定してコールした場合は、 主キーではなく whereAdd の値に基づいてクエリが構築されます。 これを使用すると、一行ずつの更新ではなく複数レコードの一括更新が可能となります。
Parameter
-
DataObject $original - 現在のデータオブジェクトとオリジナルとの違いから、 更新クエリが構築されるかどうかを指定します。
Return value
int 作用した行数、あるいは失敗した場合 FALSE
Throws
| エラーコード | エラーメッセージ | 意味 | 解決策 |
|---|---|---|---|
| DB_DATAOBJECT_ERROR_INVALIDCONFIG | "更新:$table の定義がありません" | ||
| DB_DATAOBJECT_ERROR_NODATA | "更新:クエリ $settings にデータが指定されていません" |
Note
This function can not be called statically.
Example
単純なフェッチと更新
<?php
$person = new DataObjects_Person;
$person->get(12);
$person->name='fred';
$person->update();
$person = new DataObjects_Person;
$person->get(12);
$original = clone($person); // clone is emulated in php4 for compatibility reasons.
$person->name='fred';
$person->update($original);
?>
結果の SQL
SELECT * FROM person WHERE id = 12
UPDATE person SET name='fred', age='21', eyes='blue' WHERE id = 12
SELECT * FROM person WHERE id = 12
UPDATE person SET name='fred' WHERE id = 12
単純なフェッチと更新
<?php
$person = new DataObjects_Person;
$person->removed=1;
$person->whereAdd('age > 21');
$person->update();
?>
結果の SQL
SELECT * FROM person WHERE id = 12;
UPDATE person SET removed=1 WHERE age > 21
忘却曲線を使ってこの知識を確実に記憶に残す
