Actions

API16

JDatabaseMySQLi/insertObject

From Joomla! Documentation

< API16:JDatabaseMySQLi
Revision as of 22:02, 12 May 2013 by JoomlaWikiBot (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Replacement filing cabinet.png
This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.

Contents

Description

Inserts a row into a table based on an objects properties

[<! removed edit link to red link >]

<! removed transcluded page call, red link never existed >

Syntax

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

libraries/joomla/database/database/mysqli.php

Importing

jimport( 'joomla.database.database.mysqli' );

Source Body

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;
}

[<! removed edit link to red link >] <! removed transcluded page call, red link never existed >

Examples

<CodeExamplesForm />