MediaWiki REL1_30
SpecialMediaStatistics.php
Go to the documentation of this file.
1<?php
27
32 protected $totalCount = 0, $totalBytes = 0;
33
37 protected $totalPerType = 0;
38
42 protected $totalSize = 0;
43
44 function __construct( $name = 'MediaStatistics' ) {
45 parent::__construct( $name );
46 // Generally speaking there is only a small number of file types,
47 // so just show all of them.
48 $this->limit = 5000;
49 $this->shownavigation = false;
50 }
51
52 public function isExpensive() {
53 return true;
54 }
55
70 public function getQueryInfo() {
72 $fakeTitle = $dbr->buildConcat( [
73 'img_media_type',
74 $dbr->addQuotes( ';' ),
75 'img_major_mime',
76 $dbr->addQuotes( '/' ),
77 'img_minor_mime',
78 $dbr->addQuotes( ';' ),
79 'COUNT(*)',
80 $dbr->addQuotes( ';' ),
81 'SUM( img_size )'
82 ] );
83 return [
84 'tables' => [ 'image' ],
85 'fields' => [
86 'title' => $fakeTitle,
87 'namespace' => NS_MEDIA, /* needs to be something */
88 'value' => '1'
89 ],
90 'options' => [
91 'GROUP BY' => [
92 'img_media_type',
93 'img_major_mime',
94 'img_minor_mime',
95 ]
96 ]
97 ];
98 }
99
107 function getOrderFields() {
108 return [ 'img_media_type', 'count(*)', 'img_major_mime', 'img_minor_mime' ];
109 }
110
121 protected function outputResults( $out, $skin, $dbr, $res, $num, $offset ) {
122 $prevMediaType = null;
123 foreach ( $res as $row ) {
124 $mediaStats = $this->splitFakeTitle( $row->title );
125 if ( count( $mediaStats ) < 4 ) {
126 continue;
127 }
128 list( $mediaType, $mime, $totalCount, $totalBytes ) = $mediaStats;
129 if ( $prevMediaType !== $mediaType ) {
130 if ( $prevMediaType !== null ) {
131 // We're not at beginning, so we have to
132 // close the previous table.
133 $this->outputTableEnd();
134 }
135 $this->outputMediaType( $mediaType );
136 $this->totalPerType = 0;
137 $this->outputTableStart( $mediaType );
138 $prevMediaType = $mediaType;
139 }
140 $this->outputTableRow( $mime, intval( $totalCount ), intval( $totalBytes ) );
141 }
142 if ( $prevMediaType !== null ) {
143 $this->outputTableEnd();
144 // add total size of all files
145 $this->outputMediaType( 'total' );
146 $this->getOutput()->addWikiText(
147 $this->msg( 'mediastatistics-allbytes' )
148 ->numParams( $this->totalSize )
149 ->sizeParams( $this->totalSize )
150 ->text()
151 );
152 }
153 }
154
158 protected function outputTableEnd() {
159 $this->getOutput()->addHTML( Html::closeElement( 'table' ) );
160 $this->getOutput()->addWikiText(
161 $this->msg( 'mediastatistics-bytespertype' )
162 ->numParams( $this->totalPerType )
163 ->sizeParams( $this->totalPerType )
164 ->numParams( $this->makePercentPretty( $this->totalPerType / $this->totalBytes ) )
165 ->text()
166 );
167 $this->totalSize += $this->totalPerType;
168 }
169
177 protected function outputTableRow( $mime, $count, $bytes ) {
178 $mimeSearch = SpecialPage::getTitleFor( 'MIMEsearch', $mime );
180 $row = Html::rawElement(
181 'td',
182 [],
183 $linkRenderer->makeLink( $mimeSearch, $mime )
184 );
185 $row .= Html::element(
186 'td',
187 [],
188 $this->getExtensionList( $mime )
189 );
190 $row .= Html::rawElement(
191 'td',
192 // Make sure js sorts it in numeric order
193 [ 'data-sort-value' => $count ],
194 $this->msg( 'mediastatistics-nfiles' )
195 ->numParams( $count )
197 ->numParams( $this->makePercentPretty( $count / $this->totalCount ) )
198 ->parse()
199 );
200 $row .= Html::rawElement(
201 'td',
202 // Make sure js sorts it in numeric order
203 [ 'data-sort-value' => $bytes ],
204 $this->msg( 'mediastatistics-nbytes' )
205 ->numParams( $bytes )
206 ->sizeParams( $bytes )
208 ->numParams( $this->makePercentPretty( $bytes / $this->totalBytes ) )
209 ->parse()
210 );
211 $this->totalPerType += $bytes;
212 $this->getOutput()->addHTML( Html::rawElement( 'tr', [], $row ) );
213 }
214
219 protected function makePercentPretty( $decimal ) {
220 $decimal *= 100;
221 // Always show three useful digits
222 if ( $decimal == 0 ) {
223 return '0';
224 }
225 if ( $decimal >= 100 ) {
226 return '100';
227 }
228 $percent = sprintf( "%." . max( 0, 2 - floor( log10( $decimal ) ) ) . "f", $decimal );
229 // Then remove any trailing 0's
230 return preg_replace( '/\.?0*$/', '', $percent );
231 }
232
239 private function getExtensionList( $mime ) {
240 $exts = MimeMagic::singleton()->getExtensionsForType( $mime );
241 if ( $exts === null ) {
242 return '';
243 }
244 $extArray = explode( ' ', $exts );
245 $extArray = array_unique( $extArray );
246 foreach ( $extArray as &$ext ) {
247 $ext = '.' . $ext;
248 }
249
250 return $this->getLanguage()->commaList( $extArray );
251 }
252
259 protected function outputTableStart( $mediaType ) {
260 $this->getOutput()->addHTML(
261 Html::openElement(
262 'table',
263 [ 'class' => [
264 'mw-mediastats-table',
265 'mw-mediastats-table-' . strtolower( $mediaType ),
266 'sortable',
267 'wikitable'
268 ] ]
269 )
270 );
271 $this->getOutput()->addHTML( $this->getTableHeaderRow() );
272 }
273
279 protected function getTableHeaderRow() {
280 $headers = [ 'mimetype', 'extensions', 'count', 'totalbytes' ];
281 $ths = '';
282 foreach ( $headers as $header ) {
283 $ths .= Html::rawElement(
284 'th',
285 [],
286 // for grep:
287 // mediastatistics-table-mimetype, mediastatistics-table-extensions
288 // tatistics-table-count, mediastatistics-table-totalbytes
289 $this->msg( 'mediastatistics-table-' . $header )->parse()
290 );
291 }
292 return Html::rawElement( 'tr', [], $ths );
293 }
294
300 protected function outputMediaType( $mediaType ) {
301 $this->getOutput()->addHTML(
302 Html::element(
303 'h2',
304 [ 'class' => [
305 'mw-mediastats-mediatype',
306 'mw-mediastats-mediatype-' . strtolower( $mediaType )
307 ] ],
308 // for grep
309 // mediastatistics-header-unknown, mediastatistics-header-bitmap,
310 // mediastatistics-header-drawing, mediastatistics-header-audio,
311 // mediastatistics-header-video, mediastatistics-header-multimedia,
312 // mediastatistics-header-office, mediastatistics-header-text,
313 // mediastatistics-header-executable, mediastatistics-header-archive,
314 // mediastatistics-header-3d,
315 $this->msg( 'mediastatistics-header-' . strtolower( $mediaType ) )->text()
316 )
317 );
321 }
322
329 private function splitFakeTitle( $fakeTitle ) {
330 return explode( ';', $fakeTitle, 4 );
331 }
332
337 protected function getGroupName() {
338 return 'media';
339 }
340
350 public function formatResult( $skin, $result ) {
351 throw new MWException( "unimplemented" );
352 }
353
360 public function preprocessResults( $dbr, $res ) {
362 $this->totalCount = $this->totalBytes = 0;
363 foreach ( $res as $row ) {
364 $mediaStats = $this->splitFakeTitle( $row->title );
365 $this->totalCount += isset( $mediaStats[2] ) ? $mediaStats[2] : 0;
366 $this->totalBytes += isset( $mediaStats[3] ) ? $mediaStats[3] : 0;
367 }
368 $res->seek( 0 );
369 }
370}
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
MediaWiki exception.
getExtensionList( $mime)
Given a mime type, return a comma separated list of allowed extensions.
isExpensive()
Is this query expensive (for some definition of expensive)? Then we don't let it run in miser mode.
outputTableRow( $mime, $count, $bytes)
Output a row of the stats table.
splitFakeTitle( $fakeTitle)
parse the fake title format that this special page abuses querycache with.
getGroupName()
What group to put the page in.
getOrderFields()
How to sort the results.
getTableHeaderRow()
Get (not output) the header row for the table.
preprocessResults( $dbr, $res)
Initialize total values so we can figure out percentages later.
outputResults( $out, $skin, $dbr, $res, $num, $offset)
Output the results of the query.
__construct( $name='MediaStatistics')
outputMediaType( $mediaType)
Output a header for a new media type section.
outputTableStart( $mediaType)
Output the start of the table.
formatResult( $skin, $result)
This method isn't used, since we override outputResults, but we need to implement since abstract in p...
static singleton()
Get an instance of this class.
Definition MimeMagic.php:33
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:34
int $offset
The offset and limit in use, as passed to the query() function.
Definition QueryPage.php:39
executeLBFromResultWrapper(ResultWrapper $res, $ns=null)
Creates a new LinkBatch object, adds all pages from the passed ResultWrapper (MUST include title and ...
getOutput()
Get the OutputPage being used for this instance.
static getTitleFor( $name, $subpage=false, $fragment='')
Get a localised Title object for a specified special page name If you don't need a full Title object,...
msg( $key)
Wrapper around wfMessage that sets the current context.
getLanguage()
Shortcut to get user's language.
MediaWiki Linker LinkRenderer null $linkRenderer
Result wrapper for grabbing data queried from an IDatabase object.
if(! $regexes) $dbr
Definition cleanup.php:94
$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
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:18
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 $out
Definition hooks.txt:862
const NS_MEDIA
Definition Defines.php:53
Basic database interface for live and lazy-loaded relation database handles.
Definition IDatabase.php:40
const DB_REPLICA
Definition defines.php:25
if( $ext=='php'|| $ext=='php5') $mime
Definition router.php:59
$header