Merge pull request #17669 from seamuslee001/flexmailer_core
[civicrm-core.git] / CRM / Core / DAO / File.php
CommitLineData
e501603b 1<?php
c3fc2621 2
e501603b
TO
3/**
4 * @package CRM
ca5cec67 5 * @copyright CiviCRM LLC https://civicrm.org/licensing
e501603b
TO
6 *
7 * Generated from xml/schema/CRM/Core/File.xml
8 * DO NOT EDIT. Generated by CRM_Core_CodeGen
449c4e6b 9 * (GenCodeChecksum:99baae76a4c2bf505fa7e0c67706844b)
e501603b 10 */
c3fc2621 11
f41f0342 12/**
c3fc2621 13 * Database access object for the File entity.
f41f0342 14 */
e501603b 15class CRM_Core_DAO_File extends CRM_Core_DAO {
c3fc2621 16
e501603b 17 /**
f41f0342 18 * Static instance to hold the table name.
e501603b
TO
19 *
20 * @var string
21 */
fa45b5b9 22 public static $_tableName = 'civicrm_file';
c3fc2621 23
e501603b 24 /**
f41f0342 25 * Should CiviCRM log any modifications to this table in the civicrm_log table.
e501603b 26 *
c3fc2621 27 * @var bool
e501603b 28 */
fa45b5b9 29 public static $_log = TRUE;
c3fc2621 30
e501603b
TO
31 /**
32 * Unique ID
33 *
e6ca0a57 34 * @var int
e501603b
TO
35 */
36 public $id;
c3fc2621 37
e501603b
TO
38 /**
39 * Type of file (e.g. Transcript, Income Tax Return, etc). FK to civicrm_option_value.
40 *
e6ca0a57 41 * @var int
e501603b
TO
42 */
43 public $file_type_id;
c3fc2621 44
e501603b
TO
45 /**
46 * mime type of the document
47 *
48 * @var string
49 */
50 public $mime_type;
c3fc2621 51
e501603b
TO
52 /**
53 * uri of the file on disk
54 *
55 * @var string
56 */
57 public $uri;
c3fc2621 58
e501603b
TO
59 /**
60 * contents of the document
61 *
62 * @var mediumblob
63 */
64 public $document;
c3fc2621 65
e501603b
TO
66 /**
67 * Additional descriptive text regarding this attachment (optional).
68 *
69 * @var string
70 */
71 public $description;
c3fc2621 72
e501603b
TO
73 /**
74 * Date and time that this attachment was uploaded or written to server.
75 *
76 * @var datetime
77 */
78 public $upload_date;
c3fc2621 79
c3438d19
DA
80 /**
81 * FK to civicrm_contact, who uploaded this file
82 *
e6ca0a57 83 * @var int
c3438d19
DA
84 */
85 public $created_id;
ae2c7e00 86
e501603b 87 /**
f41f0342 88 * Class constructor.
e501603b 89 */
c3fc2621 90 public function __construct() {
e501603b
TO
91 $this->__table = 'civicrm_file';
92 parent::__construct();
93 }
c3fc2621 94
449c4e6b
CW
95 /**
96 * Returns localized title of this entity.
97 */
98 public static function getEntityTitle() {
99 return ts('Files');
100 }
101
c3438d19
DA
102 /**
103 * Returns foreign keys and entity references.
104 *
105 * @return array
106 * [CRM_Core_Reference_Interface]
107 */
ae2c7e00 108 public static function getReferenceColumns() {
c3438d19 109 if (!isset(Civi::$statics[__CLASS__]['links'])) {
fa45b5b9 110 Civi::$statics[__CLASS__]['links'] = static::createReferenceColumns(__CLASS__);
ae2c7e00 111 Civi::$statics[__CLASS__]['links'][] = new CRM_Core_Reference_Basic(self::getTableName(), 'created_id', 'civicrm_contact', 'id');
c3438d19
DA
112 CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'links_callback', Civi::$statics[__CLASS__]['links']);
113 }
114 return Civi::$statics[__CLASS__]['links'];
115 }
ae2c7e00 116
e501603b
TO
117 /**
118 * Returns all the column names of this table
119 *
120 * @return array
121 */
c3fc2621 122 public static function &fields() {
346aaaba 123 if (!isset(Civi::$statics[__CLASS__]['fields'])) {
c3fc2621
CW
124 Civi::$statics[__CLASS__]['fields'] = [
125 'id' => [
e501603b
TO
126 'name' => 'id',
127 'type' => CRM_Utils_Type::T_INT,
c3fc2621 128 'title' => ts('File ID'),
215b423e 129 'description' => ts('Unique ID'),
c3fc2621 130 'required' => TRUE,
a36434b9 131 'where' => 'civicrm_file.id',
522a26c9 132 'table_name' => 'civicrm_file',
133 'entity' => 'File',
134 'bao' => 'CRM_Core_BAO_File',
6a7e5e5d 135 'localizable' => 0,
c3fc2621
CW
136 ],
137 'file_type_id' => [
e501603b
TO
138 'name' => 'file_type_id',
139 'type' => CRM_Utils_Type::T_INT,
c3fc2621 140 'title' => ts('File Type'),
215b423e 141 'description' => ts('Type of file (e.g. Transcript, Income Tax Return, etc). FK to civicrm_option_value.'),
a36434b9 142 'where' => 'civicrm_file.file_type_id',
522a26c9 143 'table_name' => 'civicrm_file',
144 'entity' => 'File',
145 'bao' => 'CRM_Core_BAO_File',
6a7e5e5d 146 'localizable' => 0,
c3fc2621
CW
147 ],
148 'mime_type' => [
e501603b
TO
149 'name' => 'mime_type',
150 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 151 'title' => ts('Mime Type'),
215b423e 152 'description' => ts('mime type of the document'),
e501603b
TO
153 'maxlength' => 255,
154 'size' => CRM_Utils_Type::HUGE,
a36434b9 155 'where' => 'civicrm_file.mime_type',
522a26c9 156 'table_name' => 'civicrm_file',
157 'entity' => 'File',
158 'bao' => 'CRM_Core_BAO_File',
6a7e5e5d 159 'localizable' => 0,
c3fc2621
CW
160 ],
161 'uri' => [
e501603b
TO
162 'name' => 'uri',
163 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 164 'title' => ts('Path'),
215b423e 165 'description' => ts('uri of the file on disk'),
e501603b
TO
166 'maxlength' => 255,
167 'size' => CRM_Utils_Type::HUGE,
a36434b9 168 'where' => 'civicrm_file.uri',
522a26c9 169 'table_name' => 'civicrm_file',
170 'entity' => 'File',
171 'bao' => 'CRM_Core_BAO_File',
6a7e5e5d 172 'localizable' => 0,
c3fc2621
CW
173 ],
174 'document' => [
e501603b
TO
175 'name' => 'document',
176 'type' => CRM_Utils_Type::T_MEDIUMBLOB,
c3fc2621 177 'title' => ts('File Contents'),
215b423e 178 'description' => ts('contents of the document'),
a36434b9 179 'where' => 'civicrm_file.document',
522a26c9 180 'table_name' => 'civicrm_file',
181 'entity' => 'File',
182 'bao' => 'CRM_Core_BAO_File',
6a7e5e5d 183 'localizable' => 0,
c3fc2621
CW
184 ],
185 'description' => [
e501603b
TO
186 'name' => 'description',
187 'type' => CRM_Utils_Type::T_STRING,
c3fc2621 188 'title' => ts('File Description'),
215b423e 189 'description' => ts('Additional descriptive text regarding this attachment (optional).'),
e501603b
TO
190 'maxlength' => 255,
191 'size' => CRM_Utils_Type::HUGE,
a36434b9 192 'where' => 'civicrm_file.description',
522a26c9 193 'table_name' => 'civicrm_file',
194 'entity' => 'File',
195 'bao' => 'CRM_Core_BAO_File',
6a7e5e5d 196 'localizable' => 0,
c3fc2621
CW
197 ],
198 'upload_date' => [
e501603b
TO
199 'name' => 'upload_date',
200 'type' => CRM_Utils_Type::T_DATE + CRM_Utils_Type::T_TIME,
c3fc2621 201 'title' => ts('File Upload Date'),
215b423e 202 'description' => ts('Date and time that this attachment was uploaded or written to server.'),
a36434b9 203 'where' => 'civicrm_file.upload_date',
522a26c9 204 'table_name' => 'civicrm_file',
205 'entity' => 'File',
206 'bao' => 'CRM_Core_BAO_File',
6a7e5e5d 207 'localizable' => 0,
c3fc2621 208 ],
c3438d19
DA
209 'created_id' => [
210 'name' => 'created_id',
211 'type' => CRM_Utils_Type::T_INT,
ae2c7e00 212 'title' => ts('Created By Contact ID'),
215b423e 213 'description' => ts('FK to civicrm_contact, who uploaded this file'),
a36434b9 214 'where' => 'civicrm_file.created_id',
c3438d19
DA
215 'table_name' => 'civicrm_file',
216 'entity' => 'File',
217 'bao' => 'CRM_Core_BAO_File',
ae2c7e00 218 'localizable' => 0,
c3438d19
DA
219 'FKClassName' => 'CRM_Contact_DAO_Contact',
220 ],
c3fc2621 221 ];
346aaaba 222 CRM_Core_DAO_AllCoreTables::invoke(__CLASS__, 'fields_callback', Civi::$statics[__CLASS__]['fields']);
e501603b 223 }
346aaaba 224 return Civi::$statics[__CLASS__]['fields'];
e501603b 225 }
c3fc2621 226
e501603b 227 /**
bd8e0b14 228 * Return a mapping from field-name to the corresponding key (as used in fields()).
e501603b
TO
229 *
230 * @return array
bd8e0b14 231 * Array(string $name => string $uniqueName).
e501603b 232 */
c3fc2621 233 public static function &fieldKeys() {
bd8e0b14
TO
234 if (!isset(Civi::$statics[__CLASS__]['fieldKeys'])) {
235 Civi::$statics[__CLASS__]['fieldKeys'] = array_flip(CRM_Utils_Array::collect('name', self::fields()));
e501603b 236 }
bd8e0b14 237 return Civi::$statics[__CLASS__]['fieldKeys'];
e501603b 238 }
c3fc2621 239
e501603b
TO
240 /**
241 * Returns the names of this table
242 *
243 * @return string
244 */
c3fc2621 245 public static function getTableName() {
e501603b
TO
246 return self::$_tableName;
247 }
c3fc2621 248
e501603b
TO
249 /**
250 * Returns if this table needs to be logged
251 *
c3fc2621 252 * @return bool
e501603b 253 */
c3fc2621 254 public function getLog() {
e501603b
TO
255 return self::$_log;
256 }
c3fc2621 257
e501603b
TO
258 /**
259 * Returns the list of fields that can be imported
260 *
261 * @param bool $prefix
262 *
263 * @return array
264 */
c3fc2621
CW
265 public static function &import($prefix = FALSE) {
266 $r = CRM_Core_DAO_AllCoreTables::getImports(__CLASS__, 'file', $prefix, []);
60808919 267 return $r;
e501603b 268 }
c3fc2621 269
e501603b
TO
270 /**
271 * Returns the list of fields that can be exported
272 *
273 * @param bool $prefix
274 *
275 * @return array
276 */
c3fc2621
CW
277 public static function &export($prefix = FALSE) {
278 $r = CRM_Core_DAO_AllCoreTables::getExports(__CLASS__, 'file', $prefix, []);
60808919 279 return $r;
e501603b 280 }
c3fc2621 281
e7a6b91a
AS
282 /**
283 * Returns the list of indices
c3fc2621
CW
284 *
285 * @param bool $localize
286 *
287 * @return array
e7a6b91a
AS
288 */
289 public static function indices($localize = TRUE) {
c3fc2621 290 $indices = [];
e7a6b91a
AS
291 return ($localize && !empty($indices)) ? CRM_Core_DAO_AllCoreTables::multilingualize(__CLASS__, $indices) : $indices;
292 }
c3fc2621 293
e501603b 294}