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 the URI gets too long we only take the first parts and hope for best
  39                 $uri = substr($fields['uri'], 0, 255);
  40
  41                 if (!DBA::exists('item-uri', ['uri' => $uri])) {
  42                         DBA::insert('item-uri', $fields, Database::INSERT_UPDATE);
  43                 }
  44
  45                 $itemuri = DBA::selectFirst('item-uri', ['id', 'guid'], ['uri' => $uri]);
  46
  47                 if (!DBA::isResult($itemuri)) {
  48                         // This shouldn't happen
  49                         return null;
  50                 }
  51
  52                 if (empty($itemuri['guid']) && !empty($fields['guid'])) {
  53                         DBA::update('item-uri', ['guid' => $fields['guid']], ['id' => $itemuri['id']]);
  54                 }
  55
  56                 return $itemuri['id'];
  57         }
  58
  59         /**
  60          * Searched for an id of a given uri. Adds it, if not existing yet.
  61          *
  62          * @param string $uri
  63          * @param bool   $insert
  64          *
  65          * @return integer item-uri id
  66          *
  67          * @throws \Exception
  68          */
  69         public static function getIdByURI(string $uri, bool $insert = true): int
  70         {
  71                 if (empty($uri)) {
  72                         return 0;
  73                 }
  74
  75                 // If the URI gets too long we only take the first parts and hope for best
  76                 $uri = substr($uri, 0, 255);
  77
  78                 $itemuri = DBA::selectFirst('item-uri', ['id'], ['uri' => $uri]);
  79
  80                 if (!DBA::isResult($itemuri) && $insert) {
  81                         return self::insert(['uri' => $uri]);
  82                 }
  83
  84                 return $itemuri['id'] ?? 0;
  85         }
  86
  87         /**
  88          * Searched for an id of a given guid.
  89          *
  90          * @param string $guid
  91          * @return integer item-uri id
  92          * @throws \Exception
  93          */
  94         public static function getIdByGUID(string $guid): int
  95         {
  96                 // If the GUID gets too long we only take the first parts and hope for best
  97                 $guid = substr($guid, 0, 255);
  98
  99                 $itemuri = DBA::selectFirst('item-uri', ['id'], ['guid' => $guid]);
 100
 101                 if (!DBA::isResult($itemuri)) {
 102                         return 0;
 103                 }
 104
 105                 return $itemuri['id'];
 106         }
 107 }