普贤教程 › 生态包

生态包总览

195 个生态包，全部随 PuXian 0.2.382 提供。其中 140 个已到 0.2.0，参考页一律按最新版生成。每个包一页：一句话用途、安装命令、接口速查、源码头注释。

怎么用

bash

pxpkg init                 # 在项目根目录初始化，产生 .px_modules/
pxpkg add redis@0.2.0      # 加依赖
pxpkg install              # 装到 .px_modules/，锁定 px.pkg.lock

import redis               # 裸名：从 .px_modules/ 命中

裸名包与 std.* 同名时优先命中 .px_modules/。官方包（collections / semver / webroute / yaml / pxml / lunar / gfx / png / edge）与 std.* 同源，import std.xxx 不需要装包。

按主题的实战教程

参考页给的是「有什么函数」，实战页给的是「怎么用、哪里会炸」。195 个包已全部覆盖，没有遗漏。日常函数与工具类包另有 1 篇分类一览 + 5 篇实战：

教程	覆盖的包
实用函数包一览	装包与 import 验证 · 按用途分类 · PHP 函数对照
文本与格式化	arrutil · compact · ctype · multisort · numconv · phonetic · simtext · sprintf · strpad · textfmt · vardump · colorutil
Web 安全与校验	aescbc · descrypt · hashutil · csrf · session · htmlsanitizer · jsonschema · outbuf · errorhandler · mimebuilder · cldr · gettext
数据结构与并发	advstruct · splstruct · channel · promise · eventloop · connpool · deepmerge · phpser · snapshot · mathx · currency · finance
协议与归档	ldap · snmp · ntp · whois · xmlrpc · soap · memcached · phar · uuencode · rssbuilder · vcard · geo
数据访问与解析	dbal · querybuilder · orm · migration · domlite · xmlstream · xpath · scraper · exif · fileinfo · dateperiod · strtotime
二进制与归档	bytes_pack · bson · protobuf · tar · targz · properties
解析与提取	parser · pxml · htmlparse · mailparse · readstat
测试与对比	testkit · tdtest · quickcheck · diff
文本加工进阶	textwrap · strcase · slug · hant · inflect · natsort · richmd
文件系统与配置	walk · fsnotify · config · edge
并发容器与数值	concurrent_map · datastruct · dist · fractions
FTP / IMAP / POP3	ftp · imap · pop3
包使用边界	返回值形态与运行条件的边界速查，每条给可跑的调用

分类总览

分类	包数	面向
Web 与 HTTP	6	路由、Cookie、模板、桩服务
可观测与测试	9	日志、指标、基准与测试
图形与媒体	6	画布、PNG、条码、二维码
并发与通用模式	19	限流、重试、缓存、并发原语
数学与统计	11	大数、精确小数、金额、统计
数据库	8	连库、查询、事务、缓存
数据格式与编解码	41	解析与序列化、压缩、归档
数据结构	12	集合、树、堆、图、布隆
文件系统	7	遍历、通配、拷贝、监听
文本与中文处理	31	终端输出、中文处理、文本清洗
时间与日历	6	时间运算、时区、节假日、农历
标识、校验与版本	6	ID 生成、校验位、版本号
网络与协议	16	DNS、TCP、端口、邮件与物联网协议
认证与安全	17	密码、令牌、校验码、签名

Web 与 HTTP

包	说明	函数	行数
`cookiejar`	会话 Cookie 管理（HTTP 客户端复用）	17	299
`mock`	HTTP 桩服务器 / 测试请求客户端	16	236
`scraper`	网页爬虫（HTML 解析/链接提取，纯函数）	10	145
`session`	Session 会话管理（纯函数，无 IO）	11	97
`template`	0.2.0 —— 轻量模板渲染（增强版）	18	339
`webroute`	文件即路由命名规则（M43）	4	113

可观测与测试

