MediaWiki  1.28.0
TransformationalImageHandler.php
Go to the documentation of this file.
1 <?php
29 
44  function normaliseParams( $image, &$params ) {
45  if ( !parent::normaliseParams( $image, $params ) ) {
46  return false;
47  }
48 
49  # Obtain the source, pre-rotation dimensions
50  $srcWidth = $image->getWidth( $params['page'] );
51  $srcHeight = $image->getHeight( $params['page'] );
52 
53  # Don't make an image bigger than the source
54  if ( $params['physicalWidth'] >= $srcWidth ) {
55  $params['physicalWidth'] = $srcWidth;
56  $params['physicalHeight'] = $srcHeight;
57 
58  # Skip scaling limit checks if no scaling is required
59  # due to requested size being bigger than source.
60  if ( !$image->mustRender() ) {
61  return true;
62  }
63  }
64 
65  return true;
66  }
67 
80  public function extractPreRotationDimensions( $params, $rotation ) {
81  if ( $rotation == 90 || $rotation == 270 ) {
82  # We'll resize before rotation, so swap the dimensions again
83  $width = $params['physicalHeight'];
84  $height = $params['physicalWidth'];
85  } else {
86  $width = $params['physicalWidth'];
87  $height = $params['physicalHeight'];
88  }
89 
90  return [ $width, $height ];
91  }
92 
106  function doTransform( $image, $dstPath, $dstUrl, $params, $flags = 0 ) {
107  if ( !$this->normaliseParams( $image, $params ) ) {
108  return new TransformParameterError( $params );
109  }
110 
111  # Create a parameter array to pass to the scaler
112  $scalerParams = [
113  # The size to which the image will be resized
114  'physicalWidth' => $params['physicalWidth'],
115  'physicalHeight' => $params['physicalHeight'],
116  'physicalDimensions' => "{$params['physicalWidth']}x{$params['physicalHeight']}",
117  # The size of the image on the page
118  'clientWidth' => $params['width'],
119  'clientHeight' => $params['height'],
120  # Comment as will be added to the Exif of the thumbnail
121  'comment' => isset( $params['descriptionUrl'] )
122  ? "File source: {$params['descriptionUrl']}"
123  : '',
124  # Properties of the original image
125  'srcWidth' => $image->getWidth(),
126  'srcHeight' => $image->getHeight(),
127  'mimeType' => $image->getMimeType(),
128  'dstPath' => $dstPath,
129  'dstUrl' => $dstUrl,
130  'interlace' => isset( $params['interlace'] ) ? $params['interlace'] : false,
131  ];
132 
133  if ( isset( $params['quality'] ) && $params['quality'] === 'low' ) {
134  $scalerParams['quality'] = 30;
135  }
136 
137  // For subclasses that might be paged.
138  if ( $image->isMultipage() && isset( $params['page'] ) ) {
139  $scalerParams['page'] = intval( $params['page'] );
140  }
141 
142  # Determine scaler type
143  $scaler = $this->getScalerType( $dstPath );
144 
145  if ( is_array( $scaler ) ) {
146  $scalerName = get_class( $scaler[0] );
147  } else {
148  $scalerName = $scaler;
149  }
150 
151  wfDebug( __METHOD__ . ": creating {$scalerParams['physicalDimensions']} " .
152  "thumbnail at $dstPath using scaler $scalerName\n" );
153 
154  if ( !$image->mustRender() &&
155  $scalerParams['physicalWidth'] == $scalerParams['srcWidth']
156  && $scalerParams['physicalHeight'] == $scalerParams['srcHeight']
157  && !isset( $scalerParams['quality'] )
158  ) {
159 
160  # normaliseParams (or the user) wants us to return the unscaled image
161  wfDebug( __METHOD__ . ": returning unscaled image\n" );
162 
163  return $this->getClientScalingThumbnailImage( $image, $scalerParams );
164  }
165 
166  if ( $scaler == 'client' ) {
167  # Client-side image scaling, use the source URL
168  # Using the destination URL in a TRANSFORM_LATER request would be incorrect
169  return $this->getClientScalingThumbnailImage( $image, $scalerParams );
170  }
171 
172  if ( $image->isTransformedLocally() && !$this->isImageAreaOkForThumbnaling( $image, $params ) ) {
174  return new TransformTooBigImageAreaError( $params, $wgMaxImageArea );
175  }
176 
177  if ( $flags & self::TRANSFORM_LATER ) {
178  wfDebug( __METHOD__ . ": Transforming later per flags.\n" );
179  $newParams = [
180  'width' => $scalerParams['clientWidth'],
181  'height' => $scalerParams['clientHeight']
182  ];
183  if ( isset( $params['quality'] ) ) {
184  $newParams['quality'] = $params['quality'];
185  }
186  if ( isset( $params['page'] ) && $params['page'] ) {
187  $newParams['page'] = $params['page'];
188  }
189  return new ThumbnailImage( $image, $dstUrl, false, $newParams );
190  }
191 
192  # Try to make a target path for the thumbnail
193  if ( !wfMkdirParents( dirname( $dstPath ), null, __METHOD__ ) ) {
194  wfDebug( __METHOD__ . ": Unable to create thumbnail destination " .
195  "directory, falling back to client scaling\n" );
196 
197  return $this->getClientScalingThumbnailImage( $image, $scalerParams );
198  }
199 
200  # Transform functions and binaries need a FS source file
201  $thumbnailSource = $this->getThumbnailSource( $image, $params );
202 
203  // If the source isn't the original, disable EXIF rotation because it's already been applied
204  if ( $scalerParams['srcWidth'] != $thumbnailSource['width']
205  || $scalerParams['srcHeight'] != $thumbnailSource['height'] ) {
206  $scalerParams['disableRotation'] = true;
207  }
208 
209  $scalerParams['srcPath'] = $thumbnailSource['path'];
210  $scalerParams['srcWidth'] = $thumbnailSource['width'];
211  $scalerParams['srcHeight'] = $thumbnailSource['height'];
212 
213  if ( $scalerParams['srcPath'] === false ) { // Failed to get local copy
214  wfDebugLog( 'thumbnail',
215  sprintf( 'Thumbnail failed on %s: could not get local copy of "%s"',
216  wfHostname(), $image->getName() ) );
217 
218  return new MediaTransformError( 'thumbnail_error',
219  $scalerParams['clientWidth'], $scalerParams['clientHeight'],
220  wfMessage( 'filemissing' )->text()
221  );
222  }
223 
224  # Try a hook. Called "Bitmap" for historical reasons.
225 
226  $mto = null;
227  Hooks::run( 'BitmapHandlerTransform', [ $this, $image, &$scalerParams, &$mto ] );
228  if ( !is_null( $mto ) ) {
229  wfDebug( __METHOD__ . ": Hook to BitmapHandlerTransform created an mto\n" );
230  $scaler = 'hookaborted';
231  }
232 
233  // $scaler will return a MediaTransformError on failure, or false on success.
234  // If the scaler is succesful, it will have created a thumbnail at the destination
235  // path.
236  if ( is_array( $scaler ) && is_callable( $scaler ) ) {
237  // Allow subclasses to specify their own rendering methods.
238  $err = call_user_func( $scaler, $image, $scalerParams );
239  } else {
240  switch ( $scaler ) {
241  case 'hookaborted':
242  # Handled by the hook above
243  $err = $mto->isError() ? $mto : false;
244  break;
245  case 'im':
246  $err = $this->transformImageMagick( $image, $scalerParams );
247  break;
248  case 'custom':
249  $err = $this->transformCustom( $image, $scalerParams );
250  break;
251  case 'imext':
252  $err = $this->transformImageMagickExt( $image, $scalerParams );
253  break;
254  case 'gd':
255  default:
256  $err = $this->transformGd( $image, $scalerParams );
257  break;
258  }
259  }
260 
261  # Remove the file if a zero-byte thumbnail was created, or if there was an error
262  $removed = $this->removeBadFile( $dstPath, (bool)$err );
263  if ( $err ) {
264  # transform returned MediaTransforError
265  return $err;
266  } elseif ( $removed ) {
267  # Thumbnail was zero-byte and had to be removed
268  return new MediaTransformError( 'thumbnail_error',
269  $scalerParams['clientWidth'], $scalerParams['clientHeight'],
270  wfMessage( 'unknown-error' )->text()
271  );
272  } elseif ( $mto ) {
273  return $mto;
274  } else {
275  $newParams = [
276  'width' => $scalerParams['clientWidth'],
277  'height' => $scalerParams['clientHeight']
278  ];
279  if ( isset( $params['quality'] ) ) {
280  $newParams['quality'] = $params['quality'];
281  }
282  if ( isset( $params['page'] ) && $params['page'] ) {
283  $newParams['page'] = $params['page'];
284  }
285  return new ThumbnailImage( $image, $dstUrl, $dstPath, $newParams );
286  }
287  }
288 
296  protected function getThumbnailSource( $file, $params ) {
297  return $file->getThumbnailSource( $params );
298  }
299 
321  abstract protected function getScalerType( $dstPath, $checkDstPath = true );
322 
333  protected function getClientScalingThumbnailImage( $image, $scalerParams ) {
334  $params = [
335  'width' => $scalerParams['clientWidth'],
336  'height' => $scalerParams['clientHeight']
337  ];
338 
339  return new ThumbnailImage( $image, $image->getUrl(), null, $params );
340  }
341 
352  protected function transformImageMagick( $image, $params ) {
353  return $this->getMediaTransformError( $params, "Unimplemented" );
354  }
355 
366  protected function transformImageMagickExt( $image, $params ) {
367  return $this->getMediaTransformError( $params, "Unimplemented" );
368  }
369 
380  protected function transformCustom( $image, $params ) {
381  return $this->getMediaTransformError( $params, "Unimplemented" );
382  }
383 
391  public function getMediaTransformError( $params, $errMsg ) {
392  return new MediaTransformError( 'thumbnail_error', $params['clientWidth'],
393  $params['clientHeight'], $errMsg );
394  }
395 
406  protected function transformGd( $image, $params ) {
407  return $this->getMediaTransformError( $params, "Unimplemented" );
408  }
409 
416  function escapeMagickProperty( $s ) {
417  // Double the backslashes
418  $s = str_replace( '\\', '\\\\', $s );
419  // Double the percents
420  $s = str_replace( '%', '%%', $s );
421  // Escape initial - or @
422  if ( strlen( $s ) > 0 && ( $s[0] === '-' || $s[0] === '@' ) ) {
423  $s = '\\' . $s;
424  }
425 
426  return $s;
427  }
428 
446  function escapeMagickInput( $path, $scene = false ) {
447  # Die on initial metacharacters (caller should prepend path)
448  $firstChar = substr( $path, 0, 1 );
449  if ( $firstChar === '~' || $firstChar === '@' ) {
450  throw new MWException( __METHOD__ . ': cannot escape this path name' );
451  }
452 
453  # Escape glob chars
454  $path = preg_replace( '/[*?\[\]{}]/', '\\\\\0', $path );
455 
456  return $this->escapeMagickPath( $path, $scene );
457  }
458 
466  function escapeMagickOutput( $path, $scene = false ) {
467  $path = str_replace( '%', '%%', $path );
468 
469  return $this->escapeMagickPath( $path, $scene );
470  }
471 
481  protected function escapeMagickPath( $path, $scene = false ) {
482  # Die on format specifiers (other than drive letters). The regex is
483  # meant to match all the formats you get from "convert -list format"
484  if ( preg_match( '/^([a-zA-Z0-9-]+):/', $path, $m ) ) {
485  if ( wfIsWindows() && is_dir( $m[0] ) ) {
486  // OK, it's a drive letter
487  // ImageMagick has a similar exception, see IsMagickConflict()
488  } else {
489  throw new MWException( __METHOD__ . ': unexpected colon character in path name' );
490  }
491  }
492 
493  # If there are square brackets, add a do-nothing scene specification
494  # to force a literal interpretation
495  if ( $scene === false ) {
496  if ( strpos( $path, '[' ) !== false ) {
497  $path .= '[0--1]';
498  }
499  } else {
500  $path .= "[$scene]";
501  }
502 
503  return $path;
504  }
505 
512  protected function getMagickVersion() {
513  $cache = MediaWikiServices::getInstance()->getLocalServerObjectCache();
514  return $cache->getWithSetCallback(
515  'imagemagick-version',
516  $cache::TTL_HOUR,
517  function () {
519 
520  $cmd = wfEscapeShellArg( $wgImageMagickConvertCommand ) . ' -version';
521  wfDebug( __METHOD__ . ": Running convert -version\n" );
522  $retval = '';
523  $return = wfShellExec( $cmd, $retval );
524  $x = preg_match(
525  '/Version: ImageMagick ([0-9]*\.[0-9]*\.[0-9]*)/', $return, $matches
526  );
527  if ( $x != 1 ) {
528  wfDebug( __METHOD__ . ": ImageMagick version check failed\n" );
529  return false;
530  }
531 
532  return $matches[1];
533  }
534  );
535  }
536 
543  public function canRotate() {
544  return false;
545  }
546 
554  public function autoRotateEnabled() {
555  return false;
556  }
557 
569  public function rotate( $file, $params ) {
570  return new MediaTransformError( 'thumbnail_error', 0, 0,
571  get_class( $this ) . ' rotation not implemented' );
572  }
573 
581  public function mustRender( $file ) {
582  return $this->canRotate() && $this->getRotation( $file ) != 0;
583  }
584 
595  public function isImageAreaOkForThumbnaling( $file, &$params ) {
597 
598  # For historical reasons, hook starts with BitmapHandler
599  $checkImageAreaHookResult = null;
600  Hooks::run(
601  'BitmapHandlerCheckImageArea',
602  [ $file, &$params, &$checkImageAreaHookResult ]
603  );
604 
605  if ( !is_null( $checkImageAreaHookResult ) ) {
606  // was set by hook, so return that value
607  return (bool)$checkImageAreaHookResult;
608  }
609 
610  $srcWidth = $file->getWidth( $params['page'] );
611  $srcHeight = $file->getHeight( $params['page'] );
612 
613  if ( $srcWidth * $srcHeight > $wgMaxImageArea
614  && !( $file->getMimeType() == 'image/jpeg'
615  && $this->getScalerType( false, false ) == 'im' )
616  ) {
617  # Only ImageMagick can efficiently downsize jpg images without loading
618  # the entire file in memory
619  return false;
620  }
621  return true;
622  }
623 }
canRotate()
Returns whether the current scaler supports rotation.
rotate($file, $params)
Rotate a thumbnail.
transformCustom($image, $params)
Transform an image using a custom command.
$wgImageMagickConvertCommand
The convert command shipped with ImageMagick.
removeBadFile($dstPath, $retval=0)
Check for zero-sized thumbnails.
escapeMagickInput($path, $scene=false)
Escape a string for ImageMagick's input filenames.
Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for use
wfMkdirParents($dir, $mode=null, $caller=null)
Make directory, and make all parent directories if they don't exist.
escapeMagickOutput($path, $scene=false)
Escape a string for ImageMagick's output filename.
wfHostname()
Fetch server name for use in error reporting etc.
Handler for images that need to be transformed.
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency MediaWikiServices
Definition: injection.txt:23
it s the revision text itself In either if gzip is the revision text is gzipped $flags
Definition: hooks.txt:2703
$wgMaxImageArea
The maximum number of pixels a source image can have if it is to be scaled down by a scaler that requ...
wfShellExec($cmd, &$retval=null, $environ=[], $limits=[], $options=[])
Execute a shell command, with time and memory limits mirrored from the PHP configuration if supported...
when a variable name is used in a it is silently declared as a new local masking the global
Definition: design.txt:93
getClientScalingThumbnailImage($image, $scalerParams)
Get a ThumbnailImage that respresents an image that will be scaled client side.
wfIsWindows()
Check if the operating system is Windows.
wfDebug($text, $dest= 'all', array $context=[])
Sends a line to the debug log if enabled or, optionally, to a comment in output.
getRotation($file)
On supporting image formats, try to read out the low-level orientation of the file and return the ang...
Shortcut class for parameter validation errors.
wfDebugLog($logGroup, $text, $dest= 'all', array $context=[])
Send a line to a supplementary debug log file, if configured, or main debug log if not...
getThumbnailSource($file, $params)
Get the source file for the transform.
doTransform($image, $dstPath, $dstUrl, $params, $flags=0)
Create a thumbnail.
either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the No matching items in log is displayed if loglist is empty msgKey Array If you want a nice box with a set this to the key of the message First element is the message additional optional elements are parameters for the key that are processed with wfMessage() -> params() ->parseAsBlock()-offset Set to overwrite offset parameter in $wgRequest set to ''to unsetoffset-wrap String Wrap the message in html(usually something like"&lt
Media transform output for images.
$cache
Definition: mcc.php:33
$params
static run($event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
Definition: Hooks.php:131
extractPreRotationDimensions($params, $rotation)
Extracts the width/height if the image will be scaled before rotating.
design txt This is a brief overview of the new design More thorough and up to date information is available on the documentation wiki at etc Handles the details of getting and saving to the user table of the and dealing with sessions and cookies OutputPage Encapsulates the entire HTML page that will be sent in response to any server request It is used by calling its functions to add text
Definition: design.txt:12
Shortcut class for parameter file size errors.
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring php
Definition: injection.txt:35
getMediaTransformError($params, $errMsg)
Get a MediaTransformError with error 'thumbnail_error'.
isImageAreaOkForThumbnaling($file, &$params)
Check if the file is smaller than the maximum image area for thumbnailing.
autoRotateEnabled()
Should we automatically rotate an image based on exif.
mustRender($file)
Returns whether the file needs to be rendered.
Media handler abstract base class for images.
transformImageMagick($image, $params)
Transform an image using ImageMagick.
escapeMagickPath($path, $scene=false)
Armour a string against ImageMagick's GetPathComponent().
transformGd($image, $params)
Transform an image using the built in GD library.
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check $image
Definition: hooks.txt:802
wfEscapeShellArg()
Version of escapeshellarg() that works better on Windows.
getMagickVersion()
Retrieve the version of the installed ImageMagick You can use PHPs version_compare() to use this valu...
please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a local account incomplete not yet checked for validity & $retval
Definition: hooks.txt:242
escapeMagickProperty($s)
Escape a string for ImageMagick's property input (e.g.
getScalerType($dstPath, $checkDstPath=true)
Returns what sort of scaler type should be used.
Basic media transform error class.
transformImageMagickExt($image, $params)
Transform an image using the Imagick PHP extension.
$matches