1<?php 2 3/** 4 * webtrees: online genealogy 5 * Copyright (C) 2019 webtrees development team 6 * This program is free software: you can redistribute it and/or modify 7 * it under the terms of the GNU General Public License as published by 8 * the Free Software Foundation, either version 3 of the License, or 9 * (at your option) any later version. 10 * This program is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 * GNU General Public License for more details. 14 * You should have received a copy of the GNU General Public License 15 * along with this program. If not, see <http://www.gnu.org/licenses/>. 16 */ 17 18declare(strict_types=1); 19 20namespace Fisharebest\Webtrees; 21 22use League\Flysystem\Adapter\Local; 23use League\Flysystem\FileNotFoundException; 24use League\Flysystem\Filesystem; 25use League\Flysystem\FilesystemInterface; 26use League\Glide\Signatures\SignatureFactory; 27 28use function getimagesize; 29use function intdiv; 30use function pathinfo; 31use function strtolower; 32 33use const PATHINFO_EXTENSION; 34 35/** 36 * A GEDCOM media file. A media object can contain many media files, 37 * such as scans of both sides of a document, the transcript of an audio 38 * recording, etc. 39 */ 40class MediaFile 41{ 42 private const MIME_TYPES = [ 43 'bmp' => 'image/bmp', 44 'doc' => 'application/msword', 45 'docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 46 'ged' => 'text/x-gedcom', 47 'gif' => 'image/gif', 48 'html' => 'text/html', 49 'htm' => 'text/html', 50 'jpeg' => 'image/jpeg', 51 'jpg' => 'image/jpeg', 52 'mov' => 'video/quicktime', 53 'mp3' => 'audio/mpeg', 54 'mp4' => 'video/mp4', 55 'ogv' => 'video/ogg', 56 'pdf' => 'application/pdf', 57 'png' => 'image/png', 58 'rar' => 'application/x-rar-compressed', 59 'swf' => 'application/x-shockwave-flash', 60 'svg' => 'image/svg', 61 'tiff' => 'image/tiff', 62 'tif' => 'image/tiff', 63 'xls' => 'application/vnd-ms-excel', 64 'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 65 'wmv' => 'video/x-ms-wmv', 66 'zip' => 'application/zip', 67 ]; 68 69 private const SUPPORTED_IMAGE_MIME_TYPES = [ 70 'image/gif', 71 'image/jpeg', 72 'image/png', 73 ]; 74 75 /** @var string The filename */ 76 private $multimedia_file_refn = ''; 77 78 /** @var string The file extension; jpeg, txt, mp4, etc. */ 79 private $multimedia_format = ''; 80 81 /** @var string The type of document; newspaper, microfiche, etc. */ 82 private $source_media_type = ''; 83 /** @var string The filename */ 84 85 /** @var string The name of the document */ 86 private $descriptive_title = ''; 87 88 /** @var Media $media The media object to which this file belongs */ 89 private $media; 90 91 /** @var string */ 92 private $fact_id; 93 94 /** 95 * Create a MediaFile from raw GEDCOM data. 96 * 97 * @param string $gedcom 98 * @param Media $media 99 */ 100 public function __construct($gedcom, Media $media) 101 { 102 $this->media = $media; 103 $this->fact_id = md5($gedcom); 104 105 if (preg_match('/^\d FILE (.+)/m', $gedcom, $match)) { 106 $this->multimedia_file_refn = $match[1]; 107 $this->multimedia_format = pathinfo($match[1], PATHINFO_EXTENSION); 108 } 109 110 if (preg_match('/^\d FORM (.+)/m', $gedcom, $match)) { 111 $this->multimedia_format = $match[1]; 112 } 113 114 if (preg_match('/^\d TYPE (.+)/m', $gedcom, $match)) { 115 $this->source_media_type = $match[1]; 116 } 117 118 if (preg_match('/^\d TITL (.+)/m', $gedcom, $match)) { 119 $this->descriptive_title = $match[1]; 120 } 121 } 122 123 /** 124 * Get the format. 125 * 126 * @return string 127 */ 128 public function format(): string 129 { 130 return $this->multimedia_format; 131 } 132 133 /** 134 * Get the type. 135 * 136 * @return string 137 */ 138 public function type(): string 139 { 140 return $this->source_media_type; 141 } 142 143 /** 144 * Get the title. 145 * 146 * @return string 147 */ 148 public function title(): string 149 { 150 return $this->descriptive_title; 151 } 152 153 /** 154 * Get the fact ID. 155 * 156 * @return string 157 */ 158 public function factId(): string 159 { 160 return $this->fact_id; 161 } 162 163 /** 164 * @return bool 165 */ 166 public function isPendingAddition(): bool 167 { 168 foreach ($this->media->facts() as $fact) { 169 if ($fact->id() === $this->fact_id) { 170 return $fact->isPendingAddition(); 171 } 172 } 173 174 return false; 175 } 176 177 /** 178 * @return bool 179 */ 180 public function isPendingDeletion(): bool 181 { 182 foreach ($this->media->facts() as $fact) { 183 if ($fact->id() === $this->fact_id) { 184 return $fact->isPendingDeletion(); 185 } 186 } 187 188 return false; 189 } 190 191 /** 192 * Display an image-thumbnail or a media-icon, and add markup for image viewers such as colorbox. 193 * 194 * @param int $width Pixels 195 * @param int $height Pixels 196 * @param string $fit "crop" or "contain" 197 * @param string[] $image_attributes Additional HTML attributes 198 * 199 * @return string 200 */ 201 public function displayImage($width, $height, $fit, $image_attributes = []): string 202 { 203 if ($this->isExternal()) { 204 $src = $this->multimedia_file_refn; 205 $srcset = []; 206 } else { 207 // Generate multiple images for displays with higher pixel densities. 208 $src = $this->imageUrl($width, $height, $fit); 209 $srcset = []; 210 foreach ([2, 3, 4] as $x) { 211 $srcset[] = $this->imageUrl($width * $x, $height * $x, $fit) . ' ' . $x . 'x'; 212 } 213 } 214 215 if ($this->isImage()) { 216 $image = '<img ' . Html::attributes($image_attributes + [ 217 'dir' => 'auto', 218 'src' => $src, 219 'srcset' => implode(',', $srcset), 220 'alt' => strip_tags($this->media->fullName()), 221 ]) . '>'; 222 223 $link_attributes = Html::attributes([ 224 'class' => 'gallery', 225 'type' => $this->mimeType(), 226 'href' => $this->imageUrl(0, 0, 'contain'), 227 'data-title' => strip_tags($this->media->fullName()), 228 ]); 229 } else { 230 $image = view('icons/mime', ['type' => $this->mimeType()]); 231 232 $link_attributes = Html::attributes([ 233 'type' => $this->mimeType(), 234 'href' => $this->downloadUrl('inline'), 235 ]); 236 } 237 238 return '<a ' . $link_attributes . '>' . $image . '</a>'; 239 } 240 241 /** 242 * Is the media file actually a URL? 243 */ 244 public function isExternal(): bool 245 { 246 return strpos($this->multimedia_file_refn, '://') !== false; 247 } 248 249 /** 250 * Generate a URL for an image. 251 * 252 * @param int $width Maximum width in pixels 253 * @param int $height Maximum height in pixels 254 * @param string $fit "crop" or "contain" 255 * 256 * @return string 257 */ 258 public function imageUrl($width, $height, $fit): string 259 { 260 // Sign the URL, to protect against mass-resize attacks. 261 $glide_key = Site::getPreference('glide-key'); 262 if ($glide_key === '') { 263 $glide_key = bin2hex(random_bytes(128)); 264 Site::setPreference('glide-key', $glide_key); 265 } 266 267 if (Auth::accessLevel($this->media->tree()) > $this->media->tree()->getPreference('SHOW_NO_WATERMARK')) { 268 $mark = 'watermark.png'; 269 } else { 270 $mark = ''; 271 } 272 273 $params = [ 274 'xref' => $this->media->xref(), 275 'tree' => $this->media->tree()->name(), 276 'fact_id' => $this->fact_id, 277 'w' => $width, 278 'h' => $height, 279 'fit' => $fit, 280 'mark' => $mark, 281 'markh' => '100h', 282 'markw' => '100w', 283 'markalpha' => 25, 284 'or' => 0, 285 ]; 286 287 $signature = SignatureFactory::create($glide_key)->generateSignature('', $params); 288 289 $params = ['route' => '/media-thumbnail', 's' => $signature] + $params; 290 291 return route('media-thumbnail', $params); 292 } 293 294 /** 295 * Is the media file an image? 296 */ 297 public function isImage(): bool 298 { 299 return in_array($this->mimeType(), self::SUPPORTED_IMAGE_MIME_TYPES, true); 300 } 301 302 /** 303 * What is the mime-type of this object? 304 * For simplicity and efficiency, use the extension, rather than the contents. 305 * 306 * @return string 307 */ 308 public function mimeType(): string 309 { 310 $extension = strtolower(pathinfo($this->multimedia_file_refn, PATHINFO_EXTENSION)); 311 312 return self::MIME_TYPES[$extension] ?? 'application/octet-stream'; 313 } 314 315 /** 316 * Generate a URL to download a non-image media file. 317 * 318 * @param string $disposition How should the image be returned - "attachment" or "inline" 319 * 320 * @return string 321 */ 322 public function downloadUrl(string $disposition): string 323 { 324 return route('media-download', [ 325 'xref' => $this->media->xref(), 326 'tree' => $this->media->tree()->name(), 327 'fact_id' => $this->fact_id, 328 'disposition' => $disposition, 329 ]); 330 } 331 332 /** 333 * A list of image attributes 334 * 335 * @return string[] 336 */ 337 public function attributes(FilesystemInterface $data_filesystem): array 338 { 339 $attributes = []; 340 341 if (!$this->isExternal() || $this->fileExists($data_filesystem)) { 342 try { 343 $bytes = $this->media()->tree()->mediaFilesystem($data_filesystem)->getSize($this->filename()); 344 $kb = intdiv($bytes + 1023, 1024); 345 $attributes['__FILE_SIZE__'] = I18N::translate('%s KB', I18N::number($kb)); 346 } catch (FileNotFoundException $ex) { 347 // External/missing files have no size. 348 } 349 350 // Note: getAdapter() is defined on Filesystem, but not on FilesystemInterface. 351 $filesystem = $this->media()->tree()->mediaFilesystem($data_filesystem); 352 if ($filesystem instanceof Filesystem) { 353 $adapter = $filesystem->getAdapter(); 354 // Only works for local filesystems. 355 if ($adapter instanceof Local) { 356 $file = $adapter->applyPathPrefix($this->filename()); 357 [$width, $height] = getimagesize($file); 358 $attributes['__IMAGE_SIZE__'] = I18N::translate('%1$s × %2$s pixels', I18N::number($width), I18N::number($height)); 359 } 360 } 361 } 362 363 return $attributes; 364 } 365 366 /** 367 * Read the contents of a media file. 368 * 369 * @param FilesystemInterface $data_filesystem 370 * 371 * @return string 372 */ 373 public function fileContents(FilesystemInterface $data_filesystem): string 374 { 375 return $this->media->tree()->mediaFilesystem($data_filesystem)->read($this->multimedia_file_refn); 376 } 377 378 /** 379 * Check if the file exists on this server 380 * 381 * @param FilesystemInterface $data_filesystem 382 * 383 * @return bool 384 */ 385 public function fileExists(FilesystemInterface $data_filesystem): bool 386 { 387 return $this->media->tree()->mediaFilesystem($data_filesystem)->has($this->multimedia_file_refn); 388 } 389 390 /** 391 * @return Media 392 */ 393 public function media(): Media 394 { 395 return $this->media; 396 } 397 398 /** 399 * Get the filename. 400 * 401 * @return string 402 */ 403 public function filename(): string 404 { 405 return $this->multimedia_file_refn; 406 } 407 408 /** 409 * What file extension is used by this file? 410 * 411 * @return string 412 */ 413 public function extension(): string 414 { 415 return pathinfo($this->multimedia_file_refn, PATHINFO_EXTENSION); 416 } 417} 418