Update docs/hooks.txt for ShowSearchHitTitle
[mediawiki.git] / includes / jobqueue / jobs / ThumbnailRenderJob.php
blob081e1141b1d0e16919237184b0f539d6a8f1b8af
1 <?php
2 /**
3 * Job for asynchronous rendering of thumbnails.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (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.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
20 * @file
21 * @ingroup JobQueue
24 /**
25 * Job for asynchronous rendering of thumbnails.
27 * @ingroup JobQueue
29 class ThumbnailRenderJob extends Job {
30 public function __construct( Title $title, array $params ) {
31 parent::__construct( 'ThumbnailRender', $title, $params );
34 public function run() {
35 global $wgUploadThumbnailRenderMethod;
37 $transformParams = $this->params['transformParams'];
39 $file = wfLocalFile( $this->title );
40 $file->load( File::READ_LATEST );
42 if ( $file && $file->exists() ) {
43 if ( $wgUploadThumbnailRenderMethod === 'jobqueue' ) {
44 $thumb = $file->transform( $transformParams, File::RENDER_NOW );
46 if ( $thumb && !$thumb->isError() ) {
47 return true;
48 } else {
49 $this->setLastError( __METHOD__ . ': thumbnail couln\'t be generated' );
50 return false;
52 } elseif ( $wgUploadThumbnailRenderMethod === 'http' ) {
53 $thumbUrl = '';
54 $status = $this->hitThumbUrl( $file, $transformParams, $thumbUrl );
56 wfDebug( __METHOD__ . ": received status {$status}\n" );
58 // 400 happens when requesting a size greater or equal than the original
59 if ( $status === 200 || $status === 301 || $status === 302 || $status === 400 ) {
60 return true;
61 } elseif ( $status ) {
62 $this->setLastError( __METHOD__ . ': incorrect HTTP status ' .
63 $status . ' when hitting ' . $thumbUrl );
64 return false;
65 } else {
66 $this->setLastError( __METHOD__ . ': HTTP request failure' );
67 return false;
69 } else {
70 $this->setLastError( __METHOD__ . ': unknown thumbnail render method ' .
71 $wgUploadThumbnailRenderMethod );
72 return false;
74 } else {
75 $this->setLastError( __METHOD__ . ': file doesn\'t exist' );
76 return false;
80 protected function hitThumbUrl( $file, $transformParams, &$thumbUrl ) {
81 global $wgUploadThumbnailRenderHttpCustomHost, $wgUploadThumbnailRenderHttpCustomDomain;
83 $thumbName = $file->thumbName( $transformParams );
84 $thumbUrl = $file->getThumbUrl( $thumbName );
86 if ( $wgUploadThumbnailRenderHttpCustomDomain ) {
87 $parsedUrl = wfParseUrl( $thumbUrl );
89 if ( !$parsedUrl || !isset( $parsedUrl['path'] ) || !strlen( $parsedUrl['path'] ) ) {
90 return false;
93 $thumbUrl = '//' . $wgUploadThumbnailRenderHttpCustomDomain . $parsedUrl['path'];
96 wfDebug( __METHOD__ . ": hitting url {$thumbUrl}\n" );
98 $request = MWHttpRequest::factory( $thumbUrl,
99 [ 'method' => 'HEAD', 'followRedirects' => true ],
100 __METHOD__
103 if ( $wgUploadThumbnailRenderHttpCustomHost ) {
104 $request->setHeader( 'Host', $wgUploadThumbnailRenderHttpCustomHost );
107 $status = $request->execute();
109 return $request->getStatus();