FPDF异常问题：将图片放入CELL时图片超出边界，求解决

Hey there! I’ve run into this exact issue with FPDF before—images spilling outside cells is a super common gotcha, especially when looping through cells. Let’s break down why this happens and how to fix it quickly.

Why Your Image Is Spilling Over #

The main culprits are usually:

• Your image’s original dimensions are larger than the cell’s width/height, and you’re not scaling it down to fit.
• You’re not properly aligning the image within the cell’s boundaries (FPDF’s Image() function draws independently of Cell(), so you have to manually position it).
• Your loop isn’t updating the cursor position correctly, leading to overlapping or misaligned content.

Step-by-Step Fix #

Let’s use a concrete example. Suppose you’re looping to create 5 cells, each 80px wide and 50px tall, and you want to insert an image into each without overflow.

1. Calculate Image Scaling First

First, get your image’s original size and calculate a scaling ratio that fits it inside the cell while preserving aspect ratio:

// Define your cell dimensions
$cell_width = 80;
$cell_height = 50;

// Get the image's original width/height
list($img_original_w, $img_original_h) = getimagesize('your_image.jpg');

// Calculate the maximum safe scale (don't let image exceed cell bounds)
$scale_ratio = min(
    $cell_width / $img_original_w,
    $cell_height / $img_original_h
);

// Compute the scaled image dimensions
$img_display_w = $img_original_w * $scale_ratio;
$img_display_h = $img_original_h * $scale_ratio;

2. Loop with Proper Positioning

Now, in your loop, you’ll draw the cell first, then position the image exactly inside it. We’ll use GetX() and GetY() to grab the cell’s top-left corner, then center the image (adjust this if you want left/top alignment):

$pdf = new FPDF();
$pdf->AddPage();

for ($i = 0; $i < 5; $i++) {
    // Get current cursor position (top-left of the upcoming cell)
    $current_x = $pdf->GetX();
    $current_y = $pdf->GetY();

    // Draw the cell (the 1 adds a border so you can see the bounds)
    $pdf->Cell($cell_width, $cell_height, '', 1, 0, 'C');

    // Calculate image position to center it in the cell
    $img_x = $current_x + ($cell_width - $img_display_w) / 2;
    $img_y = $current_y + ($cell_height - $img_display_h) / 2;

    // Insert the scaled image
    $pdf->Image('your_image.jpg', $img_x, $img_y, $img_display_w, $img_display_h);

    // Move cursor to the next cell's position
    $pdf->SetXY($current_x + $cell_width, $current_y);
}

$pdf->Output();

Key Notes to Avoid Future Issues #

• Always scale images: Never assume the image will fit the cell—calculate the ratio every time (especially if you’re using dynamic images).
• Cell vs. Image independence: Remember that Cell() just moves the cursor and draws a box (if you want it), while Image() draws at absolute coordinates. You have to link their positions manually.
• Adjust alignment: If you don’t want centered images, skip the centering calculation and set $img_x = $current_x + 5 (for a 5px left margin) or similar.
• Cell height matching: If your scaled image is 45px tall, make sure your cell height is at least 45px (or add a small margin by setting $cell_height = $img_display_h + 10).

内容的提问来源于stack exchange，提问作者Damara Jati P