ini

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

数据版本 1.3.6稳定
lil-terminal

概览

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 删除一个点路径。

-w 会立即写入，: 后提供值，< 可从另一文件读取；-d 删除键或节。写入路径仅支持 key 或 section.key，不支持 a.b.c。重写可能丢失注释及空格；重复键按 PHP INI 解析规则处理。需要保留原文时请用 edit 或 code。Minimum 只提供整体读取，高级操作需要 Base。

交互式 sandbox 预览

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

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

安装与管理

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

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

Base 包

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

install ini
Minimum 包

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

install ini -m
精确公开版本

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

install ini -v 1.3.6
检查或升级

让 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 数据
cd \sandbox\config | app.ini
application.name   lil-sandbox
application.debug  true
paths.source       ../src
paths.public       ../public
显示精确的键或节值
ini config/app.ini application.name
lil-sandbox
在键或值中查找匹配项；* 和 ? 表示掩码
ini config/app.ini -f "paths.*" -k
paths.source  ../src
paths.public  ../public
在键或值中查找匹配项；* 和 ? 表示掩码
ini config/app.ini -f "../public" -v
paths.public  ../public
在键或值中查找匹配项；* 和 ? 表示掩码
ini config/app.ini -f "debug"
application.debug  true
直接把标量或 JSON 风格列表写入文件
ini config/app.ini -w application.debug : false
application.debug  false
写入从另一个文件读取的值
ini config/app.ini -w application.name < config/plain-value.txt
application.name  demo-site
删除键或节
ini config/app.ini -d paths.public
application.name   lil-sandbox
application.debug  true
paths.source       ../src
处理不存在的文件
ini config/app.ini -c
Valid INI
显示规范化的 INI 源文本
ini dump config/app.ini
[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"
显示精确的键或节值
ini config/app.ini missing.key
Path not found
直接把标量或 JSON 风格列表写入文件
ini config/app.ini -w a.b.c : 1
INI paths support section.key only
验证 INI 文件
ini config/invalid.ini -c
Invalid INI
显示 INI 数据
ini config/missing.ini
File not found
直接把标量或 JSON 风格列表写入文件
ini config/app.ini -w application.name
Value required after : or

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

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

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

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

相关文档

如何安装模块？ →为什么会出现“command not found”？ →

当前公开版本

v1.3.62026-11-01

生产级完善

ini 的当前稳定版本。ini 直接处理标准 INI 文件：读取分节和类型化值、搜索设置、验证语法，并以原子方式修改一个键。

# 版本历史