UploadedImageManager

Extiende la clase UploadedManager para gestionar imágenes.

Redimensionar imágenes

El nuevo tamaño de una imagen va a estar dado por: el modo de la redimensión y un valor. A continuación, se muestra un cuadro con los modos posibles:

Modo	Descripción	Valor
1 - Proportional	Mantiene las proporciones de la imagen original.	int	El tamaño máximo para el ancho o alto.
2 - Proportional area	Mantiene las proporciones de la imagen original. Pero su tamañoestará dado por el área.	int	El tamaño máximo para el ancho o alto, siempre que se mantenga la proporcionalidad del área.
3 - Square	La redimensión se forzará a una figura cuadrada.	int
4 - Exact	La redimensión se forzará a los tamaños pasados por valor.	string	Una cadena con el ancho u el alto, separados por una x, por ejemplo '100x80'
5 - Width	Fija el ancho al valor pasado y calcula el alto.	int	El ancho.
6 - Height	Fija el alto al valor pasado y calcula el ancho.	int	El alto.

UploadedImageManager::resize

Redimensiona un imagen a varios tamaños.

public UploadedImageManager::resize(
	string $resizes_path,
	mixed  $resizes,
	int    $resize_mode = 0,
	bool   $save_orig = true
): self

Los parámetros son los mismos que en setResizes, ya que, internamente, lo primero que hace es configurar las redimensiones.

UploadedImageManager::setResizes

Guarda los valores para la redimensión. El método se utiliza para eliminar redimensiones de imágenes a partir de una original.

public UploadedImageManager::setResizes (
	string $resizes_path,
	mixed  $resizes,
	int    $resize_mode = 0,
	bool   $save_orig = true
): self

resizes_path

La ruta a la carpeta donde se guardarán las redimensiones.

La clase pone a disposición dos valores de relleno, que permiten resolver la ruta final de cada redimensión, estos valores son:

{sizename}: el nombre clave de la redimensión.
{filename}: el nombre del archivo, incluida su extensión.

resizes

Si desea realizar una única redimensión, debe pasar el valor, que dependerá del modo.

Si desea realizar varias redimensiones, debe pasar un arreglo que contenga todas las redimensiones que desea realizar y sus respectivos valores, por ejemplo:

$resizes = ['small' => 120, 'large' => 1024];

Si desea que cada redimensión tenga su propio modo, puede optar por:

$resizes = [
	'small' => ['size' => 120, 'mode' => 1],
	'large' => ['size' => 1024, 'mode' => 2],
];

En este caso, puede ovbiarse el parámetro que sigue.

resize_mode

El modo en que se calcularan las nuevas dimensiones de la imagen.

save_orig

En caso de ser false, se eliminará la imagen original.

Administrar imágenes

UploadedImageManager::setOrder

Guarda el orden en que deben ser devuelta las imágenes.

public UploadedImageManager::setOrder ( string $order ): self

order

Una cadena con el nombre de las imágenes, separadas por una barra vertical |, con el orden deseado.

UploadedImageManager::setCurrentImage

Guarda la imagen actual. Luego, la reemplazará o no por la imagen cargada.

public UploadedImageManager::setCurrentImage ( string $filename = null ): self

filename

La ruta de la imagen actual.

UploadedImageManager::setCurrentImages

Guarda las imágenes actuales. Luego, las mezclará con las imágenes cargadas, eliminando las que no han sido incluídas.

public UploadedImageManager::setCurrentImages ( array|string $filenames, string $separator = ',' ): self

UploadedFileManager

Filter