PHP数组新增元素异常：多图Instagram帖子标题无法添加

问题背景 #

使用Instaloader Python库收集Instagram图片并展示到网站图库时，单图帖子可正常显示并加载标题，但多图帖子无法正确关联标题。Instaloader对多图帖子的命名规则为：图片文件名后缀添加_1/_2等序号，对应标题存储在同前缀的.txt文件中。

文件结构示例 #

多图帖子文件 #

2022-12-26_14-14-01_UTC.txt
2022-12-26_14-14-01_UTC_1.jpg
2022-12-26_14-14-01_UTC_2.jpg
2022-12-26_14-14-01_UTC_3.jpg

单图帖子文件 #

2022-12-31_18-13-43_UTC.txt
2022-12-31_18-13-43_UTC.jpg

问题原因 #

脚本处理文件时可能先读取.txt文件，此时对应帖子的数组条目尚未创建；同时依赖date值查找数组键的方式存在缺陷，导致$arrayKey返回false，无法完成标题关联。

修复方案 #

核心思路是先基于文件前缀分组初始化所有图片帖子，再批量关联标题，避免处理顺序问题，同时用统一的前缀作为关联标识，替代不可靠的date键。

1. 提取文件核心前缀的工具函数 #

该函数可以统一处理单图/多图文件，提取出用于关联的唯一前缀：

function getFilePrefix($filename) {
    $nameWithoutExt = pathinfo($filename, PATHINFO_FILENAME);
    // 匹配多图文件的_数字后缀，提取核心前缀
    if (preg_match('/^(.*)_\d+$/', $nameWithoutExt, $matches)) {
        return $matches[1];
    }
    return $nameWithoutExt;
}

2. 重构文件处理流程 #

$posts = [];
$imageDir = 'path/to/your/image/directory';

// 第一步：遍历所有图片，按前缀分组初始化帖子
$imageFiles = glob($imageDir . '/*.jpg');
foreach ($imageFiles as $imgPath) {
    $filename = basename($imgPath);
    $prefix = getFilePrefix($filename);
    
    if (!isset($posts[$prefix])) {
        $posts[$prefix] = [
            'title' => '',
            'images' => []
        ];
    }
    $posts[$prefix]['images'][] = $imgPath;
}

// 第二步：遍历所有txt文件，填充对应帖子的标题
$txtFiles = glob($imageDir . '/*.txt');
foreach ($txtFiles as $txtPath) {
    $filename = basename($txtPath);
    $prefix = getFilePrefix($filename);
    
    if (isset($posts[$prefix])) {
        // 读取并清理标题内容
        $posts[$prefix]['title'] = trim(file_get_contents($txtPath));
    }
}

// 第三步：渲染图库
foreach ($posts as $post) {
    echo '<div class="gallery-post">';
    if (!empty($post['title'])) {
        echo '<h4 class="post-title">' . htmlspecialchars($post['title']) . '</h4>';
    }
    foreach ($post['images'] as $img) {
        $imgRelativePath = str_replace($imageDir . '/', '', $img);
        echo '<img src="' . htmlspecialchars($imgRelativePath) . '" alt="' . htmlspecialchars($post['title']) . '" class="gallery-image">';
    }
    echo '</div>';
}

方案优势 #

• 先处理图片创建分组，再关联标题，彻底避免了文件读取顺序导致的键不存在问题
• 用统一前缀作为关联标识，适配单图和多图的命名规则，关联逻辑更可靠
• 代码结构清晰，后续维护和扩展更方便

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