Skip to content

新增 Yac 扩展文档的中文翻译 - #1059

Merged
shiny merged 1 commit into
php:masterfrom
laruence:translate-yac
Aug 27, 2026
Merged

新增 Yac 扩展文档的中文翻译#1059
shiny merged 1 commit into
php:masterfrom
laruence:translate-yac

Conversation

@laruence

Copy link
Copy Markdown
Member

概述

对照 doc-en 的 yac-docs-revision 分支(commit b2bb7d0),新增 Yac 扩展文档的中文翻译,共 15 个 XML 文件:

  • 顶层页:book(扩展简介,含无锁语义与适用边界说明)、setup(需求、安装、资源)、ini(7 个运行时配置项)、constants(预定义常量)
  • 类页:yac.xml(Yac 类)
  • 方法页 ×10:construct、add、set、get、getter、setter、delete、flush、info、dump(签名、参数、返回值、示例、See Also 均已翻译)

未翻译的文件及原因

  • versions.xml:带 <?do-not-translate?> 指令,由脚本自动维护
  • configure.xml:在 doc-en 中未被任何实体引用(孤儿文件,英文手册中不渲染)

说明

  • 每个文件头部已标注 EN-Revision,便于追踪上游变更
  • 翻译源是 doc-en 中修订过的版本:方法签名已对照扩展源码修正(如 Yac::get 移除了不存在的 &$cas 参数、Yac::deletettl 参数实为 delay),并补充了可运行示例

校验

  • doc-base configure.php --with-lang=zh 校验通过
  • phd 本地渲染抽查通过(签名、版本条、See Also 链接、setup 子页面均正常)

@laruence

laruence commented Aug 27, 2026

Copy link
Copy Markdown
Member Author

@sy-records 还有这个和yaconf的那个,谢谢

@laruence

Copy link
Copy Markdown
Member Author

已同步上游 php/doc-en#5810(合并提交 d3a03f8)对 yac 文档的增强:

  • book.xml:无锁设计带来的极致性能结论段、2.4.0 嵌入值(embedded values)与 LZ4 说明
  • yac.xml:Yac 类介绍与 _prefix 属性说明
  • yac/delete.xml:延迟过期语义(标记过期、槽位不回收、slots_used 不减、dump 结果需自行过滤)、重复删除与多键删除的返回值语义、示例修正
  • yac/dump.xml$offset 自 2.4.0 起可用、$limit-1 全量导出及内存提示
  • setup.xml:PIE 安装(2.3.2 起)与源码构建示例,LZ4 于 2.4.0 替换 FastLZ

五个文件的 EN-Revision 均已更新为 d3a03f8f542cd083d793bbd8ef3d7756aae7711f(doc-en master 上对应文件的最新提交),并已在本地用 configure.php --with-lang=zh 校验、phd 渲染抽查通过。

@shiny
shiny merged commit 63aea3a into php:master Aug 27, 2026
3 checks passed
@laruence
laruence deleted the translate-yac branch August 28, 2026 00:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants