PHP引入文件用MySQL查询数组变量为空及页面错乱如何解决

根因说明 #

最初$titles[2]输出为空的原因非常明确：PHP为顺序执行，你先引入htmlfile.php时，$titles数组还未通过SQL查询生成，自然取不到对应值。
调整顺序后页面错乱、HTML内容显示不全，可按以下优先级逐一排查解决：

排查与解决步骤 #

• 开启PHP报错定位执行中断点
  页面内容显示不全大概率是PHP执行到某一步报错强制中断导致，先在phpfile.php最顶部添加两行代码开启错误提示：

  error_reporting(E_ALL);
  ini_set('display_errors', 1);
  

  刷新页面后即可看到具体报错信息，比如变量作用域问题、数据库连接提前关闭、HTML文件内语法错误等。
• 检查数据库连接生命周期
  如果你在生成$titles数组后、引入htmlfile.php前就调用了mysqli_close()关闭数据库连接，且htmlfile.php内残留有依赖数据库连接的逻辑，就会导致后续执行报错中断，页面渲染不全。
  确认关闭数据库连接的操作必须放在所有业务逻辑执行完成后，也就是引入htmlfile.php之后再执行。
• 验证$titles数组作用域
  如果你是在函数内部生成的$titles数组，没有做全局声明或返回操作，引入的HTML文件是无法拿到该变量的：

  // 错误写法
  function queryTitles() {
    // 数据库查询逻辑
    $titles = mysqli_fetch_all($result, MYSQLI_ASSOC);
  }
  queryTitles();
  include 'htmlfile.php'; // 无法获取函数内部的$titles变量
  

  调整为正确写法即可：

  // 正确写法
  function queryTitles() {
    // 数据库查询逻辑
    return mysqli_fetch_all($result, MYSQLI_ASSOC);
  }
  $titles = queryTitles();
  include 'htmlfile.php';
  

  你可以在htmlfile.php最顶部加var_dump($titles);确认数组是否正常传递到HTML文件，确认变量正常后再往下排查。
• 修复HTML结构断裂问题
  如果$titles传递正常，要检查输出的字段内容是否破坏了HTML结构：如果BOOKS表的TITLE字段包含<、>、引号等特殊字符，直接输出会打断原有HTML标签结构，导致页面错乱。
  输出时做特殊字符转义即可，同时还能避免XSS安全风险：

  echo htmlspecialchars($titles[2]['TITLE']);
  

标准可参考代码结构 #

phpfile.php 代码 #

<?php
error_reporting(E_ALL);
ini_set('display_errors', 1);

// 第一步：连接数据库
$conn = mysqli_connect('localhost', '你的数据库用户名', '你的数据库密码', '你的数据库名');
if (!$conn) {
  die("数据库连接失败: " . mysqli_connect_error());
}

// 第二步：查询生成$titles数组
$sql = "SELECT TITLE FROM BOOKS";
$result = mysqli_query($conn, $sql);
$titles = [];
if (mysqli_num_rows($result) > 0) {
  while($row = mysqli_fetch_assoc($result)) {
    $titles[] = $row;
  }
}

// 第三步：引入HTML模板
include 'htmlfile.php';

// 第四步：最后关闭数据库连接
mysqli_close($conn);
?>

htmlfile.php 对应输出代码 #

<p><?php echo isset($titles[2]['TITLE']) ? htmlspecialchars($titles[2]['TITLE']) : '无对应数据'; ?></p>

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