WordPress中PhpSpreadsheet导出Excel图片路径错误的解决问询

错误原因 #

PhpSpreadsheet处理图片时要求传入服务器本地绝对文件路径，若传入Web URL（如http://your-site.com/wp-content/uploads/xxx.jpg）或相对路径，库会在ContentTypes.php第226行执行文件存在性检查时失败，触发致命错误。

解决方案（针对WordPress环境） #

1. 替换Web URL为本地绝对路径 #

WordPress媒体库的图片可通过以下方式获取本地路径：

• 若已知图片附件ID：

// 获取采购订单关联的图片附件ID
$attachment_id = get_post_thumbnail_id($order_id);
// 获取附件本地存储路径
$image_path = get_attached_file($attachment_id);
// 转为绝对路径（兼容WordPress子目录安装场景）
$absolute_image_path = ABSPATH . ltrim($image_path, '/');

• 若仅持有图片相对路径（如从自定义字段获取）：

$upload_dir = wp_get_upload_dir();
// 自定义字段存储的图片相对路径，示例：2024/06/order-123.jpg
$relative_path = get_post_meta($order_id, 'order_image', true);
$absolute_image_path = $upload_dir['basedir'] . '/' . $relative_path;

2. 增加文件存在性校验 #

在设置图片路径前先检查文件是否存在，避免触发报错：

use PhpOffice\PhpSpreadsheet\Worksheet\Drawing;

$drawing = new Drawing();
if (file_exists($absolute_image_path)) {
    $drawing->setPath($absolute_image_path);
    // 配置图片在Excel中的位置、大小
    $drawing->setCoordinates('A1');
    $drawing->setHeight(80);
} else {
    // 图片不存在时的降级处理，比如使用默认占位图
    $default_image = ABSPATH . 'wp-content/themes/your-theme/assets/default-order-image.jpg';
    if (file_exists($default_image)) {
        $drawing->setPath($default_image);
    }
}

3. 路径调试技巧 #

若问题仍存在，可临时输出路径确认准确性：

var_dump($absolute_image_path);
// 验证服务器是否能读取该路径
var_dump(file_exists($absolute_image_path));
exit;

关键注意事项 #

• 避免使用$_SERVER['DOCUMENT_ROOT']，WordPress安装在子目录时该变量可能不准确，优先用ABSPATH常量或wp_get_upload_dir()的basedir字段。
• 确保服务器对图片文件有读取权限，否则即使路径正确，PhpSpreadsheet也无法访问。

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