Estamos actualizando el sitio. Durante unos días es posible que veas fallos de diseño o de traducción. La documentación sigue disponible: si una página se ve mal, recárgala más tarde.

Inicio image 3.x Insertar imágenes

Insertar imágenes

3.x 7 de mar. de 2026

#Insertar imágenes

public Image::place(mixed $element, string $position = 'top-left', int $offset_x = 0, int $offset_y = 0, int $opacity = 100): ImageInterface

Inserta una imagen en la posición especificada. La imagen a insertar puede especificarse desde cualquiera de las supported image sources. Opcionalmente, puede pasar coordenadas para un desplazamiento que mueva la imagen con respecto a la posición indicada. También es posible controlar la opacidad de la marca de agua usando el parámetro opacity.

Los valores posibles de position son:

  • top-left (default)
  • top
  • top-right
  • left
  • center
  • right
  • bottom-left
  • bottom
  • bottom-right

#Parámetros

Name Type Description
element mixed Origen de la imagen que se colocará
position string Posición de la imagen que se colocará
offset_x int Desplazamiento relativo opcional de la nueva imagen en el eje X
offset_y int Desplazamiento relativo opcional de la nueva imagen en el eje Y
opacity int Control de la opacidad de la imagen colocada que va de 0 (totalmente transparente) a 100 (opaco)

#Ejemplo

use Intervention\Image\ImageManager;

// crear una imagen de prueba a partir de un archivo
$manager = ImageManager::gd();
$image = $manager->read('test.png');

// pegar otra imagen
$img->place('images/foo.png');

// crear una nueva instancia de marca de agua redimensionada e insertar en la esquina inferior derecha 
// con un desplazamiento de 10px y una opacidad del 25%
$img->place(
    'images/watermark.png',
    'bottom-right', 
    10, 
    10,
    25
);