PHPackages                             mugomes/mgtoon - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mugomes/mgtoon

ActiveLibrary[Utility & Helpers](/categories/utility)

mugomes/mgtoon
==============

Biblioteca para trabalhar com Token-Oriented Object Notation.

3.0.0(4mo ago)35MITPHP

Since Nov 10Pushed 4mo agoCompare

[ Source](https://github.com/mugomes/mgtoon)[ Packagist](https://packagist.org/packages/mugomes/mgtoon)[ Fund](https://apoia.se/profmu)[ Fund](https://mugomes.github.io/apoie.html)[ RSS](/packages/mugomes-mgtoon/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)DependenciesVersions (4)Used By (0)

MGTOON
======

[](#mgtoon)

**MGTOON** é uma biblioteca **leve e minimalista escrita em PHP** para trabalhar com arquivos no formato **TOON** (*Text-Oriented Object Notation*), um formato textual simples e humano para armazenamento estruturado de dados tabulares.

Ela foi projetada para oferecer **CRUD completo**, **validação**, **serialização determinística** e **zero dependências**, sendo ideal para **CLIs**, **ferramentas internas**, **projetos embarcados**, **configurações** e **pequenos bancos de dados em texto puro**.

---

✨ Características
-----------------

[](#-características)

- Formato de dados simples, legível e versionável
- CRUD completo (`create`, `read`, `update`, `delete`)
- Definição explícita de **chave primária**
- Validação estrutural e semântica do TOON
- Serialização consistente (`toString`)
- Suporte a carregamento e salvamento em arquivos
- Zero dependências externas
- Compatível com **PHP 8.4 ou superior**
- Ideal para substituir CSV, INI ou JSON simples

---

📄 Formato TOON
--------------

[](#-formato-toon)

Exemplo de um arquivo TOON:

```
user[id|name|email]
1|Pedro|pedro@email.com
2|Ana|ana@email.com

```

### Estrutura

[](#estrutura)

```
tipo[campo1|campo2|campo3]
valor1|valor2|valor3
valor1|valor2|valor3

```

- A **primeira linha** define o tipo e os campos
- As linhas seguintes são os registros
- Um campo é definido como **chave primária**

---

📦 Instalação
------------

[](#-instalação)

### Via Composer (recomendado)

[](#via-composer-recomendado)

```
composer require mugomes/mgtoon
```

### Manual

[](#manual)

Copie o arquivo `MGTOON.php` para o seu projeto e faça a inclusão manual.

---

🚀 Uso básico
------------

[](#-uso-básico)

### Criar uma estrutura TOON

[](#criar-uma-estrutura-toon)

```