`ini`

ini 直接处理标准 INI 文件：读取分节和类型化值、搜索设置、验证语法，并以原子方式修改一个键。路径只能是 key 或 section.key。

数据版本 1.3.5稳定

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.iniapplication.name lil-sandbox application.debug true paths.source ../src paths.public ../publicini $ -cValid INIini $ -f "path*" -kpaths.public ../public paths.source ../src

概览

ini 直接操作 INI 文件：按点路径读取键，搜索键或值，原子修改单项设置，验证结果，并在不使用会话缓冲区的情况下查看规范化源文本。

分节与键构成两层路径

application.name 表示 [application] 中的 name。像 a.b.c 这样的更深路径会被有意拒绝；需要更深层级时，JSON、TOML 或 YAML 更合适。

语法

lil-terminal

ini <file> [key|options] · ini dump <file>

参考

ini <file>

显示 INI 数据

ini <file> <key>

显示精确的键或节值

ini dump <file>

显示规范化的 INI 源文本

-f <text|mask> [-k|-v]

在键或值中查找匹配项；* 和 ? 表示掩码

-w <key> : <value>

直接把标量或 JSON 风格列表写入文件

-w <key> < <file>

写入从另一个文件读取的值

-d <key>

删除键或节

-c

验证 INI 文件

当前文件

在当前 core 中，成功打开的文件会立即可通过 $ 再次引用。如果此模块是该扩展名已安装的最高优先级处理器，只输入文件名即可由此命令打开。这些是 core 提供的便捷机制；ini <file> 仍是明确调用形式。

搜索

-f 同时搜索路径和值。仅搜索键时加 -k，仅搜索值时加 -v。包含 * 或 ? 的查询按掩码处理。

直接编辑

-w 会立即写入文件。: 后直接给出值；< <file> 从另一个文件读取值。-d 删除一个点路径。

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示；服务器不会执行任何终端命令。

打开文件并通过 $ 继续使用

安装与管理

安装当前兼容版本。完整功能请选择 Base，精简包请选择 Minimum；已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install ini

Minimum 包

安装精简包。该包不包含本地参考；help <cmd> -i 会打开当前服务器参考。

install ini -m

精确公开版本

安装这个确切的已发布版本。

install ini -v 1.3.5

检查或升级

让 upgrade 检查兼容性，仅在需要时替换已安装块。

upgrade ini

删除模块

删除扩展块，不影响核心和其他模块。

install ini -u

示例

示例可复制，但网站不会执行。请先检查路径、权限和破坏性选项。

打开文件并通过 $ 继续使用

cd \sandbox\config | ini app.ini

application.name   lil-sandbox
application.debug  true
paths.source        ../src
paths.public        ../public

显示 INI 数据

app.ini

application.name   lil-sandbox
application.debug  true
paths.source        ../src
paths.public        ../public

显示精确的键或节值

ini $ application.name

lil-sandbox

Ini · find-key

ini $ -f "path*" -k

paths.public  ../public
paths.source  ../src

Ini · find-value

ini $ -f "../public" -v

paths.public  ../public

Ini · write

ini $ -w application.password : "Ed1g!fs:13od"

application.password  Ed1g!fs:13od

Ini · delete

ini $ -d application.password

application.name   lil-sandbox
application.debug  true

Ini · validate

ini $ -c

Valid INI

显示规范化的 INI 源文本

ini dump $ > ini-review.txt -r

[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"

处理不存在的文件

ini \sandbox\config\missing.ini

未找到文件

本示例使用的文件: `sandbox/config/app.ini`

该示例使用受保护的 /sandbox/ 文档工作区中的文件或目录。

[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"

当前公开版本

v1.3.52026-08-13

统一的结构化数据帮助

读取、搜索、写入、删除和校验统一采用同一组选项格式。

# 版本历史

ini

概览