如何用 PHP 动态生成多个 HTML 表格(基于 DOM 的可复用方案)

酷晨姑娘_3261

酷晨姑娘_3261

2026-05-21

825人浏览

原创

本文介绍一种基于 PHP DOM 扩展的面向对象方法,通过封装 table 类实现任意数量、结构独立的 HTML 表格动态生成,彻底摆脱模板占位符(如 #TableBody#)的单表限制,确保输出 HTML 语义正确、结构健壮。

本文介绍一种基于 php dom 扩展的面向对象方法,通过封装 `table` 类实现任意数量、结构独立的 html 表格动态生成,彻底摆脱模板占位符(如 `#tablebody#`)的单表限制,确保输出 html 语义正确、结构健壮。

在实际开发中,使用字符串替换(如 str_replace)填充 HTML 模板虽简单,但存在明显局限:占位符命名易冲突、无法嵌套、难以复用,且一旦需要渲染多个表格(例如“用户列表”+“订单汇总”+“统计图表数据”),原始模板就会失效——因为所有 #TableBody# 占位符会被统一替换为同一份内容。

更专业、可持续的解法是放弃纯字符串模板,转向 DOM 驱动的结构化生成。PHP 内置的 DOMDocument 提供了符合 W3C 标准的 HTML 构建能力,支持动态创建元素、安全插入内容、自动闭合标签,并能无缝集成到现有项目中。

以下是一个轻量、可复用的 Table 类实现(已优化命名与逻辑,避免继承 DomDocument 带来的耦合风险):

<?php class Table
{
    private $dom;
    private $table;

    public function __construct()
    {
        $this->dom = new DOMDocument('1.0', 'UTF-8');
        $this->dom->formatOutput = true; // 自动缩进,便于调试
        $this->table = $this->dom->createElement('table');
        $this->dom->appendChild($this->table);
    }

    public function addHead(array $headers): self
    {
        $thead = $this->dom->createElement('thead');
        $tr = $this->dom->createElement('tr');

        foreach ($headers as $header) {
            $th = $this->dom->createElement('th');
            $th->textContent = htmlspecialchars($header, ENT_QUOTES, 'UTF-8');
            $tr->appendChild($th);
        }

        $thead->appendChild($tr);
        $this->table->appendChild($thead);
        return $this;
    }

    public function addBody(array $rows): self
    {
        $tbody = $this->dom->createElement('tbody');

        foreach ($rows as $row) {
            $tr = $this->dom->createElement('tr');
            foreach ($row as $cell) {
                $td = $this->dom->createElement('td');
                $td->textContent = htmlspecialchars($cell, ENT_QUOTES, 'UTF-8');
                $tr->appendChild($td);
            }
            $tbody->appendChild($tr);
        }

        $this->table->appendChild($tbody);
        return $this;
    }

    public function addFoot(array $footers): self
    {
        $tfoot = $this->dom->createElement('tfoot');
        $tr = $this->dom->createElement('tr');

        foreach ($footers as $footer) {
            $th = $this->dom->createElement('th');
            $th->textContent = htmlspecialchars($footer, ENT_QUOTES, 'UTF-8');
            $tr->appendChild($th);
        }

        $tfoot->appendChild($tr);
        $this->table->appendChild($tfoot);
        return $this;
    }

    public function __toString(): string
    {
        return $this->dom->saveHTML($this->table);
    }
}

✅ 使用示例:生成两个完全独立的表格

Html2md
Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载
// 表格 1:用户信息
$userTable = new Table();
$userTable->addHead(['ID', '姓名', '邮箱'])
          ->addBody([
              ['101', '张三', 'zhang@example.com'],
              ['102', '李四', 'li@example.com']
          ])
          ->addFoot(['总计', '2人', '—']);

// 表格 2:销售统计
$salesTable = new Table();
$salesTable->addHead(['月份', '销售额(¥)', '完成率'])
           ->addBody([
               ['2024-04', '125,000', '102%'],
               ['2024-05', '142,800', '118%']
           ])
           ->addFoot(['合计', '267,800', '110%']);

// 在 HTML 中自由组合
echo "<h2>用户列表</h2>" . $userTable;
echo "<h2>月度销售</h2>" . $salesTable;

⚠️ 关键注意事项:

  • 必须启用 dom 扩展:确认 php.ini 中已开启 extension=dom(绝大多数现代 PHP 环境默认启用);
  • XSS 防护不可少:示例中已使用 htmlspecialchars() 转义所有单元格内容,禁止直接插入未过滤的用户输入;
  • 性能友好:每个 Table 实例相互隔离,内存独立,适合循环批量生成(如 foreach 多个数据集);
  • 扩展性强:可轻松添加 addClass(), setCaption(), addRowGroup() 等方法,适配复杂业务需求;
  • 不依赖外部库:零第三方依赖,开箱即用,兼容 PHP 7.4+ 及所有主流框架。

这种方法不仅解决了“一个模板多张表”的核心诉求,更将 HTML 构建提升为类型安全、可测试、可维护的编程实践——告别脆弱的字符串拼接,拥抱结构化、可演进的 Web 输出方案。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php html

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

11584

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6681

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2175

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4228

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4954

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3891

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5597

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4382

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12322

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习