Example #1
0
 /**
  * Adds a new log to the storage.
  *
  * @param \Aimeos\MAdmin\Log\Item\Iface $item Log item that should be saved to the storage
  * @param boolean $fetch True if the new ID should be returned in the item
  */
 public function saveItem(\Aimeos\MShop\Common\Item\Iface $item, $fetch = true)
 {
     $iface = '\\Aimeos\\MAdmin\\Log\\Item\\Iface';
     if (!$item instanceof $iface) {
         throw new \Aimeos\MAdmin\Log\Exception(sprintf('Object is not of required type "%1$s"', $iface));
     }
     if (!$item->isModified()) {
         return;
     }
     $context = $this->getContext();
     try {
         $siteid = $context->getLocale()->getSiteId();
     } catch (\Exception $e) {
         $siteid = null;
     }
     $dbm = $context->getDatabaseManager();
     $dbname = $this->getResourceName();
     $conn = $dbm->acquire($dbname);
     try {
         $id = $item->getId();
         if ($id === null) {
             /** madmin/log/manager/standard/insert/mysql
              * Inserts a new log record into the database table
              *
              * @see madmin/log/manager/standard/insert/ansi
              */
             /** madmin/log/manager/standard/insert/ansi
              * Inserts a new log record into the database table
              *
              * Items with no ID yet (i.e. the ID is NULL) will be created in
              * the database and the newly created ID retrieved afterwards
              * using the "newid" SQL statement.
              *
              * The SQL statement must be a string suitable for being used as
              * prepared statement. It must include question marks for binding
              * the values from the log item to the statement before they are
              * sent to the database server. The number of question marks must
              * be the same as the number of columns listed in the INSERT
              * statement. The order of the columns must correspond to the
              * order in the saveItems() method, so the correct values are
              * bound to the columns.
              *
              * The SQL statement should conform to the ANSI standard to be
              * compatible with most relational database systems. This also
              * includes using double quotes for table and column names.
              *
              * @param string SQL statement for inserting records
              * @since 2014.03
              * @category Developer
              * @see madmin/log/manager/standard/update/ansi
              * @see madmin/log/manager/standard/newid/ansi
              * @see madmin/log/manager/standard/delete/ansi
              * @see madmin/log/manager/standard/search/ansi
              * @see madmin/log/manager/standard/count/ansi
              */
             $path = 'madmin/log/manager/standard/insert';
         } else {
             /** madmin/log/manager/standard/update/mysql
              * Updates an existing log record in the database
              *
              * @see madmin/log/manager/standard/update/ansi
              */
             /** madmin/log/manager/standard/update/ansi
              * Updates an existing log record in the database
              *
              * Items which already have an ID (i.e. the ID is not NULL) will
              * be updated in the database.
              *
              * The SQL statement must be a string suitable for being used as
              * prepared statement. It must include question marks for binding
              * the values from the log item to the statement before they are
              * sent to the database server. The order of the columns must
              * correspond to the order in the saveItems() method, so the
              * correct values are bound to the columns.
              *
              * The SQL statement should conform to the ANSI standard to be
              * compatible with most relational database systems. This also
              * includes using double quotes for table and column names.
              *
              * @param string SQL statement for updating records
              * @since 2014.03
              * @category Developer
              * @see madmin/log/manager/standard/insert/ansi
              * @see madmin/log/manager/standard/newid/ansi
              * @see madmin/log/manager/standard/delete/ansi
              * @see madmin/log/manager/standard/search/ansi
              * @see madmin/log/manager/standard/count/ansi
              */
             $path = 'madmin/log/manager/standard/update';
         }
         $stmt = $this->getCachedStatement($conn, $path);
         $stmt->bind(1, $siteid, \Aimeos\MW\DB\Statement\Base::PARAM_INT);
         $stmt->bind(2, $item->getFacility());
         $stmt->bind(3, date('Y-m-d H:i:s'));
         $stmt->bind(4, $item->getPriority(), \Aimeos\MW\DB\Statement\Base::PARAM_INT);
         $stmt->bind(5, $item->getMessage());
         $stmt->bind(6, $item->getRequest());
         if ($item->getId() !== null) {
             $stmt->bind(7, $item->getId(), \Aimeos\MW\DB\Statement\Base::PARAM_INT);
             $item->setId($id);
         }
         $stmt->execute()->finish();
         if ($id === null && $fetch === true) {
             /** madmin/log/manager/standard/newid/mysql
              * Retrieves the ID generated by the database when inserting a new record
              *
              * @see madmin/log/manager/standard/newid/ansi
              */
             /** madmin/log/manager/standard/newid/ansi
              * Retrieves the ID generated by the database when inserting a new record
              *
              * As soon as a new record is inserted into the database table,
              * the database server generates a new and unique identifier for
              * that record. This ID can be used for retrieving, updating and
              * deleting that specific record from the table again.
              *
              * For MySQL:
              *  SELECT LAST_INSERT_ID()
              * For PostgreSQL:
              *  SELECT currval('seq_malog_id')
              * For SQL Server:
              *  SELECT SCOPE_IDENTITY()
              * For Oracle:
              *  SELECT "seq_malog_id".CURRVAL FROM DUAL
              *
              * There's no way to retrive the new ID by a SQL statements that
              * fits for most database servers as they implement their own
              * specific way.
              *
              * @param string SQL statement for retrieving the last inserted record ID
              * @since 2014.03
              * @category Developer
              * @see madmin/log/manager/standard/insert/ansi
              * @see madmin/log/manager/standard/update/ansi
              * @see madmin/log/manager/standard/delete/ansi
              * @see madmin/log/manager/standard/search/ansi
              * @see madmin/log/manager/standard/count/ansi
              */
             $path = 'madmin/log/manager/standard/newid';
             $item->setId($this->newId($conn, $path));
         }
         $dbm->release($conn, $dbname);
     } catch (\Exception $e) {
         $dbm->release($conn, $dbname);
         throw $e;
     }
 }