包	说明	函数	行数
`bench`	微基准计时	5	76
`diff`	行级 diff（LCS）	8	242
`log`	分级日志	20	175
`metrics`	Prometheus 指标（文本格式）	17	167
`quickcheck`	属性测试	8	77
`snapshot`	快照测试（比对序列化输出与已存快照）	7	77
`statx`	统计增强（描述统计 + 相关系数 + 线性回归）	12	191
`tdtest`	表驱动测试增强	5	75
`testkit`	断言与测试辅助	20	129

图形与媒体

包	说明	函数	行数
`barcode`	0.2.0 —— 多制式条形码生成	16	299
`colorutil`	颜色工具	24	324
`exif`	EXIF 元数据解析（纯函数，解析 JPEG EXIF 字节）	7	87
`gfx`	纯语言 2D 游戏内圈（M61-S2，第 5 个 stdlib）	14	162
`png`	纯语言 PNG 编码器（stored 无压缩，M61-S2，第 6 个 stdlib…	6	100
`qrcode`	QR 码生成	81	1625

并发与通用模式

包	说明	函数	行数
`actor`	Actor 消息模式封装	10	86
`cache`	TTL / LRU 缓存	17	151
`channel`	CSP Channel（对应 Go channel / PHP Fiber）	9	57
`concurrent_map`	并发安全映射	10	96
`connpool`	连接池（纯函数，状态管理）	9	34
`counter`	计数（collections.Counter 心智）	16	192
`dist`	随机分布采样	16	127
`errorhandler`	自定义错误捕获（对应 PHP set_error_handler/error_reporting�…	8	51
`eventloop`	事件循环（同步模拟）	12	125
`functools`	函数式工具（partial/compose/memoize）	19	146
`itertools`	集合组合子	39	432
`outbuf`	输出缓冲区（对应 PHP ob_start/ob_get_clean）	8	57
`plex`	复数	20	140
`promise`	Promise/Future 异步原语（同步模拟，纯函数）	13	97
`rate`	令牌桶限流	11	115
`retry`	带退避的重试	10	129
`sched`	轻量任务调度器（时间片轮询）	7	103
`semaphore`	信号量（计数限流）	10	87
`workerpool`	协程任务池	8	94

数学与统计

包	说明	函数	行数
`big`	任意精度大整数	25	428
`currency`	货币转换	17	201
`decimal`	任意精度十进制数	28	536
`finance`	财务计算	21	249
`fractions`	精确有理数	27	244
`geo`	地理计算	19	213
`mathx`	扩展数学函数（PHP Math 扩展：双曲/取模/角度/常数）	18	149
`money`	金额格式化 / 解析	20	207
`stats`	描述统计	21	255
`thousep`	数字千分位 / 序数格式	8	158
`units`	常用单位换算	10	180

数据库

包	说明	函数	行数
`dbal`	数据库抽象层（db_* 前缀）	15	138
`migration`	schema 迁移工具（纯函数）	11	77
`mongodb`	轻量 MongoDB 客户端（OP_MSG 协议）	30	375
`mysql`	MySQL 客户端驱动	52	1063
`orm`	简化 ORM	21	283
`pg`	PostgreSQL 客户端驱动	40	651
`querybuilder`	链式 SQL 构造	25	382
`redis`	Redis 客户端（RESP 协议）	58	365

数据格式与编解码

