3 namespace MediaWiki\FileBackend\FSFile
;
10 class TempFSFileFactory
{
11 /** @var string|null */
12 private $tmpDirectory;
15 * @param string|null $tmpDirectory A directory to put the temporary files in, e.g.,
16 * $wgTmpDirectory. If null, we'll try to find one ourselves.
18 public function __construct( $tmpDirectory = null ) {
19 $this->tmpDirectory
= $tmpDirectory;
23 * Make a new temporary file on the file system.
24 * Temporary files may be purged when the file object falls out of scope.
26 * @param string $prefix
27 * @param string $extension Optional file extension
28 * @return TempFSFile|null
30 public function newTempFSFile( $prefix, $extension = '' ) {
31 $ext = ( $extension != '' ) ?
".{$extension}" : '';
32 $tmpDirectory = $this->tmpDirectory
;
33 if ( !is_string( $tmpDirectory ) ) {
34 $tmpDirectory = TempFSFile
::getUsableTempDirectory();
38 while ( $attempts-- ) {
39 $hex = sprintf( '%06x%06x', mt_rand( 0, 0xffffff ), mt_rand( 0, 0xffffff ) );
40 $path = "$tmpDirectory/$prefix$hex$ext";
41 \Wikimedia\
suppressWarnings();
42 $newFileHandle = fopen( $path, 'x' );
43 \Wikimedia\restoreWarnings
();
44 if ( $newFileHandle ) {
45 fclose( $newFileHandle );
46 $tmpFile = new TempFSFile( $path );
47 $tmpFile->autocollect();
48 // Safely instantiated, end loop.
54 return null; // @codeCoverageIgnore