PHP GD库图片生成白屏问题求助

I’ve run into this exact scenario a few times—local works perfectly, but the VPS throws a white screen even with matching GD versions. Let’s break down the likely issues and actionable fixes:

1. Critical Code Bug: Duplicate Image Output #

Looking at your code, you’re calling imagepng() twice:

imagepng($image);
imagepng($imageCart); // This is the root problem!

Browsers can only parse a single image stream in a response. Sending two PNG files back-to-back corrupts the output entirely, resulting in that blank white screen. You only need to output the final composite image ($image), since $imageCart is already merged into it. Remove the imagepng($imageCart); line first—this is almost certainly the main culprit.

2. File Path & Permission Issues #

a. HTTP URL vs. Local File Path #

You’re using a full HTTP URL to load cart1.png:

$image = imagecreatefrompng((isset($_SERVER['HTTPS']) ? "https" : "http") . "://$_SERVER[HTTP_HOST]" . "/wp-content/uploads/cart1.png");

This relies on allow_url_fopen being enabled in PHP, and your VPS server being able to make loopback HTTP requests to itself (some hosting environments block this). A far more reliable approach is to use the local file system path:

$image = imagecreatefrompng($_SERVER['DOCUMENT_ROOT'] . '/wp-content/uploads/cart1.png');

b. $perfil File Access #

Double-check that the file path stored in $perfil exists on your VPS, and that the web server user (e.g., www-data on Debian/Ubuntu) has read permissions for it. VPS file permissions are often stricter than local dev environments—run chmod 644 on the file or chown www-data:www-data on the parent directory if needed.

3. Hidden PHP Errors #

White screens usually mean PHP errors are being suppressed. Add these lines at the top of your script to force error display (temporarily, for debugging):

error_reporting(E_ALL);
ini_set('display_errors', 1);

This will reveal if there’s a missing file, memory limit hit, or GD function failure that’s otherwise hidden from view.

4. Memory Limit Exceeded #

Image manipulation can eat up memory quickly, especially if your source images are large. Your VPS might have a lower PHP memory limit than your local VM. Try increasing it temporarily in your script:

ini_set('memory_limit', '256M'); // Adjust as needed based on image size

Or update your php.ini file’s memory_limit setting permanently for better performance.

5. GD Library Configuration #

Even if versions match, some GD features might be disabled on the VPS. Run phpinfo() and check the GD section to confirm:

• PNG support is enabled (--with-png)
• FreeType support is enabled (required for imagestring to render text correctly)

Final Corrected Code Snippet #

Here’s your code with the critical duplicate output fix and local path improvement:

// Enable error reporting for debugging (remove in production)
error_reporting(E_ALL);
ini_set('display_errors', 1);

// Use local file path instead of HTTP URL for reliability
$image = imagecreatefrompng($_SERVER['DOCUMENT_ROOT'] . '/wp-content/uploads/cart1.png');
$imageCart = imagecreatefrompng($perfil);

$titleColor = imagecolorallocate($image, 255, 255, 255);
$gray = imagecolorallocate($image, 100, 100, 100);
$black = imagecolorallocate($image, 0, 0, 0);

imagecopymerge($image, $imageCart, 60, 177, 0, 0, imagesx($imageCart), imagesy($imageCart), 100);
imagestring($image, 5, 170, 175, "NOME " . strtoupper($nomeCompleto), $titleColor);
imagestring($image, 5, 170, 205, "CPF " . $cpf, $titleColor);
imagestring($image, 5, 170, 235, "MATRICULA " . $matricula, $titleColor);
imagestring($image, 5, 170, 263, "DT NASCIMENTO " . $dtnacimento, $titleColor);

header("Content-type: image/png");
imagepng($image);

// Clean up resources
imagedestroy($image);
imagedestroy($imageCart);

Start with fixing the duplicate imagepng call—this is the most likely cause. If that doesn’t resolve it, use the error reporting to narrow down the remaining issue.

内容的提问来源于stack exchange，提问作者dkpimentel