包简介

HTML file filter for the OpenCAT Framework

README 文档

README

HTML file filter for the CAT Framework.

Installation

composer require catframework/filter-html

Requires ext-dom and ext-libxml.

Usage

use CatFramework\FilterHtml\HtmlFilter;

$filter = new HtmlFilter();

// Extract translatable segments
$document = $filter->extract('page.html', 'en', 'fr');

foreach ($document->getSegmentPairs() as $pair) {
    $pair->target = new Segment('seg-t', [$translatedText]);
}

// Write the translated file
$filter->rebuild($document, 'page.fr.html');

What gets extracted

The filter uses a block element taxonomy to decide segmentation boundaries:

Block elements (each becomes at most one segment): <p>, <div>, <h1>–<h6>, <li>, <td>, <th>, <dt>, <dd>, <blockquote>, <figcaption>, <caption>

A block element with only text / inline children → extracted as one segment.
A block element that itself contains other block elements → recursed into (not extracted as a whole).

Inline elements inside a segment become InlineCode pairs so translators see placeholders rather than raw HTML tags: <b>, <strong>, <i>, <em>, <a>, <span>, <sub>, <sup>, <code>, <abbr>, <u>, <small>, <mark>

Void elements (<br>, <img>, <input>, etc.) become standalone InlineCode placeholders.

Whitespace-only blocks are silently skipped.

Skeleton format

[
    'html'    => string,   // serialized DOMDocument with {{SEG:NNN}} tokens in place of block content
    'seg_map' => [         // segId => token string
        'seg-1' => '{{SEG:001}}',
        // …
    ],
]

Limitations

Full HTML documents only: the filter expects a <body> element. Fragment-only strings (no wrapping body) will produce no segments.
Structural elements outside the body (<head>, <title>, <meta>) are not extracted.
Unknown non-block elements are treated as inline and wrapped as InlineCode pairs.
Invalid nesting (block element inside an inline context) is silently ignored.

opencat/filter-html 适用场景与选型建议

opencat/filter-html 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 0 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 05 月 09 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 opencat/filter-html 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 opencat/filter-html 我们能提供哪些服务？

定制开发 / 二次开发

基于 opencat/filter-html 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

opencat/filter-html

包简介