PHPackages veelv/ludelix - 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. veelv/ludelix ActiveProject[Framework](/categories/framework) veelv/ludelix ============= Ludelix Application Skeleton - Modern PHP Application with SPA Integration 1.0.0(10mo ago)011MITPHPPHP >=8.1 Since Sep 1Pushed 10mo agoCompare [ Source](https://github.com/Veelv/Ludelix)[ Packagist](https://packagist.org/packages/veelv/ludelix)[ RSS](/packages/veelv-ludelix/feed)WikiDiscussions master Synced today READMEChangelog (1)Dependencies (4)Versions (2)Used By (0) Ludelix Application Skeleton ============================ [](#ludelix-application-skeleton) [![PHP Version](https://camo.githubusercontent.com/351755b1ea3b8a079461d461cd8142582eb91df14fea214307a660632576b07a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d382e312532422d626c7565)](https://www.php.net/)[![License](https://camo.githubusercontent.com/f6c4ea925a8497badef99113d2a35be000bcfe3077acc4d4beff68c5e27bab5a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f766565656c762f6c7564656c6978)](LICENSE) Ludelix is a modern PHP application skeleton with integrated Single Page Application (SPA) support, designed for rapidly building PHP web applications. Features -------- [](#features) - Modern PHP 8.1+ application architecture - PSR-4 autoloading support - Integrated SPA support for frontend development - Comprehensive routing system with controller support - Dependency injection container - Security middleware (CSRF protection, security headers) - Session management - Multi-tenancy support - WebSocket support - Database configuration (MySQL, SQLite, PostgreSQL) - Logging with Monolog - Testing with PHPUnit - Configuration management - Fluid CSS system - Encryption capabilities Requirements ------------ [](#requirements) - PHP 8.1 or higher - Composer - Web server (Apache/Nginx) Installation ------------ [](#installation) Create a new Ludelix project using Composer: ``` composer create-project veeelv/ludelix my-project ``` Or if you want to install the latest development version: ``` composer create-project veeelv/ludelix my-project dev-main ``` After installation, navigate to your project directory: ``` cd my-project ``` Configure your environment: ``` cp .env.example .env ``` Edit the `.env` file according to your environment settings. Configure your web server to point to the `public` directory. Application Overview -------------------- [](#application-overview) Ludelix is built with a modern architecture that separates concerns and follows best practices. The application structure is designed to be scalable and maintainable. ### Key Components [](#key-components) 1. **Frontend Integration**: Built-in support for SPA applications with seamless backend integration. 2. **Routing System**: Flexible routing with support for both closure-based and controller-based routes. 3. **Security**: Comprehensive security features including CSRF protection, security headers, and encryption. 4. **Database**: Support for multiple database systems with easy configuration. 5. **Multi-tenancy**: Native multi-tenancy support with domain or subdomain identification. 6. **WebSocket**: Built-in WebSocket support for real-time applications. 7. **Session Management**: Robust session handling with file-based storage. 8. **Caching**: Configurable caching system for improved performance. 9. **Logging**: Comprehensive logging with Monolog integration. Directory Structure ------------------- [](#directory-structure) ``` app/ Commands/ # Custom commands Controllers/ # Controller classes Entities/ # Data entities Jobs/ # Background jobs Middleware/ # Custom middleware Providers/ # Service providers Repositories/ # Data repositories Requests/ # Form requests Services/ # Business logic services WebSocket/ # WebSocket handlers bootstrap/ # Application bootstrap files config/ # Configuration files cubby/ # Storage for logs, cache, sessions, etc. frontend/ # Frontend assets and language files public/ # Publicly accessible files routes/ # Route definitions tests/ # Test files vendor/ # Composer dependencies ``` Configuration ------------- [](#configuration) All configuration files are located in the `config/` directory. Key configuration files include: - `app.php` - General application settings including name, environment, debug mode, timezone, locale, security keys, WebSocket and multi-tenancy settings - `database.php` - Database configuration for MySQL, SQLite, and PostgreSQL - `routes.php` - Routing configuration - `security.php` - Security settings including CSRF protection and security headers - `session.php` - Session management settings - `cache.php` - Cache configuration - `fluid.php` - Fluid CSS system configuration - `assets.php` - Asset management settings - `ludou.php` - Template engine configuration - `upload.php` - Upload settings - `bridge.php` - Bridge system configuration ### Environment Variables [](#environment-variables) The application uses environment variables for configuration. Key variables include: - `APP_NAME` - Application name - `APP_ENV` - Environment (development, production, etc.) - `APP_DEBUG` - Debug mode - `APP_URL` - Application URL - `APP_KEY` - Application encryption key - `DB_CONNECTION` - Database connection type - `DB_HOST` - Database host - `DB_PORT` - Database port - `DB_DATABASE` - Database name - `DB_USERNAME` - Database username - `DB_PASSWORD` - Database password Routing ------- [](#routing) Routes are defined in `routes/web.php`. The framework supports both closure-based routes and controller-based routes. Controllers ----------- [](#controllers) Controllers are located in `app/Controllers/` and should extend the base `Controller` class. Database -------- [](#database) The application supports multiple database systems: - MySQL - SQLite - PostgreSQL Database configuration is managed through the `config/database.php` file and environment variables. SQLite is configured by default using the `cubby/database.sqlite` file. Security -------- [](#security) The framework includes built-in security middleware that provides: - CSRF protection - Security headers (X-Content-Type-Options, X-Frame-Options, X-XSS-Protection) - Encryption capabilities Multi-tenancy ------------- [](#multi-tenancy) Ludelix has native multi-tenancy support that can be enabled/disabled through the `config/app.php` file. It supports: - Domain-based tenant identification - Subdomain-based tenant identification - Header-based tenant identification WebSocket Support ----------------- [](#websocket-support) Real-time capabilities are provided through WebSocket support that can be configured in `config/app.php`. The WebSocket server can be configured with SSL support. Session Management ------------------ [](#session-management) Session handling is configured through `config/session.php` with file-based storage by default. Sessions are stored in the `cubby/session` directory. Caching ------- [](#caching) The application includes a caching system configured through `config/cache.php`. Multiple cache drivers are supported. Fluid CSS System ---------------- [](#fluid-css-system) Ludelix includes a Fluid CSS system that can be configured through `config/fluid.php`. This system allows for custom utility classes similar to Tailwind CSS. Logging ------- [](#logging) Application logging is handled by Monolog and configured through the application settings. Logs are stored in the `cubby/logs` directory. Testing ------- [](#testing) Run tests using PHPUnit: ``` ./vendor/bin/phpunit ``` Contributing ------------ [](#contributing) Thank you for considering contributing to the Ludelix framework! The contribution guide can be found in the [Ludelix documentation](https://ludelix.com/docs/contributions). Code of Conduct --------------- [](#code-of-conduct) In order to ensure that the Ludelix community is welcoming to all, please review and abide by the [Code of Conduct](https://ludelix.com/docs/contributions#code-of-conduct). Security Vulnerabilities ------------------------ [](#security-vulnerabilities) If you discover a security vulnerability within Ludelix, please send an e-mail to the Ludelix Team via . All security vulnerabilities will be promptly addressed. License ------- [](#license) The Ludelix framework is open-sourced software licensed under the [MIT license](LICENSE). ### Health Score 29 — LowBetter than 57% of packages Maintenance54 Moderate activity, may be stable Popularity5 Limited adoption so far Community6 Small or concentrated contributor base Maturity45 Maturing project, gaining track record 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. ### Release Activity Cadence Unknown Total 1 Last Release 305d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/11723961?v=4)[Fabiano](/maintainers/Veelv)[@Veelv](https://github.com/Veelv) --- Top Contributors [![Veelv](https://avatars.githubusercontent.com/u/11723961?v=4)](https://github.com/Veelv "Veelv (2 commits)") --- Tags phpframeworkapplicationSPAludelix ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/veelv-ludelix/health.svg) ``` [![Health](https://phpackages.com/badges/veelv-ludelix/health.svg)](https://phpackages.com/packages/veelv-ludelix) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.8k543.8M20.1k](/packages/laravel-framework)[matomo/matomo Matomo is the leading Free/Libre open analytics platform 21.7k38.9k](/packages/matomo-matomo)[symfony/symfony The Symfony PHP framework 31.4k87.2M2.2k](/packages/symfony-symfony)[tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[shopware/platform The Shopware e-commerce core 3.4k1.5M3](/packages/shopware-platform)[flow-php/flow PHP ETL - Extract Transform Load - Data processing framework 85036.3k](/packages/flow-php-flow) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)