mugomes/mitemplate

MiTemplate é um mecanismo de templates.

Maintainers

Details

github.com/mugomes/mitemplate

Homepage

Source

Issues

Installs: 4

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

pkg:composer/mugomes/mitemplate

0.2.0 2026-01-10 15:41 UTC

Requires

  • php: >=8.4

MIT 4a1e3886a294b6f438f875b063fd8bed32b6970a

This package is auto-updated.

Last update: 2026-01-10 15:46:36 UTC

README

MiTemplate é um mecanismo de templates leve e moderno escrito em PHP, focado em simplicidade, performance e controle explícito por código.

Ele permite separar HTML da lógica da aplicação sem depender de parsers complexos, ASTs, engines pesadas ou fases de compilação.

O template é interpretado de forma incremental e determinística, com controle total da renderização pelo código PHP.

MiTemplate é baseado no MGTemplate.

✨ Características

  • Interpolação simples de variáveis: {{title}}
  • Suporte a objetos e arrays: {{user.name}}
  • Modificadores encadeáveis: {{title|upper|trim}}
  • Seções reutilizáveis com repetição controlada por código
  • Seções aninhadas com resolução tardia (lazy sections)
  • Limpeza automática de seções e variáveis não utilizadas
  • Sem uso de Reflection insegura (setAccessible)
  • Compatível com PHP 8.4 ou superior
  • Ideal para APIs, sites, CLIs e projetos embarcados

📦 Instalação

Via Composer (recomendado)

composer require mugomes/mitemplate

Manual

Copie o arquivo MiTemplate.php para o seu projeto e faça a inclusão.

🚀 Uso básico

Template (template.html)

<!DOCTYPE html>
<html>
<head>
    <title>{{title}}</title>
</head>
<body>

<h1>{{title|upper}}</h1>

[[item]]
<div>
    <strong>{{user.name}}</strong><br>
    <small>{{info}}</small>
</div>
[[/item]]

</body>
</html>

Código PHP

<?php

use MiTemplate\MiTemplate;

$tpl = new MiTemplate('template.html');

$tpl->var('title', 'MiTemplate Example');

for ($i = 0; $i < 5; $i++) {
    $tpl->var('user', (object)[
        'name' => 'Usuário ' . $i,
    ]);

    $tpl->var('info', 'Informação ' . $i);
    $tpl->section('item');
}

echo $tpl->render();

🧩 Seções

Seções são definidos diretamente no HTML:

[[item]]
<p>{{user.name}}</p>
[[/item]]

E ativados no código sempre que necessário:

$tpl->section('item');

Cada chamada adiciona uma nova instância renderizada da seção.

✔ Ordem livre

É possível chamar seções filhos antes das seções pais:

for ($i = 0; $i < 3; $i++) {
    $tpl->var('itemNome', $i);
    $tpl->section('item');
}

$tpl->section('conteudo');

O MiTemplate resolve toda a hierarquia automaticamente durante o render().

🔧 Variáveis

Variável simples

{{title}}
$tpl->var('title', 'Exemplo');

Verificar se a variável existe no template

if ($tpl->varExists('title')) {
    $tpl->var('title', 'Novo título');
}

Objetos e Arrays

{{user.name}}
{{user.email}}
$tpl->var('user', (object)[
    'name'  => 'Murilo',
    'email' => 'murilo@email.com'
]);
  • Acesso case-insensitive
  • Ignora _ e diferenças de nomenclatura
  • Suporta getters (getName())

📂 Incluir outros arquivos HTML

{{menuTopo}}
$tpl->includeFile('menuTopo', 'partials/menu.html');

🔁 Modificadores

Modificadores podem ser encadeados usando |.

Modificador Descrição
upper Converte para maiúsculas
lower Converte para minúsculas
trim Remove espaços

Exemplo:

{{title|upper|trim}}

🧹 Limpeza automática

Durante o render(), o MiTemplate remove automaticamente:

  • Seções não utilizadas:

    [[section]] ... [[/section]]

  • Tags órfãs:

    [[/section]]

  • Variáveis não resolvidas:

    {{variavel}}

Isso garante HTML limpo e válido, mesmo quando as seções não são ativadas.

👤 Autor

Murilo Gomes Julio

🔗 https://mugomes.github.io 📺 https://youtube.com/@mugomesoficial

🤝 Support

📜 License

Copyright (c) 2025-2026 Murilo Gomes Julio

Licensed under the MIT.

All contributions to the MiTemplate are subject to this license.