MediaWiki  master
CreateFileOp Class Reference

Create a file in the backend with the given content. More...

Inheritance diagram for CreateFileOp:
Collaboration diagram for CreateFileOp:

Public Member Functions

 storagePathsChanged ()
 Get a list of storage paths written to for this operation. More...
 
- Public Member Functions inherited from FileOp
 __construct (FileBackendStore $backend, array $params, LoggerInterface $logger)
 Build a new batch file operation transaction. More...
 
 applyDependencies (array $deps)
 Update a dependency tracking array to account for this operation. More...
 
 attempt ()
 Attempt the operation. More...
 
 attemptAsync ()
 Attempt the operation in the background. More...
 
 attemptAsyncQuick ()
 Attempt the operation in the background without regards to prechecks. More...
 
 attemptQuick ()
 Attempt the operation without regards to prechecks. More...
 
 dependsOn (array $deps)
 Check if this operation changes files listed in $paths. More...
 
 failed ()
 Check if this operation failed precheck() or attempt() More...
 
 getBackend ()
 Get the backend this operation is for. More...
 
 getJournalEntries (array $oPredicates, array $nPredicates)
 Get the file journal entries for this file operation. More...
 
 getParam ( $name)
 Get the value of the parameter with the given name. More...
 
 logFailure ( $action)
 Log a file operation failure and preserve any temp files. More...
 
 precheck (array &$predicates)
 Check preconditions of the operation without writing anything. More...
 
 setBatchId ( $batchId)
 Set the batch UUID this operation belongs to. More...
 
 storagePathsRead ()
 Get a list of storage paths read from for this operation. More...
 
 storagePathsReadOrChanged ()
 Get a list of storage paths read from or written to for this operation. More...
 

Protected Member Functions

 allowedParams ()
 Get the file operation parameters. More...
 
 doAttempt ()
 
 doPrecheck (array &$predicates)
 
 getSourceSha1Base36 ()
 precheckDestExistence() helper function to get the source file SHA-1. More...
 
 getSourceSize ()
 precheckDestExistence() helper function to get the source file size. More...
 
- Protected Member Functions inherited from FileOp
 fileExists ( $source, array $predicates)
 Check if a file will exist in storage when this operation is attempted. More...
 
 fileSha1 ( $source, array $predicates)
 Get the SHA-1 of a file in storage when this operation is attempted. More...
 
 fileSize ( $source, array $predicates)
 Get the size a file in storage will have when this operation is attempted. More...
 
 precheckDestExistence (array $predicates)
 Check for errors with regards to the destination file already existing. More...
 
 setFlags (array $params)
 Adjust params to FileBackendStore internal file calls. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from FileOp
static newDependencies ()
 Get a new empty dependency tracking array for paths read/written to. More...
 
static newPredicates ()
 Get a new empty predicates array for precheck() More...
 
- Static Protected Member Functions inherited from FileOp
static normalizeIfValidStoragePath ( $path)
 Normalize a string if it is a valid storage path. More...
 
- Protected Attributes inherited from FileOp
bool $async = false
 
FileBackendStore $backend
 
string $batchId
 
bool $cancelled = false
 
bool $destExists
 
bool $failed = false
 
LoggerInterface $logger
 
bool $overwriteSameCase
 
array $params = []
 
string bool $sourceSha1
 
int bool $sourceSize
 
int $state = self::STATE_NEW
 
const ASSUMED_EXISTS = 'exists'
 
const ASSUMED_SHA1 = 'sha1'
 
const ASSUMED_SIZE = 'size'
 

Detailed Description

Create a file in the backend with the given content.

Parameters for this operation are outlined in FileBackend::doOperations().

Definition at line 26 of file CreateFileOp.php.

Member Function Documentation

◆ allowedParams()

CreateFileOp::allowedParams ( )
protected

Get the file operation parameters.

Returns
array (required params list, optional params list, list of params that are paths)

Reimplemented from FileOp.

Definition at line 27 of file CreateFileOp.php.

◆ doAttempt()

CreateFileOp::doAttempt ( )
protected
Returns
StatusValue

Reimplemented from FileOp.

Definition at line 59 of file CreateFileOp.php.

References StatusValue\newGood(), and FileOp\setFlags().

◆ doPrecheck()

CreateFileOp::doPrecheck ( array &  $predicates)
protected

◆ getSourceSha1Base36()

CreateFileOp::getSourceSha1Base36 ( )
protected

precheckDestExistence() helper function to get the source file SHA-1.

Subclasses should overwrite this if the source is not in storage.

Returns
string|bool Returns false on failure

Reimplemented from FileOp.

Definition at line 74 of file CreateFileOp.php.

◆ getSourceSize()

CreateFileOp::getSourceSize ( )
protected

precheckDestExistence() helper function to get the source file size.

Subclasses should overwrite this if the source is not in storage.

Returns
string|bool Returns false on failure

Reimplemented from FileOp.

Definition at line 70 of file CreateFileOp.php.

◆ storagePathsChanged()

CreateFileOp::storagePathsChanged ( )

Get a list of storage paths written to for this operation.

Returns
array

Reimplemented from FileOp.

Definition at line 78 of file CreateFileOp.php.


The documentation for this class was generated from the following file: