MediaWiki  master
MWFileProps.php
Go to the documentation of this file.
1 <?php
28 class MWFileProps {
30  private $magic;
31 
35  public function __construct( MimeAnalyzer $magic ) {
36  $this->magic = $magic;
37  }
38 
63  public function getPropsFromPath( $path, $ext ) {
64  $fsFile = new FSFile( $path );
65 
66  $info = $this->newPlaceholderProps();
67  $info['fileExists'] = $fsFile->exists();
68  if ( $info['fileExists'] ) {
69  $info['size'] = $fsFile->getSize(); // bytes
70  $info['sha1'] = $fsFile->getSha1Base36();
71 
72  # MIME type according to file contents
73  $info['file-mime'] = $this->magic->guessMimeType( $path, false );
74  # Logical MIME type
76  $info['mime'] = $this->magic->improveTypeFromExtension( $info['file-mime'], $ext );
77 
78  list( $info['major_mime'], $info['minor_mime'] ) = File::splitMime( $info['mime'] );
79  $info['media_type'] = $this->magic->getMediaType( $path, $info['mime'] );
80 
81  # Height, width and metadata
82  $handler = MediaHandler::getHandler( $info['mime'] );
83  if ( $handler ) {
84  $info['metadata'] = $handler->getMetadata( $fsFile, $path );
85  // @phan-suppress-next-line PhanParamTooMany
86  $gis = $handler->getImageSize( $fsFile, $path, $info['metadata'] );
87  if ( is_array( $gis ) ) {
88  $info = $this->extractImageSizeInfo( $gis ) + $info;
89  }
90  }
91  }
92 
93  return $info;
94  }
95 
102  private function extractImageSizeInfo( array $gis ) {
103  $info = [];
104  # NOTE: $gis[2] contains a code for the image type. This is no longer used.
105  $info['width'] = $gis[0];
106  $info['height'] = $gis[1];
107  $info['bits'] = $gis['bits'] ?? 0;
108 
109  return $info;
110  }
111 
132  public function newPlaceholderProps() {
133  return FSFile::placeholderProps() + [
134  'metadata' => '',
135  'width' => 0,
136  'height' => 0,
137  'bits' => 0,
138  'media_type' => MEDIATYPE_UNKNOWN
139  ];
140  }
141 }
static extensionFromPath( $path, $case='lowercase')
Get the final extension from a storage or FS path.
const MEDIATYPE_UNKNOWN
Definition: defines.php:26
getPropsFromPath( $path, $ext)
Get an associative array containing information about a file with the given storage path...
Definition: MWFileProps.php:63
__construct(MimeAnalyzer $magic)
Definition: MWFileProps.php:35
static placeholderProps()
Placeholder file properties to use for files that don&#39;t exist.
Definition: FSFile.php:150
extractImageSizeInfo(array $gis)
Exract image size information.
newPlaceholderProps()
Empty place holder props for non-existing files.
Class representing a non-directory file on the file system.
Definition: FSFile.php:32
MimeAnalyzer $magic
Definition: MWFileProps.php:30
if(!is_readable( $file)) $ext
Definition: router.php:48
MimeMagic helper wrapper.
Definition: MWFileProps.php:28
static splitMime( $mime)
Split an internet media type into its two components; if not a two-part name, set the minor type to &#39;...
Definition: File.php:283
static getHandler( $type)
Get a MediaHandler for a given MIME type from the instance cache.
return true
Definition: router.php:92