PHP MySQL渲染带商店链接的YouTube iframe不显示问题排查

iframe无法渲染的核心问题有两个：

1. src属性内的PHP代码没有输出逻辑：你写的<?php $envoie['upload_lien'] ?>只是在PHP作用域内引用了变量，没有把变量值打印到HTML里，最终渲染出来的iframe标签src属性为空，浏览器找不到要加载的资源地址。
2. 大概率存在YouTube链接格式不兼容问题：如果数据库里存储的是YouTube普通观看页链接（比如https://www.youtube.com/watch?v=xxx、短链接https://youtu.be/xxx），这类链接不能直接作为iframe的src使用，YouTube要求嵌入播放器必须使用https://www.youtube.com/embed/[视频ID]格式的专用地址。

• 首先补全src处的输出逻辑，同时增加HTML实体转义，避免链接中的特殊字符破坏HTML结构，对应iframe代码行修改为：

<iframe width="560" height="315" src="<?php echo htmlspecialchars($envoie['upload_lien']); ?>" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

• 如果你数据库里存的不是现成的embed嵌入链接，需要先对链接做格式转换，下面是简单的转换示例，放在foreach循环内输出iframe之前即可：

// 提取YouTube视频ID，兼容普通观看链接、短链接两种格式
preg_match('%(?:youtube(?:-nocookie)?\.com/(?:[^/]+/.+/|(?:v|e(?:mbed)?)/|.*[?&]v=)|youtu\.be/)([^"&?/ ]{11})%i', $envoie['upload_lien'], $match);
if (!empty($match[1])) {
    $embedUrl = 'https://www.youtube.com/embed/' . $match[1];
} else {
    // 非YouTube链接直接用原值，可根据业务需求加错误处理逻辑
    $embedUrl = $envoie['upload_lien'];
}

之后把iframe的src属性值替换为上面处理好的$embedUrl即可。

<?php
$requete = $database->prepare('SELECT * FROM envoie ORDER BY id');
$requete->execute();
$envoies = $requete->fetchAll(PDO::FETCH_ASSOC);

foreach($envoies as $envoie) :
    // 预处理YouTube嵌入链接
    preg_match('%(?:youtube(?:-nocookie)?\.com/(?:[^/]+/.+/|(?:v|e(?:mbed)?)/|.*[?&]v=)|youtu\.be/)([^"&?/ ]{11})%i', $envoie['upload_lien'], $match);
    $embedUrl = !empty($match[1]) ? 'https://www.youtube.com/embed/' . $match[1] : $envoie['upload_lien'];
?>
    <h3 class="comm"><?php echo htmlspecialchars($envoie['upload_title']); ?></h3>
    <h3 class="comm"><?php echo htmlspecialchars($envoie['upload_description']); ?></h3>
    <iframe width="560" height="315" src="<?php echo htmlspecialchars($embedUrl); ?>" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
    <h3 class="comm"><?php echo htmlspecialchars($envoie['upload_temps']); ?></h3>
    <br><hr><br>
<?php endforeach; ?>

注意：上面给所有动态输出的内容都加了htmlspecialchars()转义，避免存储内容里的特殊字符导致HTML结构错乱，同时能防范基础的XSS注入风险。

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