JDatabaseMySQL/insertObject
From Joomla! Documentation
< API16:JDatabaseMySQL
The "API16" namespace is an archived namespace. This page contains information for a Joomla! version which is no longer supported. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.
Description[edit]
Inserts a row into a table based on an objects properties
Template:Description:JDatabaseMySQL/insertObject
Syntax[edit]
insertObject($table, &$object, $keyName=NULL)
Parameter Name | Default Value | Description |
---|---|---|
$table | The name of the table | |
&$object | An object whose properties match table fields | |
$keyName | NULL | The name of the primary key. If provided the object property is updated. |
Defined in[edit]
libraries/joomla/database/database/mysql.php
Importing[edit]
jimport( 'joomla.database.database.mysql' );
Source Body[edit]
public function insertObject($table, &$object, $keyName = NULL)
{
$fmtsql = 'INSERT INTO '.$this->nameQuote($table).' (%s) VALUES (%s) ';
$fields = array();
foreach (get_object_vars($object) as $k => $v) {
if (is_array($v) or is_object($v) or $v === NULL) {
continue;
}
if ($k[0] == '_') { // internal field
continue;
}
$fields[] = $this->nameQuote($k);
$values[] = $this->isQuoted($k) ? $this->Quote($v) : (int) $v;
}
$this->setQuery(sprintf($fmtsql, implode(",", $fields) , implode(",", $values)));
if (!$this->query()) {
return false;
}
$id = $this->insertid();
if ($keyName && $id) {
$object->$keyName = $id;
}
return true;
}
[Edit See Also] Template:SeeAlso:JDatabaseMySQL/insertObject
Examples[edit]
<CodeExamplesForm />