包	说明	函数	行数
`base58`	Base58 / Base58Check 编码	13	220
`bson`	BSON 编解码（基础类型子集）	18	229
`bytes_pack`	二进制 pack/unpack	20	259
`checksum`	CRC32 / Adler32 校验和	10	123
`config`	配置合并与读取	14	246
`csv`	0.2.0 —— RFC 4180 CSV 解析与序列化（增强版）	22	354
`domlite`	DOM 树操作（简化版，纯函数）	10	65
`dotenv`	.env 配置解析	18	293
`html`	简化 HTML5 容错解析器（提取正文/简单选择器）	26	446
`htmlparse`	HTML 解析（子集）	20	315
`ini`	INI 配置解析	18	235
`jsonpath`	JSON 路径取值	11	176
`jsonschema`	JSON Schema 验证	7	151
`lz4`	LZ4 block 格式压缩（纯 .px 实现）	9	159
`mailparse`	邮件消息解析（RFC 5322 子集）	11	233
`markdown`	Markdown → 纯文本渲染	10	196
`mimebuilder`	MIME 邮件构造	19	332
`msgpack`	MessagePack 编解码	18	367
`multipart`	multipart/form-data 编码（HTTP 上传）	5	85
`parser`	解析器组合子	29	352
`pdf`	0.2.0 —— 增强 PDF 写器	18	315
`phar`	Phar 归档格式（构造/解析，纯函数）	13	74
`phpser`	PHP serialize/unserialize 格式	3	124
`properties`	Java .properties 解析	15	186
`protobuf`	Protocol Buffers wire format 动态编解码	16	323
`pxml`	PXML 配置语言解析器（qg-issue 04 收编）	21	451
`richmd`	Markdown 富文本（ANSI）渲染	19	432
`rssbuilder`	RSS/Atom Feed 构造与解析	16	228
`soap`	SOAP 协议构造/解析（纯函数）	7	105
`sqlparse`	SQL SELECT 子集解析（AST）	16	335
`tar`	tar 归档（uStar 格式，普通文件）	14	218
`targz`	tar.gz 联合流（uStar 子集）	15	183
`toml`	TOML 配置解析（子集）	15	328
`uuencode`	uuencode / uudecode	9	139
`vcard`	vCard/iCalendar 文本格式解析	15	265
`xlsx`	最小 .xlsx 写器 + 读器 · 0.2.0	31	514
`xmlrpc`	XML-RPC 协议构造/解析（纯函数）	8	103
`xmlstream`	流式 XML 读写	23	235
`xpath`	XPath 简化查询（基于 domlite）	18	110
`yaml`	YAML 子集解析器 + 序列化（配置场景）	15	363
`zlib`	zlib 压缩（RFC 1950）	6	64

数据结构

包	说明	函数	行数
`advstruct`	高级数据结构（并查集 + 跳表）	11	83
`bisect`	有序序列二分查找/插入	13	129
`bitset`	位向量 / 位集合	15	170
`bloom`	布隆过滤器	9	131
`collections`	collections	7	89
`datastruct`	常用数据结构	28	192
`deepmerge`	深度递归合并（对应 PHP array_replace_recursive）	6	90
`graph`	图算法（邻接表）	23	319
`interval`	闭区间	16	145
`set`	集合	25	199
`splstruct`	SPL 数据结构（双向链表 + 定长数组）	12	58
`trie`	字典树 / 前缀匹配	11	126

文件系统

包	说明	函数	行数
`dirs`	系统/XDG 目录探测	17	103
`fileinfo`	文件信息对象（对应 PHP SplFileInfo）	11	74
`fsnotify`	文件变更监听（轮询快照）· 0.2.0	8	177
`glob`	通配匹配与目录列举	15	220
`shutil`	文件/目录操作（子集）	17	162
`tempfile`	临时文件/目录	12	91
`walk`	递归目录遍历	7	103

文本与中文处理

包	说明	函数	行数
`ansi`	ANSI 颜色/样式输出	35	207
`arrutil`	数组工具函数	17	297
`cldr`	CLDR 复数规则 + Locale 管理	8	68
`cli`	0.2.0 —— 命令行参数解析（增强版）	13	315
`cnnum`	中文数字转换	8	247
`compact`	变量↔数组互转（对应 PHP compact/extract）	6	77
`ctype`	字符类型检查	24	210
`edist`	字符串距离 / 相似度	6	178
`faker`	假数据生成（演示/测试夹具）	29	270
`gettext`	.po/.mo 翻译文件解析	12	227
`hant`	简繁中文转换（保守单字子集）	9	118
`human`	人类可读格式化	10	196
`inflect`	英文词形变化（复数化）	9	192
`multisort`	多数组联动排序（对应 PHP array_multisort）	3	92
`natsort`	自然排序	9	139
`num2words`	英文数字转单词	9	160
`numconv`	数制转换	12	197
`phonetic`	语音编码	5	312
`pinyin`	中文拼音（常用字子集）	7	135
`progress`	进度条渲染	8	113
`readstat`	文本可读性测度	10	131
`seg`	中文分词（正向最大匹配子集）	9	166
`simtext`	文本相似度	9	301
`slug`	slug / URL 友好标识	20	262
`sprintf`	C 风格格式化字符串	14	363
`strcase`	命名风格转换	31	275
`strpad`	字符串填充与重复（PHP str_pad / str_repeat / str_truncate）	8	77
`table`	ASCII/UTF-8 对齐表格渲染	11	279
`textfmt`	文本格式化工具	13	324
`textwrap`	文本排版（换行/缩进/去缩进）	17	304
`vardump`	结构化变量转储与导出（PHP var_dump / var_export / print_r�…	5	145

