README

Forum create-project (starter 2.1 + astral-core ^2.1) : forums, sujets, posts, FAQ modérée.


UI	Nova maroon (`#9f1239`)
URL locale	http://astral-forum.local/
Roadmap	ROADMAP.md

Prérequis

PHP ^8.3
Composer
Laragon (vhost astral-forum.local → public/) recommandé

Installation

composer create-project astral-php/astral-forum:^1.0 mon-forum
cd mon-forum
cp .env.example .env
php bin/console migrate

Ouvrir http://astral-forum.local/ (ou configurer le vhost) → /register (premier compte = admin).
Puis Administration → wizard communauté (nom, accroche, description du Forum général).

Docs : docs/INSTALL.md · docs/FAQ.md.

Fonctionnalités 1.0.0

Setup identité communauté (1re visite admin)
UI Nova Maroon Light + polish formulaires / nav compte / admin forums
Forum général seedé à la migration
Lecture publique, création sujet + réponse (membres)
Recherche, compteurs réponses/vues, cache liste forums
Abonnements + e-mail sync sur réponse
FAQ modèle rédacteur (publier / complément / refus) + lecture seule une fois publiée
Remember-me · anonymisation compte
Édition / soft-delete ; throttle auth-extra
Rôles : Admin · Modérateur · User · Guest
Modération : verrouiller / épingler / masquer (admin + modérateur)
CI GitHub Actions + docs install / FAQ

Comptes démo locaux (après migrate) :

php bin/seed-demo-users.php

Rôle	E-mail	Mot de passe
Admin	`demo-admin@astral-forum.local`	`DemoForum-2026!`
Modérateur	`demo-moderator@astral-forum.local`	`DemoForum-2026!`
User	`demo-user@astral-forum.local`	`DemoForum-2026!`

Dépendances clés

astral-php/astral-core:^2.1
astral-php/astral-form:^0.1.2 (éviter la contrainte exacte 0.1 → résout 0.1.0 + hub ^1)
astral-php/astral-cache:^0.1
astral-php/astral-auth-extra:^0.2 (throttle login + écriture forum)

composer serve (127.0.0.1:8083) = secours hors Laragon.

Tests

composer test
composer qa   # serveur Laragon requis

CSRF : champ _token.

Liens

Packagist : astral-php/astral-forum
GitHub : astral-php/astral-forum

astral-php / astral-forum

Package info

Security

Statistics