velt/kernel

Core kernel contracts and foundation for the Velt framework.

Maintainers

Package info

github.com/Velt-PHP/veltphp-kernel

pkg:composer/velt/kernel

Statistics

Installs: 0

Dependents: 4

Suggesters: 0

Stars: 1

Open Issues: 2

Security

Advisories: 0

Aikido package health analysis

v0.1.1 2026-06-18 01:51 UTC

Requires

  • php: ^8.2

Requires (Dev)

MIT de9586699b74cf564a46bdbcd83af5f9c98e6cfc

This package is not auto-updated.

Last update: 2026-06-18 02:52:52 UTC

README

Mission

Ce sous-module definit le coeur minimal de Velt. Il contient les contrats, les conventions, les exceptions communes, le container de services minimal et les helpers dont les autres composants auront besoin.

Il doit rester petit. Son role n'est pas de devenir un framework complet, mais de fournir un langage commun aux autres modules.

Apres audit, le kernel doit aussi cadrer les fondations invisibles du framework : cycle de vie application, service providers, events synchrones internes, environnement, exception handling et evolution du container. Ces elements ne sont pas des features avancees ; ce sont les rails qui permettront aux modules HTTP, UI, Database, CLI et Preview de s'enregistrer proprement sans couplage.

Perimetre

Inclus :

  • structure de package velt/kernel ;
  • contrats de base ;
  • container minimal avec trajectoire PSR-11 ;
  • gestion simple de configuration ;
  • loader .env minimal ;
  • modes local, testing, production ;
  • exceptions communes ;
  • bootstrap d'application ;
  • lifecycle register, boot, handle, terminate ;
  • service providers minimaux ;
  • event dispatcher synchrone minimal ;
  • exception handler centralise ;
  • helpers strictement necessaires.

Exclus :

  • routing HTTP ;
  • rendu UI ;
  • acces database ;
  • generation CLI avancee ;
  • preview mobile.

Comment tester sans les autres modules

Le kernel core doit rester testable sans autres packages Velt. Les tests du noyau doivent donc utiliser uniquement PHP, PHPUnit et des classes factices locales.

  • Pour tester le container, creer de petites classes fake dans tests/Fixtures.
  • Pour tester les providers, creer un FakeServiceProvider qui enregistre une valeur simple dans le container.
  • Pour tester les events, creer un evenement FakeBootedEvent et un listener qui ajoute une entree dans un tableau.
  • Pour tester l'exception handler, utiliser une exception generique et verifier qu'elle devient un objet d'erreur abstrait ou une structure compatible response, sans dependre de veltphp/http.
  • Pour tester .env, utiliser un dossier temporaire avec un fichier .env.testing ou .env minimal.

Le kernel est termine seulement s'il peut prouver qu'il ne depend d'aucune classe Velt\Http, Velt\Database, Velt\Cli ou Velt\Preview, et que les integrations optionnelles comme velt/ui restent autonomes, sans dependance circulaire.

Issues