/** * Saves a new or modified plugin to the storage. * * @param \Aimeos\MShop\Common\Item\Iface $item Plugin item * @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\\MShop\\Plugin\\Item\\Iface'; if (!$item instanceof $iface) { throw new \Aimeos\MShop\Plugin\Exception(sprintf('Object is not of required type "%1$s"', $iface)); } if (!$item->isModified()) { return; } $context = $this->getContext(); $dbm = $context->getDatabaseManager(); $dbname = $this->getResourceName(); $conn = $dbm->acquire($dbname); try { $id = $item->getId(); $date = date('Y-m-d H:i:s'); if ($id === null) { /** mshop/plugin/manager/standard/insert/mysql * Inserts a new plugin record into the database table * * @see mshop/plugin/manager/standard/insert/ansi */ /** mshop/plugin/manager/standard/insert/ansi * Inserts a new plugin 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 plugin 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 mshop/plugin/manager/standard/update/ansi * @see mshop/plugin/manager/standard/newid/ansi * @see mshop/plugin/manager/standard/delete/ansi * @see mshop/plugin/manager/standard/search/ansi * @see mshop/plugin/manager/standard/count/ansi */ $path = 'mshop/plugin/manager/standard/insert'; } else { /** mshop/plugin/manager/standard/update/mysql * Updates an existing plugin record in the database * * @see mshop/plugin/manager/standard/update/ansi */ /** mshop/plugin/manager/standard/update/ansi * Updates an existing plugin 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 plugin 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 mshop/plugin/manager/standard/insert/ansi * @see mshop/plugin/manager/standard/newid/ansi * @see mshop/plugin/manager/standard/delete/ansi * @see mshop/plugin/manager/standard/search/ansi * @see mshop/plugin/manager/standard/count/ansi */ $path = 'mshop/plugin/manager/standard/update'; } $stmt = $this->getCachedStatement($conn, $path); $stmt->bind(1, $context->getLocale()->getSiteId(), \Aimeos\MW\DB\Statement\Base::PARAM_INT); $stmt->bind(2, $item->getTypeId()); $stmt->bind(3, $item->getLabel()); $stmt->bind(4, $item->getProvider()); $stmt->bind(5, json_encode($item->getConfig())); $stmt->bind(6, $item->getPosition(), \Aimeos\MW\DB\Statement\Base::PARAM_INT); $stmt->bind(7, $item->getStatus(), \Aimeos\MW\DB\Statement\Base::PARAM_INT); $stmt->bind(8, $date); //mtime $stmt->bind(9, $context->getEditor()); if ($id !== null) { $stmt->bind(10, $id, \Aimeos\MW\DB\Statement\Base::PARAM_INT); $item->setId($id); } else { $stmt->bind(10, $date); //ctime } $stmt->execute()->finish(); if ($id === null && $fetch === true) { /** mshop/plugin/manager/standard/newid/mysql * Retrieves the ID generated by the database when inserting a new record * * @see mshop/plugin/manager/standard/newid/ansi */ /** mshop/plugin/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_mplu_id') * For SQL Server: * SELECT SCOPE_IDENTITY() * For Oracle: * SELECT "seq_mplu_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 mshop/plugin/manager/standard/insert/ansi * @see mshop/plugin/manager/standard/update/ansi * @see mshop/plugin/manager/standard/delete/ansi * @see mshop/plugin/manager/standard/search/ansi * @see mshop/plugin/manager/standard/count/ansi */ $path = 'mshop/plugin/manager/standard/newid'; $item->setId($this->newId($conn, $path)); } $this->plugins[$id] = $item; $dbm->release($conn, $dbname); } catch (\Exception $e) { $dbm->release($conn, $dbname); throw $e; } }