+
+ /**
+ * Retrieve a single record from the starting post in the item table and returns it in an associative array
+ *
+ * @param integer $uid User ID
+ * @param array $selected
+ * @param array $condition
+ * @param array $params
+ * @return bool|array
+ * @throws \Exception
+ * @see DBA::select
+ */
+ public static function selectFirstThreadForUser($uid, array $selected = [], array $condition = [], $params = [])
+ {
+ $params['limit'] = 1;
+
+ $result = self::selectThreadForUser($uid, $selected, $condition, $params);
+
+ if (is_bool($result)) {
+ return $result;
+ } else {
+ $row = self::fetch($result);
+ DBA::close($result);
+ return $row;
+ }
+ }
+
+ /**
+ * Select pinned rows from the item table for a given user
+ *
+ * @param integer $uid User ID
+ * @param array $selected Array of selected fields, empty for all
+ * @param array $condition Array of fields for condition
+ * @param array $params Array of several parameters
+ *
+ * @return boolean|object
+ * @throws \Exception
+ */
+ public static function selectPinned(int $uid, array $selected = [], array $condition = [], $params = [])
+ {
+ $useritems = DBA::select('user-item', ['iid'], ['uid' => $uid, 'pinned' => true]);
+ if (!DBA::isResult($useritems)) {
+ return $useritems;
+ }
+
+ $pinned = [];
+ while ($useritem = DBA::fetch($useritems)) {
+ $pinned[] = $useritem['iid'];
+ }
+ DBA::close($useritems);
+
+ if (empty($pinned)) {
+ return [];
+ }
+
+ $condition = DBA::mergeConditions(['iid' => $pinned], $condition);
+
+ return self::selectThreadForUser($uid, $selected, $condition, $params);
+ }
+
+ /**
+ * Update existing post entries
+ *
+ * @param array $fields The fields that are to be changed
+ * @param array $condition The condition for finding the item entries
+ *
+ * A return value of "0" doesn't mean an error - but that 0 rows had been changed.
+ *
+ * @return integer|boolean number of affected rows - or "false" if there was an error
+ * @throws \Friendica\Network\HTTPException\InternalServerErrorException
+ */
+ public static function update(array $fields, array $condition)
+ {
+ $affected = 0;
+
+ Logger::info('Start Update', ['fields' => $fields, 'condition' => $condition]);
+
+ // Don't allow changes to fields that are responsible for the relation between the records
+ unset($fields['id']);
+ unset($fields['parent']);
+ unset($fields['uid']);
+ unset($fields['uri']);
+ unset($fields['uri-id']);
+ unset($fields['thr-parent']);
+ unset($fields['thr-parent-id']);
+ unset($fields['parent-uri']);
+ unset($fields['parent-uri-id']);
+
+ // To ensure the data integrity we do it in an transaction
+ DBA::transaction();
+
+ $update_fields = DBStructure::getFieldsForTable('post-user', $fields);
+ if (!empty($update_fields)) {
+ $rows = DBA::selectToArray('post-view', ['post-user-id'], $condition);
+ $puids = array_column($rows, 'post-user-id');
+ if (!DBA::update('post-user', $update_fields, ['id' => $puids])) {
+ DBA::rollback();
+ Logger::notice('Updating post-user failed', ['fields' => $update_fields, 'condition' => $condition]);
+ return false;
+ }
+ $affected = DBA::affectedRows();
+ }
+
+ $update_fields = DBStructure::getFieldsForTable('post-content', $fields);
+ if (!empty($update_fields)) {
+ $rows = DBA::selectToArray('post-view', ['uri-id'], $condition, ['group_by' => ['uri-id']]);
+ $uriids = array_column($rows, 'uri-id');
+ if (!DBA::update('post-content', $update_fields, ['uri-id' => $uriids])) {
+ DBA::rollback();
+ Logger::notice('Updating post-content failed', ['fields' => $update_fields, 'condition' => $condition]);
+ return false;
+ }
+ $affected = max($affected, DBA::affectedRows());
+ }
+
+ $update_fields = Post\DeliveryData::extractFields($fields);
+ if (!empty($update_fields)) {
+ if (empty($uriids)) {
+ $rows = DBA::selectToArray('post-view', ['uri-id'], $condition, ['group_by' => ['uri-id']]);
+ $uriids = array_column($rows, 'uri-id');
+ }
+ if (!DBA::update('post-delivery-data', $update_fields, ['uri-id' => $uriids])) {
+ DBA::rollback();
+ Logger::notice('Updating post-delivery-data failed', ['fields' => $update_fields, 'condition' => $condition]);
+ return false;
+ }
+ $affected = max($affected, DBA::affectedRows());
+ }
+
+ $update_fields = DBStructure::getFieldsForTable('thread', $fields);
+ if (!empty($update_fields)) {
+ $rows = DBA::selectToArray('post-view', ['id'], $condition);
+ $ids = array_column($rows, 'id');
+ if (!DBA::update('thread', $update_fields, ['iid' => $ids])) {
+ DBA::rollback();
+ Logger::notice('Updating thread failed', ['fields' => $update_fields, 'condition' => $condition]);
+ return false;
+ }
+ $affected = max($affected, DBA::affectedRows());
+ }
+
+ $item_fields = ['guid', 'type', 'wall', 'gravity', 'extid', 'created', 'edited', 'commented', 'received', 'changed',
+ 'resource-id', 'post-type', 'private', 'pubmail', 'moderated', 'visible', 'starred', 'bookmark',
+ 'unseen', 'deleted', 'origin', 'forum_mode', 'mention', 'global', 'network', 'vid', 'psid',
+ 'contact-id', 'author-id', 'owner-id', 'causer-id', 'event-id'];
+
+ $update_fields = [];
+ foreach ($item_fields as $field) {
+ if (array_key_exists($field, $fields)) {
+ $update_fields[$field] = $fields[$field];
+ }
+ }
+ if (!empty($update_fields)) {
+ if (empty($ids)) {
+ $rows = DBA::selectToArray('post-view', ['id'], $condition, []);
+ $ids = array_column($rows, 'id');
+ }
+ if (!DBA::update('item', $update_fields, ['id' => $ids])) {
+ DBA::rollback();
+ Logger::notice('Updating item failed', ['fields' => $update_fields, 'condition' => $condition]);
+ return false;
+ }
+ $affected = max($affected, DBA::affectedRows());
+ }
+
+ DBA::commit();
+
+ Logger::info('Updated posts', ['rows' => $affected]);
+ return $affected;
+ }