iptcembed()的定义为：

iptcembed(string $iptc_data, string $filename, int $spool = 0): string|bool

第三个参数（$spool）只是一个标志-一个整数：如果该值小于2，则函数将返回一个字符串。否则（例如，如果该值等于或大于2），则JPEG数据将“打印”到STDOUT。该参数的文档如下：
假脱机标志。如果假脱机标志小于2，则JPEG将作为字符串返回。否则JPEG将打印到STDOUT。
关于函数返回值的文档提到，当出现错误而无法返回字符串时，必须始终使用布尔数据类型：
如果spool小于2，则返回JPEG，失败时返回false;否则，成功时返回true，失败时返回false。
创建 iptc_data 对象有点棘手，因此最好使用该函数文档中的示例代码，特别是其中给出的iptc_make_tag()函数：

<?php

// iptc_make_tag() function by Thies C. Arntzen
function iptc_make_tag($rec, $data, $value)
{
    $length = strlen($value);
    $retval = chr(0x1C) . chr($rec) . chr($data);

    if($length < 0x8000)
    {
        $retval .= chr($length >> 8) .  chr($length & 0xFF);
    }
    else
    {
        $retval .= chr(0x80) . 
                   chr(0x04) . 
                   chr(($length >> 24) & 0xFF) . 
                   chr(($length >> 16) & 0xFF) . 
                   chr(($length >> 8) & 0xFF) . 
                   chr($length & 0xFF);
    }

    return $retval . $value;
}

// Path to jpeg file
$path = './phplogo.jpg';

// Set the IPTC tags
$iptc = array(
    '2#120' => 'Test image',
    '2#116' => 'Copyright 2008-2009, The PHP Group'
);

// Convert the IPTC tags into binary code
$data = '';

foreach($iptc as $tag => $string)
{
    $tag = substr($tag, 2);
    $data .= iptc_make_tag(2, $tag, $string);
}

// Embed the IPTC data
$content = iptcembed($data, $path);

// Write the new image data out to the file.
$fp = fopen($path, "wb");
fwrite($fp, $content);
fclose($fp);
?>