# @barefootjs/php 中文文档

规范地址：https://npmcn.com/package/%40barefootjs/php/

版本：0\.40\.2
npm 元数据更新时间：2026-11-02T02:53:07.674Z
中文译文更新时间：2026-11-09T21:16:53.870Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40barefootjs/php
原文对照：https://npmcn.com/package/%40barefootjs/php/?lang=original
项目主页：https://github.com/piconic-ai/barefootjs#readme
源码仓库：https://github.com/piconic-ai/barefootjs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：257 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-07-07T10:51:24.338Z
- 最新版本发布：2026-11-02T02:53:07.357Z
- 近 30 天下载量：1726（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：78（近 12 个月 78 个）

## 中文简介

赤脚JS引擎-不可知 PHP 运行时间 - 可插件渲染后端; Twig, Blade 和其他 PHP 引擎集成的共享基础

## 安装

```sh
npm install @barefootjs/php
```

也可以使用：`pnpm add @barefootjs/php`、`yarn add @barefootjs/php`、`bun add @barefootjs/php`

## README

# {\\fn方正黑体简体\\fs18\\b1\\bord1\\shad1\\3ch2f2f2f}美国海军司令部

引擎不可知论 **PHP 运行时间** 页:1 [赤脚JS](https://barefootjs.dev/) —— 说 页:1 `BarefootJS` 类(`BarefootJS.php`),用于编译标记模板调用 作为 `bf` 对象(`bf.json(...)`, (中文(简体) ), `bf.spread_attrs(...)`,数组/字符串 方法辅助器、水分标记、子组件渲染.

这个软件包 **无依赖关系** 超越核心PHP(QQ8.2). 所有的东西 取决于 _怎么样_ 提供了模板—— JSON 集合、生弦 标记、JSX-儿童实现、命名-模板渲染,以及 模板可变名称管理方式——被授权给一个可插件 **后端**这样 相同的运行时间可以驱动任何PHP模板引擎(Twig, Blade,.

```
JSX → IR → (compile-time adapter) → marked template ─┐
                                                      ├─► rendered by the host's
  BarefootJS runtime ── backend ── template engine ───┘    template engine
```

## 后端合同

一个后端执行五个方法:

| 方法 | 目的 |
| --- | --- |
| `encode_json($data)` | JSON 编码一个值( 可注入; 默认值为 `Barefoot\Json::canonicalEncode`(中文(简体) ) |
| `mark_raw($str)` | 标出一个字符串,使引擎不重起覆辙地释放出来 |
| `materialize($value)` | 将抓取的孩子值解为字符串 |
| `render_named($name, $bf, $vars)` | 以 `$bf` 绑定 |
| `ident($name)` | 为这个引擎的预留词组设置一个可变模板名称 |

输入后端 `new BarefootJS($c, ['backend' => $backend])`。 。 。 .

## 参考执行情况

[`@barefootjs/twig`](https://npmcn.com/package/%40barefootjs/adapter-twig) 提供 `Barefoot\TwigBackend` (目标 `twig/twig`\+ 编译时间适配器,以发出 Twig 模板( e)`.twig`) (中文(简体) ).

## 作曲家

Packagist 分发名称为 `barefootjs/php`Npm 软件包 同样的船 `src/` 所以单相融合可以消耗它而不用 单独安装.

这个包在"赤脚JS"单列波中维护,并被镜像为 a Packagist- facing 仓库只用于作曲器发行.

-   真相来源: [https://github.com/piconic-ai/barefootjs/tree/main/packages/adapter-php 页面存档备份,存于互联网档案馆](https://github.com/piconic-ai/barefootjs/tree/main/packages/adapter-php)
-   莫诺雷波: [https://github.com/piconic-ai/barefootjs (中文(简体) )](https://github.com/piconic-ai/barefootjs)
-   npm 软件包 : `@barefootjs/php`
-   作曲软件包 : `barefootjs/php`

不向 Packagist 镜像发送执行拉请求 。 发送更改到 ; 发布工作流程拆分此目录并按下 自动镜相.

## 测试

```sh
php tests/run.php
```

零依赖性,无 PHP Unit 的 TAP-ish 牵引(`tests/_harness.php`) (中文(简体) ). 每个 `test_*.php` 文件也可以通过 `php tests/test_foo.php`。 。 。 . 包括金色的助行器`test_helper_vectors.php`和 评估员(`test_eval_vectors.php`(f) 配套套房——见 `spec/template-helpers.md`。 。 。 .

## 常见问题

### @barefootjs/php 是什么？

赤脚JS引擎-不可知 PHP 运行时间 - 可插件渲染后端; Twig, Blade 和其他 PHP 引擎集成的共享基础

### 如何安装 @barefootjs/php？

在项目目录运行 npm install @barefootjs/php，或使用 pnpm add / yarn add / bun add。

### @barefootjs/php 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/barefootjs\_\_php 是否存在。

### @barefootjs/php 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @barefootjs/php 可以商用吗？

@barefootjs/php 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @barefootjs/php 的下载量有多少？

根据 npm 官方下载统计，@barefootjs/php 在 2026/10/08 – 2026/11/06 这 30 天内被下载 1,726 次，日均约 58 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @barefootjs/php 还在维护吗？

最新版本 0\.40\.2 发布于 2026/11/02（7 天前）；至今共发布 78 个版本，其中过去 12 个月发布了 78 个；首次发布于 2026/07/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。