PHPackages                             jdanielcmedina/trindade - 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. [Framework](/categories/framework)
4. /
5. jdanielcmedina/trindade

ActiveLibrary[Framework](/categories/framework)

jdanielcmedina/trindade
=======================

A secure, minimalist PHP framework — one file, everything built-in

15PHPCI passing

Since May 23Pushed 1mo agoCompare

[ Source](https://github.com/jdanielcmedina/trindade)[ Packagist](https://packagist.org/packages/jdanielcmedina/trindade)[ RSS](/packages/jdanielcmedina-trindade/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Trindade Framework
==================

[](#trindade-framework)

**1 ficheiro. Tudo built-in.** Secure, minimalist PHP framework.

```
src/Trindade.php   ← Database + Mail + WebSocket + JWT + QR + CSRF + Events + Queue + Scheduler

```

MCP — AI-Native
---------------

[](#mcp--ai-native)

O Trindade expõe 33 ferramentas via MCP (Model Context Protocol) para Claude, Cursor, etc.

```
git clone https://github.com/jdanielcmedina/trindade.git my-project
cd my-project
composer install
```

Configura o Claude Desktop com o `mcp.json` do repo:

```
{
  "mcpServers": {
    "trindade": {
      "command": "php",
      "args": ["bin/mcp"],
      "cwd": "/caminho/para/my-project"
    }
  }
}
```

A IA pode: criar rotas, validar código, correr queries SQL, ver logs, gerir utilizadores, encriptar dados, fazer backups — tudo sem abrir o browser.

ToolDescrição`routes_create` / `routes_delete` / `routes_validate`Gerir rotas com validação`db_query` / `db_schema` / `db_tables` / `db_count`Base de dados`user_create` / `user_delete` / `user_list` / `user_verify`Gestão de users`security_hash` / `security_encrypt` / `security_totp`Segurança`supervisor`Health check (uptime, memory, DB status)`queue_push` / `queue_status` / `queue_retry`Jobs assíncronos`logs_view`Logs com filtro`files_read` / `files_write`Editar ficheiros do projeto`backup_create` / `cache_clear` / `system_info`DevOps`jwt_generate`Gerar tokens JWTQuick Start
-----------

[](#quick-start)

```
composer create-project jdanielcmedina/trindade my-project
cd my-project
composer install
php trindade serve
```

`http://localhost:8000` — API a correr.

Database (Medoo-compatible)
---------------------------

[](#database-medoo-compatible)

```
$app->db->select('users', ['username' => 'name', 'years' => 'age'], ['status' => 'active', 'LIMIT' => 10, 'ORDER' => ['id' => 'DESC']]);
$app->db->get('users', '*', ['id' => 1]);
$app->db->count('users', '*', ['role' => 'admin']);
$app->db->has('users', ['email' => 'x@x.com']);
$app->db->pages('users', 10, 1);

// JOINs
$app->db->select('users', ['[>]profiles' => ['user_id' => 'id']], '*');
$app->db->select('users', ['[>]' => Database::raw('NOW()')]
```

Múltiplas Bases de Dados
------------------------

[](#múltiplas-bases-de-dados)

```
$app = new Trindade([
    'databases' => [
        'main'   => ['type' => 'mysql', ...],
        'logs'   => ['type' => 'sqlite', 'database' => 'logs.db'],
    ],
]);
$app->db->select('users', '*');         // main
$app->db('logs')->select('events', '*'); // logs
```

Mail
----

[](#mail)

```
$app->mail->to('x@x.com')->cc('y@y.com')->subject('Hi')->html('Hello')->send();
$app->mail->to('x@x.com')->attach('file.pdf')->send();
```

Event System
------------

[](#event-system)

```
$app->listen('user.created', function ($data) use ($app) {
    $app->mail->to($data['email'])->subject('Welcome')->send();
});
$app->emit('user.created', $data);
```

Queue + Scheduler
-----------------

[](#queue--scheduler)

```
$app->queue('send-email', ['to' => 'x@x.com']);
$app->schedule('daily', fn() => $app->backup());

// Worker
php bin/worker queue      # processa jobs
php bin/worker schedule   # corre scheduler
php bin/worker all        # ambos em loop
```

CLI
---

[](#cli)

ComandoDescrição`php trindade serve`Dev server`php bin/mcp`MCP server`php bin/worker queue`Processa jobs`php bin/ws start`WebSocket server`php trindade key:generate`APP\_KEY`php trindade make:password`Hash password`php trindade env:check`Extensões PHPSegurança (built-in)
--------------------

[](#segurança-built-in)

Headers automáticos, CSRF, rate limiting, bcrypt cost 12, random\_int(), upload seguro, path traversal bloqueado, debug=false por defeito.

Licença
-------

[](#licença)

MIT

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance60

Regular maintenance activity

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2671844?v=4)[Daniel Medina](/maintainers/jdanielcmedina)[@jdanielcmedina](https://github.com/jdanielcmedina)

---

Top Contributors

[![jdanielcmedina](https://avatars.githubusercontent.com/u/2671844?v=4)](https://github.com/jdanielcmedina "jdanielcmedina (1 commits)")

### Embed Badge

![Health badge](/badges/jdanielcmedina-trindade/health.svg)

```
[![Health](https://phpackages.com/badges/jdanielcmedina-trindade/health.svg)](https://phpackages.com/packages/jdanielcmedina-trindade)
```

###  Alternatives

[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k39.6M299](/packages/laravel-dusk)[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)