UploadedFileManager

Gestiona la carga de archivos.

Ejemplo inicial

// upload
$ufm = new UploadedFileManager($uploadedFile);
$ufm->moveTo('the/directory/');

$filename = $ufm->getFilename();

UploadedFileManager::__construct

public FilesUploadedManager::__construct ( UploadedFileInterface|array|null $UploadedFile[ , bool $isMultiple = false ] )

UploadedFile

Puede ser un objeto UploadedFileInterface o, en caso de ser multiple, un array de ellos. También acepta un valor null.

isMultiple

Corresponde con la carga multiple de archivos.

UploadedFileManager::validate

Valida los archivos agregados. Si uno de los parámetros es false, no se validará. En caso de fallo, lanza una Exception.

public UploadedFileManager::validate ( array $rules = null ): void

rules

Las reglas podrán ser:

Clave	Descripción
allow_extensions	Verifica que la extensión del archivo se encuentre entre las permitidas. Puede ser un array o una cadena separada por comas.
max_size	Verifica que el peso del archivo no supere el máximo establecido. El valor esta dado en `bytes`.
max_chars	Verifica que el nombre del archivo contenga menos caracteres que el máximo establecido.
max_files	Verifica la cantidad de archivos subidos.

UploadedFileManager::moveTo

Mueve los archivos agregado. En caso de fallo, lanza una Exception.

public UploadedFileManager::moveTo ( string $targetPath, int $rename = 0, bool $rewrite = false ): void

targetPath

Ruta al directorio donde se guardarán los archivos.

rename

Uno de los modos en que puede ser renombrado el archivo a subir.

rewrite

Está opción permite reescribir un archivo existente cuando se sube uno de igual nombre. En caso de optar por no reescribir, se lanzará una excepción.

UploadedFileManager::setCurrentFile

Configura el archivo actual, para que, en caso de ser necesario, se reemplace por el nuevo archivo.

public UploadedFileManager::setCurrentFile( ?string $filename = null)

filename

El nombre del archivo actual.

UploadedFileManager::getUploadedFile

Obtiene el objeto UploadedFile que se está administrando, o un array de ellos en caso de ser multiple.

public UploadedFileManager::getUploadedFile( ): mixed

UploadedFileManager::getUploadedFileData

Obtiene un array con los datos correspondientes a uno o multiples archivos.

public UploadedFileManager::getUploadedFileData( ): array

Valores devueltos

Los valores devueltos son:

[
 'clientFilename'    => 'original_name.extension',
 'filename'             => 'current_name.extension',
 'basename'           => 'current_name',
 'extension'           => 'extension'
];

UploadedFileManager::getClientFilename

Obtiene el nombre original del archivo, o un array de ellos.

public UploadedFileManager::getClientFilename( ): string|array

UploadedFileManager::getFilename

Obtiene el nombre del archivo, o un array de ellos.

public UploadedFileManager::getFilename( ): string|array

UploadedFileManager::$num_files

Devuelve el número de archivos agregados hasta el momento.

public UploadedFileManager::$num_files : int

MediaStorage

UploadedImageManager