本文讲解如何将数据库查询逻辑封装在php函数中，避免直接输出html，改为返回数据数组，再在html模板中安全遍历渲染，实现关注点分离与代码可维护性。
本文讲解如何将数据库查询逻辑封装在php函数中，避免直接输出html，改为返回数据数组，再在html模板中安全遍历渲染，实现关注点分离与代码可维护性。
在PHP开发中，将数据获取与页面呈现混写（如在函数内直接 echo HTML 或字段值）会导致逻辑耦合、难以复用、无法测试，且极易引发XSS或SQL注入风险。正确做法是：函数只负责获取并返回结构化数据，视图层（HTML）负责安全渲染。
以下是一个优化后的完整实践方案：
✅ 正确的函数设计：返回数据，不输出HTML
function getData() {
try {
$pdo = new PDO("mysql:host=localhost;dbname=db", 'root', '');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
$sql = "SELECT id, username, email, created_at FROM users";
$stmt = $pdo->prepare($sql);
$stmt->execute();
// 关键：收集所有行，统一返回数组，而非 echo
return $stmt->fetchAll(); // 等价于 foreach + $results[] + return
} catch (PDOException $e) {
error_log("Database query failed: " . $e->getMessage()); // 记录错误，不暴露给用户
return []; // 返回空数组，保证调用方总有可遍历的数据结构
}
}? 说明：
- 使用 PDO::FETCH_ASSOC 确保结果为关联数组（$row['username'] 可用）；
- fetchAll() 替代手动 foreach，更简洁高效；
- 错误仅记录日志，不 echo 敏感信息，提升安全性；
- 始终返回数组（即使为空），避免调用方出现 Invalid argument supplied for foreach() 警告。
✅ HTML模板中安全渲染：解耦逻辑与展示
<table border="1" class="table">
<thead>
<tr>
<th>ID</th>
<th>用户名</th>
<th>邮箱</th>
<th>注册时间</th>
</tr>
</thead>
<tbody>
<?php $users = getData(); ?>
<?php if (empty($users)): ?>
<tr>
<td colspan="4" class="text-center">暂无用户数据</td>
</tr>
<?php else: ?>
<?php foreach ($users as $user): ?>
<tr>
<td><?php echo htmlspecialchars($user['id'] ?? ''); ?></td>
<td><?php echo htmlspecialchars($user['username'] ?? ''); ?></td>
<td><?php echo htmlspecialchars($user['email'] ?? ''); ?></td>
<td><?php echo htmlspecialchars($user['created_at'] ?? ''); ?></td>
</tr>
<?php endforeach; ?>
<?php endif; ?>
</tbody>
</table>⚠️ 关键注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 永远对输出到HTML的内容使用 htmlspecialchars() —— 防止XSS攻击，尤其当字段含用户输入（如用户名、邮箱）时；
- 使用 ?? '' 提供默认值，避免访问未定义键触发 Notice；
- 添加空数据兜底提示（if (empty($users))），提升用户体验与健壮性；
- 数据库连接不应在每次调用 getData() 时新建——生产环境建议使用依赖注入或单例PDO实例复用连接。
✅ 进阶建议（可选）
- 将数据库配置提取至 .env 文件，避免硬编码；
- 使用 try/catch 外部捕获异常，统一处理错误响应（如返回JSON API）；
- 对于大型数据集，考虑分页查询（LIMIT/OFFSET）+ COUNT(*) 总数统计；
- 函数可接受参数（如 $limit = 20），增强复用性：getData(10)。
遵循“函数返回数据、模板负责渲染”的原则，不仅能写出更清晰、可测试、易维护的PHP代码，也为后续迁移到MVC框架（如Laravel、Symfony）打下坚实基础。
