vortexphp/forum

Community forum application built with VortexPHP framework

v0.7.0 2026-04-03 23:26 UTC

Requires

• php: ^8.2
• league/commonmark: ^2.8
• vortexphp/framework: ^0.7

Suggests

• ext-openssl: SMTP STARTTLS / ssl:// (MAIL_ENCRYPTION tls or ssl)

MIT

README

A modern community forum application built with PHP 8.2 and VortexPHP. It includes discussions, moderation tools, private messaging, notifications, and responsive UI workflows for day-to-day community management.

Performance

Typical forum page render benchmark: 2.99 ms.

VortexPHP is optimized for very low-latency page delivery.

Features

• User accounts: registration, login, logout, profile pages, and account settings.
• Structured forum: categories, thread creation, threaded replies, pagination, and tags.
• Rich post flow: markdown rendering, inline post editing, and post likes.
• Thread management: bookmark/unbookmark threads and a dedicated bookmarks page.
• Moderation controls: lock, pin/sticky, and delete thread/post actions for moderators.
• Safety and abuse prevention: CSRF protection, auth middleware, role guards, and request throttling.
• Community tools: report/flag thread and post endpoints.
• Notifications: in-app notifications list with read-state handling.
• Private messages: inbox, conversation view, async feed endpoint, and async send endpoint.
• Search helpers: suggestion endpoint for faster content discovery.
• Localization: multi-language support (en, bg) via translation files.

Tech Stack

• Backend: PHP 8.2, VortexPHP framework
• Frontend: Twig templates, Tailwind CSS 4
• Content parsing: league/commonmark
• Database: SQLite by default (configurable via .env)

Quick Start

1) Install dependencies

composer install
npm install

2) Configure environment

cp .env.example .env

Set values in .env (minimum required):

• APP_KEY (generate a secure random key)
• APP_URL
• DB_DRIVER / DB_DATABASE (or MySQL/PostgreSQL variables if used)

3) Run migrations

composer run migrate

4) Build assets

npm run build

For local CSS watch mode:

npm run dev

5) Start the application

composer run serve

Available Composer Scripts

• composer run serve - start local development server
• composer run migrate - apply database migrations
• composer run migrate:down - rollback last migration batch
• composer run test - run test suite
• composer run doctor - run environment diagnostics
• composer run smoke - run smoke checks

Screenshots