MediaWiki REL1_32
SpecialMIMEsearch.php
Go to the documentation of this file.
1<?php
26
33 protected $major, $minor, $mime;
34
35 function __construct( $name = 'MIMEsearch' ) {
36 parent::__construct( $name );
37 }
38
39 public function isExpensive() {
40 return false;
41 }
42
43 function isSyndicated() {
44 return false;
45 }
46
47 function isCacheable() {
48 return false;
49 }
50
51 function linkParameters() {
52 return [ 'mime' => "{$this->major}/{$this->minor}" ];
53 }
54
55 public function getQueryInfo() {
56 $minorType = [];
57 if ( $this->minor !== '*' ) {
58 // Allow wildcard searching
59 $minorType['img_minor_mime'] = $this->minor;
60 }
61 $imgQuery = LocalFile::getQueryInfo();
62 $qi = [
63 'tables' => $imgQuery['tables'],
64 'fields' => [
65 'namespace' => NS_FILE,
66 'title' => 'img_name',
67 // Still have a value field just in case,
68 // but it isn't actually used for sorting.
69 'value' => 'img_name',
70 'img_size',
71 'img_width',
72 'img_height',
73 'img_user_text' => $imgQuery['fields']['img_user_text'],
74 'img_timestamp'
75 ],
76 'conds' => [
77 'img_major_mime' => $this->major,
78 // This is in order to trigger using
79 // the img_media_mime index in "range" mode.
80 // @todo how is order defined? use MimeAnalyzer::getMediaTypes?
81 'img_media_type' => [
93 ],
94 ] + $minorType,
95 'join_conds' => $imgQuery['joins'],
96 ];
97
98 return $qi;
99 }
100
110 function getOrderFields() {
111 return [];
112 }
113
117 function getPageHeader() {
119 'mime' => [
120 'type' => 'combobox',
121 'options' => $this->getSuggestionsForTypes(),
122 'name' => 'mime',
123 'label-message' => 'mimetype',
124 'required' => true,
125 'default' => $this->mime,
126 ],
127 ];
128
129 HTMLForm::factory( 'ooui', $formDescriptor, $this->getContext() )
130 ->setSubmitTextMsg( 'ilsubmit' )
131 ->setAction( $this->getPageTitle()->getLocalURL() )
132 ->setMethod( 'get' )
133 ->prepareForm()
134 ->displayForm( false );
135 }
136
137 protected function getSuggestionsForTypes() {
139 $lastMajor = null;
140 $suggestions = [];
141 $result = $dbr->select(
142 [ 'image' ],
143 // We ignore img_media_type, but using it in the query is needed for MySQL to choose a
144 // sensible execution plan
145 [ 'img_media_type', 'img_major_mime', 'img_minor_mime' ],
146 [],
147 __METHOD__,
148 [ 'GROUP BY' => [ 'img_media_type', 'img_major_mime', 'img_minor_mime' ] ]
149 );
150 foreach ( $result as $row ) {
151 $major = $row->img_major_mime;
152 $minor = $row->img_minor_mime;
153 $suggestions[ "$major/$minor" ] = "$major/$minor";
154 if ( $lastMajor === $major ) {
155 // If there are at least two with the same major mime type, also include the wildcard
156 $suggestions[ "$major/*" ] = "$major/*";
157 }
158 $lastMajor = $major;
159 }
160 ksort( $suggestions );
161 return $suggestions;
162 }
163
164 public function execute( $par ) {
165 $this->mime = $par ?: $this->getRequest()->getText( 'mime' );
166 $this->mime = trim( $this->mime );
167 list( $this->major, $this->minor ) = File::splitMime( $this->mime );
168
169 if ( $this->major == '' || $this->minor == '' || $this->minor == 'unknown' ||
170 !self::isValidType( $this->major )
171 ) {
172 $this->setHeaders();
173 $this->outputHeader();
174 $this->getPageHeader();
175 return;
176 }
177
178 parent::execute( $par );
179 }
180
186 function formatResult( $skin, $result ) {
188 $nt = Title::makeTitle( $result->namespace, $result->title );
189 $text = MediaWikiServices::getInstance()->getContentLanguage()
190 ->convert( htmlspecialchars( $nt->getText() ) );
191 $plink = $linkRenderer->makeLink(
192 Title::newFromText( $nt->getPrefixedText() ),
193 new HtmlArmor( $text )
194 );
195
196 $download = Linker::makeMediaLinkObj( $nt, $this->msg( 'download' )->escaped() );
197 $download = $this->msg( 'parentheses' )->rawParams( $download )->escaped();
198 $lang = $this->getLanguage();
199 $bytes = htmlspecialchars( $lang->formatSize( $result->img_size ) );
200 $dimensions = $this->msg( 'widthheight' )->numParams( $result->img_width,
201 $result->img_height )->escaped();
202 $user = $linkRenderer->makeLink(
203 Title::makeTitle( NS_USER, $result->img_user_text ),
204 $result->img_user_text
205 );
206
207 $time = $lang->userTimeAndDate( $result->img_timestamp, $this->getUser() );
208 $time = htmlspecialchars( $time );
209
210 return "$download $plink . . $dimensions . . $bytes . . $user . . $time";
211 }
212
217 protected static function isValidType( $type ) {
218 // From maintenance/tables.sql => img_major_mime
219 $types = [
220 'unknown',
221 'application',
222 'audio',
223 'image',
224 'text',
225 'video',
226 'message',
227 'model',
228 'multipart',
229 'chemical'
230 ];
231
232 return in_array( $type, $types );
233 }
234
235 public function preprocessResults( $db, $res ) {
237 }
238
239 protected function getGroupName() {
240 return 'media';
241 }
242}
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
static splitMime( $mime)
Split an internet media type into its two components; if not a two-part name, set the minor type to '...
Definition File.php:273
Marks HTML that shouldn't be escaped.
Definition HtmlArmor.php:28
static makeMediaLinkObj( $title, $html='', $time=false)
Create a direct link to a given uploaded file.
Definition Linker.php:749
static getQueryInfo(array $options=[])
Return the tables, fields, and join conditions to be selected to create a new localfile object.
Searches the database for files of the requested MIME type, comparing this with the 'img_major_mime' ...
getPageHeader()
Generate and output the form.
isExpensive()
Is this query expensive (for some definition of expensive)? Then we don't let it run in miser mode.
getOrderFields()
The index is on (img_media_type, img_major_mime, img_minor_mime) which unfortunately doesn't have img...
getGroupName()
Under which header this special page is listed in Special:SpecialPages See messages 'specialpages-gro...
formatResult( $skin, $result)
linkParameters()
If using extra form wheely-dealies, return a set of parameters here as an associative array.
preprocessResults( $db, $res)
Do any necessary preprocessing of the result object.
static isValidType( $type)
__construct( $name='MIMEsearch')
getQueryInfo()
Subclasses return an SQL query here, formatted as an array with the following keys: tables => Table(s...
isCacheable()
Is the output of this query cacheable? Non-cacheable expensive pages will be disabled in miser mode a...
execute( $par)
This is the actual workhorse.
isSyndicated()
Sometime we don't want to build rss / atom feeds.
MediaWikiServices is the service locator for the application scope of MediaWiki.
This is a class for doing query pages; since they're almost all the same, we factor out some of the f...
Definition QueryPage.php:35
executeLBFromResultWrapper(IResultWrapper $res, $ns=null)
Creates a new LinkBatch object, adds all pages from the passed ResultWrapper (MUST include title and ...
outputHeader( $summaryMessageKey='')
Outputs a summary message on top of special pages Per default the message key is the canonical name o...
setHeaders()
Sets headers - this should be called from the execute() method of all derived classes!
getContext()
Gets the context this SpecialPage is executed in.
msg( $key)
Wrapper around wfMessage that sets the current context.
getRequest()
Get the WebRequest being used for this instance.
getPageTitle( $subpage=false)
Get a self-referential title object.
getLanguage()
Shortcut to get user's language.
MediaWiki Linker LinkRenderer null $linkRenderer
$res
Definition database.txt:21
deferred txt A few of the database updates required by various functions here can be deferred until after the result page is displayed to the user For updating the view updating the linked to tables after a etc PHP does not yet have any way to tell the server to actually return and disconnect while still running these but it might have such a feature in the future We handle these by creating a deferred update object and putting those objects on a global list
Definition deferred.txt:11
see documentation in includes Linker php for Linker::makeImageLink & $time
Definition hooks.txt:1841
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 use $formDescriptor instead & $formDescriptor
Definition hooks.txt:2208
const NS_FILE
Definition Defines.php:70
const MEDIATYPE_DRAWING
Definition defines.php:30
const MEDIATYPE_VIDEO
Definition defines.php:35
const MEDIATYPE_OFFICE
Definition defines.php:39
const MEDIATYPE_UNKNOWN
Definition defines.php:26
const MEDIATYPE_AUDIO
Definition defines.php:32
const MEDIATYPE_TEXT
Definition defines.php:41
const MEDIATYPE_BITMAP
Definition defines.php:28
const MEDIATYPE_MULTIMEDIA
Definition defines.php:37
const MEDIATYPE_EXECUTABLE
Definition defines.php:43
const MEDIATYPE_3D
Definition defines.php:47
const MEDIATYPE_ARCHIVE
Definition defines.php:45
const DB_REPLICA
Definition defines.php:25
if(!isset( $args[0])) $lang