->insert()

説明

現在のオブジェクトの偏す打ちに基づいたデータをデータベースに挿入し、 もし、シーケンスや主キーが使用される場合、挿入された要素のIDを返します。 値は完全にクオートされ、 いくつかの制限された型のチェックは行われています。

MySQLでは mysql_next_id() メソッドが使用され、 他のデータベースでは、PEAR DB の sequence メソッドが使用されます。

注意： insert() メソッドはいくつかの状況では ID を正しく返さないかも知れません。

• データベースバックエンドがサポートしていない場合

• 生成スクリプトが正しいカラムを自動インクリメント/nextvalとしてマークしなかった場合

• 何らかのエラーが発生した場合 (デバッグモードで確認することができます)

• 挿入に失敗、あるいは '0' 行に影響を与えた場合

返り値

mixed - Id あるいは キーを指定します。

例外・エラー

注意

この関数は、スタティックにコールする ことはできません。

例

<?php
$person = new DataObjects_Person;
$person->name='fred';
$id = $person->insert();
?>

<?php
INSERT INTO person (name) VALUES ('fred');
?>