src/Model/ItemURI.php

   1 <?php
   2 /**
   3  * @copyright Copyright (C) 2010-2022, the Friendica project
   4  *
   5  * @license GNU AGPL version 3 or any later version
   6  *
   7  * This program is free software: you can redistribute it and/or modify
   8  * it under the terms of the GNU Affero General Public License as
   9  * published by the Free Software Foundation, either version 3 of the
  10  * License, or (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU Affero General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Affero General Public License
  18  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  19  *
  20  */
  21
  22 namespace Friendica\Model;
  23
  24 use Friendica\Database\Database;
  25 use Friendica\Database\DBA;
  26
  27 class ItemURI
  28 {
  29         /**
  30          * Insert an item-uri record and return its id
  31          *
  32          * @param array $fields Item-uri fields
  33          * @return int|null item-uri id
  34          * @throws \Exception
  35          */
  36         public static function insert(array $fields)
  37         {
  38                 if (!DBA::exists('item-uri', ['uri' => $fields['uri']])) {
  39                         DBA::insert('item-uri', $fields, Database::INSERT_UPDATE);
  40                 }
  41
  42                 $itemuri = DBA::selectFirst('item-uri', ['id', 'guid'], ['uri' => $fields['uri']]);
  43
  44                 if (!DBA::isResult($itemuri)) {
  45                         // This shouldn't happen
  46                         return null;
  47                 }
  48
  49                 if (empty($itemuri['guid']) && !empty($fields['guid'])) {
  50                         DBA::update('item-uri', ['guid' => $fields['guid']], ['id' => $itemuri['id']]);
  51                 }
  52
  53                 return $itemuri['id'];
  54         }
  55
  56         /**
  57          * Searched for an id of a given uri. Adds it, if not existing yet.
  58          *
  59          * @param string $uri
  60          * @param bool   $insert
  61          *
  62          * @return integer item-uri id
  63          *
  64          * @throws \Exception
  65          */
  66         public static function getIdByURI(string $uri, bool $insert = true): int
  67         {
  68                 if (empty($uri)) {
  69                         return 0;
  70                 }
  71
  72                 $itemuri = DBA::selectFirst('item-uri', ['id'], ['uri' => $uri]);
  73
  74                 if (!DBA::isResult($itemuri) && $insert) {
  75                         return self::insert(['uri' => $uri]);
  76                 }
  77
  78                 return $itemuri['id'] ?? 0;
  79         }
  80
  81         /**
  82          * Searched for an id of a given guid.
  83          *
  84          * @param string $guid
  85          * @return integer item-uri id
  86          * @throws \Exception
  87          */
  88         public static function getIdByGUID(string $guid): int
  89         {
  90                 $itemuri = DBA::selectFirst('item-uri', ['id'], ['guid' => $guid]);
  91
  92                 if (!DBA::isResult($itemuri)) {
  93                         return 0;
  94                 }
  95
  96                 return $itemuri['id'];
  97         }
  98 }