ini

ini trabaja con archivos INI reales: lee secciones y valores tipados, busca ajustes, valida la sintaxis y cambia una clave de forma atómica. Una ruta es key o section.key.

DatosVersión 1.3.6Estable
lil-terminal

Resumen

ini trabaja directamente con archivos INI: lee claves por rutas con puntos, busca claves o valores, cambia una opción de forma atómica, valida el resultado y muestra la fuente normalizada sin búfer de sesión.

Una sección y una clave forman dos niveles

application.name selecciona name dentro de [application]. Una ruta más profunda como a.b.c se rechaza deliberadamente; JSON, TOML o YAML son más adecuados cuando hace falta mayor anidación.

Sintaxis

lil-terminal
ini <file> [key|options] · ini dump <file>

Referencia

ini <file>

mostrar datos INI

ini <file> <key>

mostrar el valor exacto de una clave o sección

ini dump <file>

mostrar el texto INI normalizado

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

buscar coincidencias en claves o valores; * y ? activan una máscara

-w <key> : <value>

escribir un escalar o una lista estilo JSON directamente en el archivo

-w <key> < <file>

escribir un valor leído desde otro archivo

-d <key>

eliminar una clave o sección

-c

validar el archivo INI

Archivo activo

Con el core actual, un archivo abierto correctamente queda disponible de inmediato como $. Si este módulo es el controlador instalado con mayor prioridad para la extensión, basta escribir el nombre del archivo para abrirlo con este comando. Son comodidades del core; ini <file> sigue siendo la forma explícita.

Búsqueda

-f busca en rutas y valores. Añada -k para buscar solo claves o -v para buscar solo valores. Las consultas con * o ? se interpretan como máscaras.

Edición directa

-w escribe el cambio inmediatamente. Tras : se indica un valor en línea; < <file> lee el valor desde otro archivo. -d elimina una ruta con puntos.

-w escribe de inmediato con : o lee de otro archivo con <; -d borra una clave o sección. Solo se admiten rutas key y section.key, no a.b.c. Al reescribir se pueden perder comentarios y espacios; las claves repetidas siguen las reglas del analizador INI de PHP. Para conservar el texto, usa edit o code. Minimum solo permite leer; lo demás requiere Base.

Vista interactiva del sandbox

Ejecuta los ejemplos preparados directamente en la página. Los resultados están predefinidos y se muestran en el navegador; no se ejecuta ningún comando de terminal en el servidor.

Abrir el archivo y reutilizarlo con $

Instalar y administrar

Instala la versión compatible actual. Elige Base para el conjunto completo de funciones o Minimum para el paquete reducido; usa upgrade para actualizar un módulo ya instalado.

Base y Minimum son dos paquetes de la misma versión actual del módulo.

Paquete Base

Instala el paquete completo con referencia local y todos los modos publicados.

install ini
Paquete Minimum

Instalar el paquete reducido. No incluye la referencia local; help <cmd> -i abre la referencia actual del servidor.

install ini -m
Versión pública exacta

Instalar exactamente esta versión publicada.

install ini -v 1.3.6
Comprobar o actualizar

upgrade comprueba la compatibilidad y sustituye el bloque solo cuando hace falta.

upgrade ini
Eliminar módulo

Elimina el bloque de extensión sin tocar el núcleo ni otros módulos.

install ini -u

Ejemplos

Los ejemplos se pueden copiar, pero el sitio no los ejecuta. Revisa rutas, permisos y opciones destructivas.

Abrir el archivo y reutilizarlo con $
cd \sandbox\config | ini app.ini
application.name   lil-sandbox
application.debug  true
paths.source       ../src
paths.public       ../public
Mostrar datos INI
cd \sandbox\config | app.ini
application.name   lil-sandbox
application.debug  true
paths.source       ../src
paths.public       ../public
Mostrar el valor exacto de una clave o sección
ini config/app.ini application.name
lil-sandbox
Buscar coincidencias en claves o valores; * y ? activan una máscara
ini config/app.ini -f "paths.*" -k
paths.source  ../src
paths.public  ../public
Buscar coincidencias en claves o valores; * y ? activan una máscara
ini config/app.ini -f "../public" -v
paths.public  ../public
Buscar coincidencias en claves o valores; * y ? activan una máscara
ini config/app.ini -f "debug"
application.debug  true
Escribir un escalar o una lista estilo JSON directamente en el archivo
ini config/app.ini -w application.debug : false
application.debug  false
Escribir un valor leído desde otro archivo
ini config/app.ini -w application.name < config/plain-value.txt
application.name  demo-site
Eliminar una clave o sección
ini config/app.ini -d paths.public
application.name   lil-sandbox
application.debug  true
paths.source       ../src
Gestionar un archivo ausente
ini config/app.ini -c
Valid INI
Mostrar el texto INI normalizado
ini dump config/app.ini
[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"
Mostrar el valor exacto de una clave o sección
ini config/app.ini missing.key
Path not found
Escribir un escalar o una lista estilo JSON directamente en el archivo
ini config/app.ini -w a.b.c : 1
INI paths support section.key only
Validar el archivo INI
ini config/invalid.ini -c
Invalid INI
Mostrar datos INI
ini config/missing.ini
File not found
Escribir un escalar o una lista estilo JSON directamente en el archivo
ini config/app.ini -w application.name
Value required after : or

Archivo usado en este ejemplo: sandbox/config/app.ini

El ejemplo usa un archivo o directorio del espacio protegido de documentación /sandbox/.

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

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

Documentación relacionada

¿Cómo instalo un módulo? →¿Por qué aparece “command not found”? →

Versión pública actual

v1.3.62026-11-01

Refinamiento de producción

Versión estable actual de ini. ini trabaja con archivos INI reales: lee secciones y valores tipados, busca ajustes, valida la sintaxis y cambia una clave de forma atómica.

# Historial de versiones