时间与日历

包	说明	函数	行数
`dateperiod`	日期范围迭代	18	161
`datetime`	0.2.0 —— 时间运算（增强版）	52	518
`holidays`	工作日/节假日历（中国法定节假日）	17	296
`lunar`	农历（1900-2100）公历互转（qg-issue 06 T3 收编）	12	186
`strtotime`	英文相对时间解析	17	266
`tzmini`	时区最小集（常见都市偏移 + DST 规则）	18	189

标识、校验与版本

包	说明	函数	行数
`nanoid`	NanoID（URL 友好随机 ID）	8	109
`semver`	语义化版本 2.0.0（子集）（M45）	9	279
`snowflake`	Snowflake ID	9	105
`ulid`	可排序唯一 ID（Crockford Base32）	19	220
`uuid`	通用唯一标识符（UUID v4）	14	149
`validator`	0.2.0 —— 字段校验（增强版）	24	374

网络与协议

包	说明	函数	行数
`dns`	轻量 DNS 客户端（UDP，A/AAAA/CNAME/NS/MX/TXT/PTR）	24	371
`edge`	第 4 个 stdlib，与 collections/semver/webroute 并列	22	221
`ftp`	FTP 客户端（RFC 959）	26	311
`imap`	IMAP4rev1 客户端	21	243
`ipaddr`	IP 地址与 CIDR	32	402
`ldap`	LDAP 协议构造/解析（纯函数，BER 编码）	9	103
`memcached`	Memcached 文本协议构造/解析	16	162
`mqtt`	MQTT 3.1.1 客户端	12	258
`netprobe`	TCP 端口探测 / banner 读取	11	183
`ntp`	NTP 协议客户端（纯函数：构造/解析 NTP 包）	5	115
`percent`	URL 百分号编码（RFC 3986）	12	131
`pop3`	POP3 客户端（RFC 1939）	19	245
`punycode`	Punycode / IDNA 域名编码	18	279
`smtp`	轻量 SMTP 客户端（邮件发送原语）	14	214
`snmp`	SNMP 协议构造/解析（纯函数）	8	112
`whois`	Whois 协议客户端（纯函数：构造/解析）	4	76

认证与安全

包	说明	函数	行数
`aescbc`	AES-CBC / AES-CTR	16	180
`bcrypt`	bcrypt	21	482
`captcha`	数字验证码（ASCII 渲染）	9	169
`csrf`	CSRF 令牌生成与验证	7	53
`descrypt`	DES/3DES/RC4 加密（纯函数，简化实现）	11	118
`hashutil`	哈希工具	21	282
`htmlsanitizer`	HTML 清洗 / XSS 防护	24	440
`idcard`	身份证校验（GB 11643-1999）	11	202
`jwt`	JSON Web Token（JWS HS256）	11	197
`luhn`	Luhn 校验位算法	10	175
`oauth2`	OAuth 2.0 令牌获取	18	220
`passhash`	密码哈希（PBKDF2-HMAC-SHA256）	11	126
`pwgen`	口令生成器	10	154
`secure_random`	密码学安全随机	9	115
`strength`	密码强度（zxcvbn-lite）	10	191
`totp`	HOTP / TOTP 一次性口令	15	160
`x509`	X.509 证书 DER/PEM 解析与验签	25	407