->insert()
->insert() – 現在のオブジェクト変数をデータベースに挿入する
Synopsis
mixed $DB_DataObject->insert (
)
Description
現在のオブジェクトの偏す打ちに基づいたデータをデータベースに挿入し、 もし、シーケンスや主キーが使用される場合、挿入された要素のIDを返します。 値は完全にクオートされ、 いくつかの制限された型のチェックは行われています。
MySQLでは mysql_next_id() メソッドが使用され、 他のデータベースでは、PEAR DB の sequence メソッドが使用されます。
注意： insert() メソッドはいくつかの状況では ID を正しく返さないかも知れません。
-
データベースバックエンドがサポートしていない場合
-
生成スクリプトが正しいカラムを自動インクリメント/nextvalとしてマークしなかった場合
-
何らかのエラーが発生した場合 (デバッグモードで確認することができます)
-
挿入に失敗、あるいは '0' 行に影響を与えた場合
Return value
mixed - Id あるいは キーを指定します。
Throws
| エラーコード | エラーメッセージ | 意味 | 解決策 |
|---|---|---|---|
| DB_DATAOBJECT_ERROR_INVALIDCONFIG | "挿入:$table の定義がありません" | ||
| DB_DATAOBJECT_ERROR_NODATA | "挿入:クエリにデータが指定されていません" | ||
| DB_* | * | PEAR::DB を参照してください | PEAR::DB を参照してください |
Note
This function can not be called statically.
Example
簡単な挿入
<?php
$person = new DataObjects_Person;
$person->name='fred';
$id = $person->insert();
?>
結果の SQL
<?php
INSERT INTO person (name) VALUES ('fred');
?>
忘却曲線を使ってこの知識を確実に記憶に残す
