WordPress问题：使用list_files()遍历图片无法正常工作

首先，你的代码存在两个核心问题导致图片遍历失败：

1. bloginfo() 直接输出内容而非返回值 #

bloginfo('template_url') 函数的作用是直接输出主题URL，而不是将字符串返回给变量。所以当你执行 $imagePath = bloginfo(...) 时，它已经把URL打印到页面上了，$imagePath 实际上是空值——这也是你调试时只看到URL输出的原因。

正确的做法是使用 get_bloginfo('template_url')，它会返回字符串而非直接输出内容。

2. list_files() 需要服务器本地路径而非URL #

list_files() 函数要求传入的是服务器文件系统的物理路径（比如 /var/www/wordpress/wp-content/themes/...），而不是HTTP URL。你传入的是主题的URL，函数根本无法定位到实际的文件夹，自然返回空的文件列表。

我们可以用 get_template_directory() 来获取主题的本地物理路径，拼接上图片文件夹的相对路径后再传给 list_files。

修正后的代码 #

function loopImages(){ 
    // 获取主题本地物理路径，拼接目标图片文件夹
    $localImagePath = get_template_directory() . '/assets/images/casa_intera';
    // 获取图片文件夹的访问URL，用于前端img标签的src属性
    $imageUrl = get_bloginfo('template_url') . '/assets/images/casa_intera/';

    // 调用list_files获取文件列表，第二个参数2表示只返回文件（不包含子文件夹）
    $fileList = list_files($localImagePath, 2);

    // 先判断是否获取到有效文件列表，避免空循环报错
    if ($fileList && is_array($fileList)) {
        foreach ($fileList as $file) {
            // 从完整本地路径中提取文件名
            $fileName = basename($file);
            // 输出img标签，用esc_url转义URL保障安全
            echo '<img src="' . esc_url($imageUrl . $fileName) . '" alt="" data-fancybox="gallery" loading="lazy">';
        }
    } else {
        echo '未找到任何图片文件';
    }
} 
loopImages();

额外说明 #

• 加入 esc_url() 函数是WordPress开发的最佳实践，用于转义URL避免XSS安全问题。
• 用 basename() 从完整本地路径中提取文件名，才能正确拼接成前端可访问的图片URL。
• 添加空值判断，防止文件夹为空或不存在时出现PHP错误。

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