src/Model/Attach.php

   1 <?php
   2
   3 /**
   4  * @file src/Model/Attach.php
   5  * @brief This file contains the Attach class for database interface
   6  */
   7 namespace Friendica\Model;
   8
   9 use Friendica\BaseObject;
  10 use Friendica\Core\StorageManager;
  11 use Friendica\Database\DBA;
  12 use Friendica\Database\DBStructure;
  13 use Friendica\Util\Security;
  14
  15
  16 /**
  17  * Class to handle attach dabatase table
  18  */
  19 class Attach extends BaseObject
  20 {
  21
  22         /**
  23          * @brief Return a list of fields that are associated with the attach table
  24          *
  25          * @return array field list
  26          */
  27         private static function getFields()
  28         {
  29                 $allfields = DBStructure::definition(false);
  30                 $fields = array_keys($allfields['attach']['fields']);
  31                 array_splice($fields, array_search('data', $fields), 1);
  32                 return $fields;
  33         }
  34
  35         /**
  36          * @brief Select rows from the attach table
  37          *
  38          * @param array  $fields     Array of selected fields, empty for all
  39          * @param array  $conditions Array of fields for conditions
  40          * @param array  $params     Array of several parameters
  41          *
  42          * @return boolean|array
  43          *
  44          * @see \Friendica\Database\DBA::select
  45          */
  46         public static function select(array $fields = [], array $conditions = [], array $params = [])
  47         {
  48                 if (empty($fields)) {
  49                         $selected = self::getFields();
  50                 }
  51
  52                 $r = DBA::select('attach', $fields, $conditions, $params);
  53                 return DBA::toArray($r);
  54         }
  55
  56         /**
  57          * @brief Retrieve a single record from the attach table
  58          *
  59          * @param array  $fields     Array of selected fields, empty for all
  60          * @param array  $conditions Array of fields for conditions
  61          * @param array  $params     Array of several parameters
  62          *
  63          * @return bool|array
  64          *
  65          * @see \Friendica\Database\DBA::select
  66          */
  67         public static function selectFirst(array $fields = [], array $conditions = [], array $params = [])
  68         {
  69                 if (empty($fields)) {
  70                         $fields = self::getFields();
  71                 }
  72
  73                 return DBA::selectFirst('attach', $fields, $conditions, $params);
  74         }
  75
  76         /**
  77          * @brief Check if attachment with given conditions exists
  78          *
  79          * @param array   $conditions  Array of extra conditions
  80          *
  81          * @return boolean
  82          */
  83         public static function exists(array $conditions)
  84         {
  85                 return DBA::exists('attach', $conditions);
  86         }
  87
  88         /**
  89          * @brief Retrive a single record given the ID
  90          *
  91          * @param int  $id  Row id of the record
  92          *
  93          * @return bool|array
  94          *
  95          * @see \Friendica\Database\DBA::select
  96          */
  97         public static function getById($id)
  98         {
  99                 return self::selectFirst([], ['id' => $id]);
 100         }
 101
 102         /**
 103          * @brief Retrive a single record given the ID
 104          *
 105          * @param int  $id  Row id of the record
 106          *
 107          * @return bool|array
 108          *
 109          * @see \Friendica\Database\DBA::select
 110          */
 111         public static function getByIdWithPermission($id)
 112         {
 113                 $r = self::selectFirst(['uid'], ['id' => $id]);
 114                 if ($r === false) {
 115                         return false;
 116                 }
 117
 118                 $sql_acl = Security::getPermissionsSQLByUserId($r['uid']);
 119
 120                 $conditions = [
 121                         '`id` = ?' . $sql_acl,
 122                         $id
 123                 ];
 124
 125                 $item = self::selectFirst([], $conditions);
 126
 127                 return $item;
 128         }
 129
 130         /**
 131          * @brief Get file data for given row id. null if row id does not exist
 132          *
 133          * @param array  $item  Attachment data. Needs at least 'id', 'backend-class', 'backend-ref'
 134          *
 135          * @return string  file data
 136          */
 137         public static function getData($item)
 138         {
 139                 if ($item['backend-class'] == '') {
 140                         // legacy data storage in 'data' column
 141                         $i = self::selectFirst(['data'], ['id' => $item['id']]);
 142                         if ($i === false) {
 143                                 return null;
 144                         }
 145                         return $i['data'];
 146                 } else {
 147                         $backendClass = $item['backend-class'];
 148                         $backendRef = $item['backend-ref'];
 149                         return $backendClass::get($backendRef);
 150                 }
 151         }
 152 }