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

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

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

Biblioteca para trabalhar com Token-Oriented Object Notation.

3.0.0(7mo ago)35MITPHP

Since Nov 10Pushed 1mo agoCompare

[ Source](https://github.com/bluiceoficial/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 1w ago

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

MGTOON
======

[](#mgtoon)

[![Status](https://camo.githubusercontent.com/89062279615f6a98b1ff784fe7d4b75a3c8a18b0fef4a8836c21f3fb5fb103ef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374617475732d61727175697661646f2d2d61726368697665642d7265642e737667)](https://camo.githubusercontent.com/89062279615f6a98b1ff784fe7d4b75a3c8a18b0fef4a8836c21f3fb5fb103ef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374617475732d61727175697661646f2d2d61726368697665642d7265642e737667)

> **Aviso importante:** Está biblioteca foi **oficialmente arquivada** e não receberá mais atualizações, correções de bugs ou suporte para novas versões.

**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)

```