phpgt/dom
Composer 安装命令：
composer require phpgt/dom
包简介
Modern DOM API.
README 文档
README
Modern DOM API.
Built on top of PHP's native DOMDocument, this project provides access to modern DOM APIs, as you would expect working with client-side code in the browser.
Performing DOM manipulation in your server-side code enhances the way dynamic pages can be built. Utilising a standardised object-oriented interface means the page can be ready-processed, benefiting browsers, webservers and content delivery networks.
Example usage: Hello, you!
Important note: the example shown here is for illustrative purposes, but using the DOM to directly set data to elements' values tightly couples the logic to the view, which is considered bad practice. Please see the DomTemplate library for a more robust solution to binding data to the DOM.
Consider a page with a form, with an input element to enter your name. When the form is submitted, the page should greet you by your name.
This is a simple example of how source HTML files can be treated as templates. This can easily be applied to more advanced template pages to provide dynamic content, without requiring non-standard techniques such as {{curly braces}} for placeholders, or echo '<div class='easy-mistake'>' . $content['opa'] . '</div>' error-prone HTML construction from within PHP.
Source HTML (name.html)
<!doctype html> <h1> Hello, <span class="name-output">you</span> ! </h1> <form> <input name="name" placeholder="Your name, please" required /> <button>Submit</button> </form>
PHP used to inject your name (index.php)
<?php use GT\Dom\HTMLDocument; use GT\Dom\HTMLElement\HTMLSpanElement; require "vendor/autoload.php"; $html = file_get_contents("name.html"); $document = new HTMLDocument($html); if(isset($_GET["name"])) { $span = $document->querySelector(".name-output"); $span->innerText = $_GET["name"]; } echo $document;
Features at a glance
- Compatible with W3C's DOM Living Standard:
- The
Elementtype represents allHTMLElementspecifications, such asHTMLAnchorElement(<a>),HTMLButtonElement(<button>),HTMLInputElement(<input>),HTMLTableSectionElement(<thead>,<tbody>,<tfoot>), etc. The particular type can be detected withElement::getElementType(), which returns one of theElementTypeenum values. DOMExceptionextensions for catching different types of exception, such asEnumeratedValueException,HierarchyRequestError,IndexSizeException, etc.- Client-side functionality stubbed including classes for
FileList,StyleSheet,VideoTrackList,WindowProxy, etc.
- The
- DOM level 4+ functionality:
- Reference elements using CSS selectors via
Element::querySelector()and (Element::querySelectorAll()) - Add/remove/toggle elements' classes using
ClassList - Traverse Element-only Nodes with
Element::previousElementSibling,Element::nextElementSibling,Element::childrenandElement::lastElementChildandfirstElementChild, etc. - Insert and remove child Nodes with
ChildNode::remove(),ChildNode::before,ChildNode::after,ChildNode::replaceWith()
- Reference elements using CSS selectors via
- Standard properties on the
HTMLDocument:
Known limitations / W3C spec compliance
This repository aims to be as accurate as possible to the DOM specification at https://dom.spec.whatwg.org/ - as of v4.0.0 all functionality is implemented with the following minor but unavoidable deviations from the standard:
- Elements'
tagNameproperty is uppercase. - To check the
HTMLElementtype,Element::getElementType()must be called - no subclasses ofElementare available for usage withinstanceof, for example. - The DOM specification defines functionality that is only possible to implement on the client-side. For example,
HTMLInputElement::filesreturns aFileListthat enumerates all files that are selected by the user through the browser's interface. This kind of functionality is impossible to implement server-side, but has been stubbed out for consistency with the specification. Attempting to use client-side functionality within this library throws aClientSideOnlyFunctionalityException.
Data binding and page template features
This repository is intended to be as accurate to the DOM specification as possible. An extension to the repository is available at https://php.gt/domtemplate which adds page templating and data binding through custom elements and template attributes, introducing serverside functionality like that of WebComponents.
PHP 8.4 native HTMLDocument
Since PHP 8.4's release, there has been a new native HTMLDocument class shipped in PHP natively. With this having native bindings, all operations are much faster. Work has been started to make PHPGT's Dom implementation utilise the new native code. Luckily, the DOM is a very well defined standard so whatever happens, minimal or no changes will be required to your code.
More information will be laid out in the readme when more work has been taken towards an implementation of the native classes.
Proudly sponsored by
JetBrains Open Source sponsorship program
phpgt/dom 适用场景与选型建议
phpgt/dom 是一款 基于 PHP 开发的 Composer 扩展包，目前已累计 12.98M 次下载、GitHub Stars 达 124， 最近一次更新时间为 2016 年 02 月 16 日， 在 PHP 生态内属于活跃度较高的组件。
我们在过去多个企业项目中使用过 phpgt/dom 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。
基于 phpgt/dom 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。
统计信息
- 总下载量： 12.98M
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 126
- 点击次数： 14
- 依赖项目数： 20
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2016-02-16