README

Um esqueleto PHP puro, ultra-leve e focado em performance (Stateless). Construído do zero para suportar a Arquitetura Moderna do PHP: Container de Injeção de Dependências (PSR-11 feeling), Cycle de Request/Response via Middlewares (PSR-15 feeling), Service Providers e preparado para servidores assíncronos como o FrankenPHP.

Principais Features Atuais

Arquitetura Stateless: Sem vazamentos globais (Globals como $_GET e $_POST são embalados no objeto Request).
Container de Injeção de Dependências (IoC): Autowiring de classes inteligentes via Reflection API. Funções Globais como app() e logger().
Sessões e Proteção CSRF Nativa: Gerenciamento de sessão Orientado a Objetos integrado ao pipeline (Middlewares) e proteção fácil de formulários contra ataques Cross-Site Request Forgery.
Router Expressivo e Rápido: Suporte a parâmetros dinâmicos na URL, Grupos de Rotas (com prefixos e middlewares aninhados) e Namespaces limpos.
Docker & FrankenPHP Integrado: Ambiente pronto para a nuvem (Render, AWS) e desenvolvedores. Utiliza a imagem oficial do FrankenPHP baseada em Debian operando com o cobiçado Worker Mode para performance extrema na casa dos milissegundos.
Service Providers Lifecycle: Motor flexível similar ao Laravel, permitindo construção modular de recursos através de classes simples no config/app.php.
Database Avançado (ORM): Modelos trazem um QueryBuilder embutido para queries complexas fluidas, Suporte a Relacionamentos (belongsTo, hasMany), e Gatilhos de Mutação e Validação acoplados.
Upload Seguro e Storage: Abstração Orientada a Objetos robusta para manipulação e validação de UploadedFile.
Segurança e Log de Falhas: Exceções são silenciadas no arquivo storage/logs/app.log se o modo de debug estiver inativo (APP_DEBUG=false), blindando a visão do usuário final num Deploy de Produção.
Suporte Nativo ao HTMX: Métodos utilitários nativos de Request e Response (isHtmx(), hxTrigger()), além de motor PHP capaz de isolar renderização de componentes parciais (pular Layout Mestre).
API & JWT Suporte Nativa: Ferramentas para construir APIs Stateless protegidas por JSON Web Tokens. Comando setup:api para scaffold rápido.
Sistema de E-mails Robusto: Abstração de e-mails via PHPMailer com suporte a SMTP e drivers configuráveis.
Filas e Processamento Assíncrono (Queues): Adie tarefas pesadas para background com drivers de Banco de Dados ou Redis.
Cache Inteligente: Drivers de Arquivo e Redis para armazenamento temporário e alta performance.
Início Rápido com Docker: Ambiente com Redis e MariaDB pré-configurados no docker-compose.yml.
CLI (Forge): Uma ferramenta de console robusta para criar código, rodar migrações e processar filas.

Documentação

Para mergulhar fundo e aprender a separar a lógica da sua aplicação de forma profissional num MVC, construir modelos, usar o Validator baseado em PHP 8 Attributes e a CLI do Framework, consulte a documentação dedicada na pasta docs/:

=> Ler a Documentação do Motor MVC

Início Rápido (Instalação e Teste)

Método 1: Via Composer (Recomendado)

A forma mais fácil de criar a aplicação é rodar o create-project. Ele baixará a última versão, iniciará o instalador interativo e limpará os arquivos de instalação ao finalizar.

composer create-project felipe-code/mvc-base nome-do-seu-projeto

Método 2: Via Git Clone Manual

Se preferir clonar o repositório, você pode engatilhar o instalador interativo logo em seguida com os comandos abaixo:

git clone https://github.com/FelipeOropeza/mvc-estrutura.git meu-app
cd meu-app
composer install
composer run post-create-project-cmd

Método 3: Via Docker (Alta Performance com FrankenPHP)

O projeto já conta com o poderoso ambiente Docker pré-configurado. Se você possui o Docker instalado e quer máxima performance, basta levantar os containers, e ele montará automaticamente o PHP8 com o Worker Mode:

docker-compose up -d --build

Acesse http://localhost:8000 no seu navegador. O Servidor FrankenPHP gerenciará nativamente a aplicação!

Iniciando o Servidor Local Seguro (Modo Tradicional via PHP CLI):

Se não for usar o Docker, uma vez que o projeto esteja instanciado, inicie o servidor interno:

composer start

(O script start apontará para server.php garantindo que testes locais reproduzem o travamento de segurança da pasta /public com eficiência absoluta).

Acesse http://localhost:8000 no seu navegador.

Comandos Rápidos da CLI (Forge):

php forge make:controller NomeController
php forge make:model TabelaModel
php forge make:view secao/nova-view
php forge make:component nome_componente
php forge make:migration CreateUsersTable
php forge make:middleware VerificarAcessoMiddleware
php forge make:rule CpfValido
php forge make:mutator LimpaCpf
php forge migrate
php forge setup:engine twig
php forge setup:auth
php forge setup:api
php forge queue:work

Licença

MIT

felipe-code / mvc-base

Maintainers

Package info

Statistics

Security