PHP Класс Sirius\Upload\Handler

Наследование: implements Sirius\Upload\UploadHandlerInterface
Показать файл Открыть проект Примеры использования класса

Защищенные свойства (Protected)

Свойство Тип Описание
$autoconfirm boolean Whether or not the uploaded files are auto confirmed
$container Sirius\Upload\Container\ContainerInterface
$overwrite boolean When uploading a file that has the same name as a file that is already in the container should it overwrite it or use another name
$prefix string | callback It can be a subfolder (if it ends with '/', a string to be used as prefix) or a callback that returns a string
$sanitizerCallback function | callback
$validator Sirius\Validation\ValueValidator

Открытые методы

Метод Описание
__construct ( $directoryOrContainer, array $options = [], Sirius\Validation\ValueValidator $validator = null )
addRule ( string $name, mixed $options = null, string $errorMessageTemplate = null, string $label = null ) : Handler Add validation rule (extension|size|width|height|ratio)
process ( array $files = [] ) : Sirius\Upload\Result\Collection | Sirius\Upload\Result\File Processes a file upload and returns an upload result file/collection
setAutoconfirm ( boolean $autoconfirm ) : Handler Enable/disable upload autoconfirmation Autoconfirmation does not require calling confirm()
setOverwrite ( boolean $overwrite ) : Handler Enable/disable upload overwrite
setPrefix ( string | callable $prefix ) : Handler File prefix for the upload. Can be - a folder (if it ends with /) - a string to be used as prefix - a function that returns a string
setSanitizerCallback ( callable $callback ) : Handler Set the sanitizer function for cleaning up the file names

Защищенные методы

Метод Описание
processSingleFile ( array $file ) : array Processes a single uploaded file - sanitize the name - validates the file - if valid, moves the file to the container
sanitizeFileName ( string $name ) : string Sanitize the name of the uploaded file by stripping away bad characters and replacing "invalid" characters with underscore _
validateFile ( $file ) : mixed Validates a file according to the rules configured on the handler

Описание методов

__construct() публичный Метод

public __construct ( $directoryOrContainer, array $options = [], Sirius\Validation\ValueValidator $validator = null )
$directoryOrContainer
$options array
$validator Sirius\Validation\ValueValidator

addRule() публичный Метод

Add validation rule (extension|size|width|height|ratio)
public addRule ( string $name, mixed $options = null, string $errorMessageTemplate = null, string $label = null ) : Handler
$name string
$options mixed
$errorMessageTemplate string
$label string
Результат Handler

process() публичный Метод

Processes a file upload and returns an upload result file/collection
public process ( array $files = [] ) : Sirius\Upload\Result\Collection | Sirius\Upload\Result\File
$files array
Результат Sirius\Upload\Result\Collection | Sirius\Upload\Result\File

processSingleFile() защищенный Метод

Processes a single uploaded file - sanitize the name - validates the file - if valid, moves the file to the container
protected processSingleFile ( array $file ) : array
$file array
Результат array

sanitizeFileName() защищенный Метод

Sanitize the name of the uploaded file by stripping away bad characters and replacing "invalid" characters with underscore _
protected sanitizeFileName ( string $name ) : string
$name string
Результат string

setAutoconfirm() публичный Метод

Enable/disable upload autoconfirmation Autoconfirmation does not require calling confirm()
public setAutoconfirm ( boolean $autoconfirm ) : Handler
$autoconfirm boolean
Результат Handler

setOverwrite() публичный Метод

Enable/disable upload overwrite
public setOverwrite ( boolean $overwrite ) : Handler
$overwrite boolean
Результат Handler

setPrefix() публичный Метод

File prefix for the upload. Can be - a folder (if it ends with /) - a string to be used as prefix - a function that returns a string
public setPrefix ( string | callable $prefix ) : Handler
$prefix string | callable
Результат Handler

setSanitizerCallback() публичный Метод

Set the sanitizer function for cleaning up the file names
public setSanitizerCallback ( callable $callback ) : Handler
$callback callable
Результат Handler

validateFile() защищенный Метод

Validates a file according to the rules configured on the handler
protected validateFile ( $file ) : mixed
$file
Результат mixed

Описание свойств

$autoconfirm защищенное свойство

Whether or not the uploaded files are auto confirmed
protected bool $autoconfirm
Результат boolean

$container защищенное свойство

protected ContainerInterface,Sirius\Upload\Container $container
Результат Sirius\Upload\Container\ContainerInterface

$overwrite защищенное свойство

When uploading a file that has the same name as a file that is already in the container should it overwrite it or use another name
protected bool $overwrite
Результат boolean

$prefix защищенное свойство

It can be a subfolder (if it ends with '/', a string to be used as prefix) or a callback that returns a string
protected string|callback $prefix
Результат string | callback

$sanitizerCallback защищенное свойство

protected function|callback $sanitizerCallback
Результат function | callback

$validator защищенное свойство

protected ValueValidator,Sirius\Validation $validator
Результат Sirius\Validation\ValueValidator