2020-03-03 22:50:34 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace MediaWiki\Hook;
|
|
|
|
|
|
2020-03-16 23:31:05 +00:00
|
|
|
use MimeAnalyzer;
|
|
|
|
|
|
2020-03-03 22:50:34 +00:00
|
|
|
/**
|
2020-09-26 13:18:43 +00:00
|
|
|
* This is a hook handler interface, see docs/Hooks.md.
|
|
|
|
|
* Use the hook name "MimeMagicGuessFromContent" to register handlers implementing this interface.
|
|
|
|
|
*
|
2020-07-13 09:05:49 +00:00
|
|
|
* @stable to implement
|
2020-03-03 22:50:34 +00:00
|
|
|
* @ingroup Hooks
|
|
|
|
|
*/
|
|
|
|
|
interface MimeMagicGuessFromContentHook {
|
|
|
|
|
/**
|
2020-03-16 23:31:05 +00:00
|
|
|
* Use this hook to guess the MIME by content.
|
2020-03-03 22:50:34 +00:00
|
|
|
*
|
|
|
|
|
* @since 1.35
|
|
|
|
|
*
|
2020-03-16 23:31:05 +00:00
|
|
|
* @param MimeAnalyzer $mimeMagic
|
|
|
|
|
* @param string &$head First 1024 bytes of the file in a string (in - Do not alter!)
|
|
|
|
|
* @param string &$tail More or equal than last 65558 bytes of the file in a string
|
|
|
|
|
* (in - Do not alter!)
|
|
|
|
|
* @param string $file File path
|
|
|
|
|
* @param string &$mime MIME type (out)
|
2020-03-03 22:50:34 +00:00
|
|
|
* @return bool|void True or no return value to continue or false to abort
|
|
|
|
|
*/
|
|
|
|
|
public function onMimeMagicGuessFromContent( $mimeMagic, &$head, &$tail, $file,
|
|
|
|
|
&$mime
|
|
|
|
|
);
|
|
|
|
|
}
|