Maxsoft MVC CMS v1.1.0

A modern, lightweight Content Management System (CMS) built with PHP and JavaScript, designed for flexibility and ease of use. This CMS follows SOLID principles and leverages an MVC architecture, utilizing PHP libraries like Laravel's Eloquent ORM, Twig templating, and a simple router, combined with a robust front-end setup using Webpack, Bootstrap, and jQuery.

Current Version: 1.1.0 (SOLID Refactoring Release)

Architecture & SOLID Principles

This CMS has been refactored to follow SOLID design principles for better maintainability and testability:

Single Responsibility Principle (SRP): Each class has one reason to change
Open/Closed Principle (OCP): Classes are open for extension, closed for modification
Liskov Substitution Principle (LSP): Subtypes are substitutable for their base types
Interface Segregation Principle (ISP): Clients depend only on methods they use
Dependency Inversion Principle (DIP): High-level modules don't depend on low-level modules

Service Layer Architecture

The application uses a service layer with dependency injection:

Services: Business logic separated into focused, testable units
Interfaces: Define contracts for services, enabling easy mocking and testing
Dependency Injection: Controllers receive their dependencies through constructors
Separation of Concerns: Views, business logic, and data access are properly separated

Features

SOLID Architecture: Clean, maintainable code following SOLID design principles.
Service Layer: Business logic separated into focused, testable services.
Dependency Injection: Loose coupling between components for better testability.
MVC Architecture: Organized structure with Core and App namespaces for clean code separation.
Database Support: Uses Laravel's Eloquent ORM (illuminate/database) for database interactions.
Templating: Powered by Twig (twig/twig) for dynamic and secure template rendering.
Routing: Simple and fast routing with pecee/simple-router.
Front-End: Built with Bootstrap 5, jQuery, and Webpack for modern, responsive UI.
Additional Tools:
- PDF generation with mpdf/mpdf.
- Image processing with spatie/image.
- JWT authentication with firebase/php-jwt.
- Environment configuration with vlucas/phpdotenv.
Development Tools: Includes GrumPHP for code quality, PHPUnit for unit testing, and Webpack for asset bundling.

Technologies Used in the Project

Backend (PHP)

Framework and Architecture

PHP 8.1+: PHP version used in the project
MVC Architecture: Model-View-Controller pattern architecture
SOLID Principles: Software design principles

Database and ORM

MySQL: Database management system
Laravel Eloquent ORM (illuminate/database ^10.0): ORM for database operations

Routing and Dependency Injection

Pecee Simple Router (pecee/simple-router ^5.4): Simple and fast router
PHP-DI (php-di/php-di ^7.0): Dependency injection container

Templating

Twig (twig/twig ^3.22): Template engine
Twig Cache Extra (twig/cache-extra ^3.22): Cache extension for Twig
Twig Extra Bundle (twig/extra-bundle ^3.22): Additional Twig features

Authorization and Security

Firebase JWT (firebase/php-jwt ^6.11): JWT tokens for authorization
Paragonie Sodium Compat (paragonie/sodium_compat ^2.1): Cryptography

File and Image Processing

Spatie Image (spatie/image ^3.8): Image processing
Intervention Image (intervention/image ^2.7): Image manipulation

Documents and PDF

mPDF (mpdf/mpdf ^8.2): PDF document generation

Configuration and Tools

PHP Dotenv (vlucas/phpdotenv ^5.6): Environment variable management

Development Tools (Backend)

PHPUnit (phpunit/phpunit ^10.0): Unit testing framework
PHPStan (phpstan/phpstan ^2.1): Static code analysis
PHP CodeSniffer (squizlabs/php_codesniffer ^4.0): Coding standards compliance analysis
GrumPHP (phpro/grumphp ^1.0): Code quality automation
PHPUnit Code Coverage (phpunit/php-code-coverage ^10.1): Code coverage for tests

Frontend (JavaScript/TypeScript)

Build Tools and Transpilation

Webpack 5 (webpack ^5.99.9): Module bundler
Babel (@babel/core ^7.28.0, @babel/preset-env ^7.28.0): JavaScript ES6+ transpilation
Babel Loader (babel-loader ^10.0.0): Webpack loader for Babel

Styles and CSS

Sass (sass ^1.89.2, sass-embedded ^1.89.2): CSS preprocessor
Sass Loader (sass-loader ^16.0.5): Webpack loader for Sass
CSS Loader (css-loader ^7.1.2): CSS processing in Webpack
Style Loader (style-loader ^4.0.0): Style injection into DOM
Mini CSS Extract Plugin (mini-css-extract-plugin ^2.9.2): CSS extraction to separate files
CSS Minimizer Webpack Plugin (css-minimizer-webpack-plugin ^7.0.2): CSS minimization

UI Frameworks and Libraries

Bootstrap 5 (bootstrap ^5.3.7): CSS framework
jQuery (jquery ^3.7.1): JavaScript library
jQuery UI (jquery-ui-dist ^1.13.3): jQuery widgets and interactions

Icons and Graphics

Bootstrap Icons (bootstrap-icons ^1.13.1): Bootstrap icon set
Font Awesome (@fortawesome/fontawesome-free ^7.0.0): Icon library
Bootstrap Iconpicker (bootstrap-iconpicker ^1.8.2): Icon selector
PluginJS Icon Picker (@pluginjs/icon-picker ^0.8.18): Alternative icon picker

Editors and Forms

CKEditor 5 (ckeditor5 ^47.0.0): Advanced WYSIWYG editor
Dropzone (dropzone ^6.0.0-beta.2): File upload with drag & drop

Tables and Data

Bootstrap Table (bootstrap-table ^1.24.1): Advanced tables
TableDnD (tablednd ^1.0.5): Drag & drop for tables
DragTable (dragtable ^2.0.12): Table column reordering
TableExport jQuery Plugin (tableexport.jquery.plugin ^1.9.9): Table export to various formats

Documents and Export

jsPDF AutoTable (jspdf-autotable ^5.0.2): PDF generation with tables

Additional UI Libraries

FancyApps UI (@fancyapps/ui ^6.0.34): UI component library
jQuery Confirm (jquery-confirm ^3.3.4): Beautiful dialog boxes
Bootstrap Menu Editor (@maxsoft/bootstrap_menu_editor ^1.0.4): Bootstrap menu editor

Webpack Plugins and Loaders

Copy Webpack Plugin (copy-webpack-plugin ^13.0.0): File copying
Expose Loader (expose-loader ^5.0.1): Exposing global variables
File Loader (file-loader ^6.2.0): File handling
Resolve URL Loader (resolve-url-loader ^5.0.0): URL resolution in CSS
Webpack CLI (webpack-cli ^6.0.1): Command-line interface for Webpack
Webpack Dev Server (webpack-dev-server ^5.2.2): Development server with hot reload

Tools and Infrastructure

Git: Version control system
Composer: PHP dependency manager
npm: Node.js package manager
Webpack Dev Server: Development server with automatic reload

Prerequisites

Before setting up the project, ensure you have the following installed:

PHP: 8.1 or higher
Composer: For PHP dependency management
Node.js: 16.x or higher
npm: For JavaScript dependency management
MySQL: For database storage
Git: For cloning the repository

Installation

Follow these steps to set up the CMS locally:

Clone the Repository:

git clone https://github.com/gmaxsoft/cms.git
cd cms

Install PHP Dependencies: Run the following command to install the required PHP packages:
```
composer install
```
Install JavaScript Dependencies: Install front-end dependencies using npm:
```
npm install
```
Set Up Environment: Copy the .env.sample file to .env and configure your environment variables:
```
cp .env.sample .env
```
Update the .env file with your database credentials and other settings. Example configuration:
```
DEBUG=true
DB_DRIVER=mysql
DB_HOST=localhost
DB_NAME=YOUR_OWN_DATABASE_NAME
DB_USER=root
DB_PASS=
FRONTEND_URL=http://localhost:3000
SECRET_KEY=your-secure-secret-key
DEFAULT_BLOCK_LANG=1
SLIDERFILESPATH=upload/sliderImg/
```
Important: Set a strong SECRET_KEY (e.g. 64-character hex) for JWT authentication.
Set Up the Database: Create a MySQL database (name matching DB_NAME in .env). Run the installer by opening in a browser: http://<twoja-domena>/install.php (np. http://localhost:8000/install.php lub adres Twojego hosta).
Build Front-End Assets: Compile and bundle the front-end assets using Webpack:
```
npm run build
```
Start the Development Server: Start the Webpack development server for front-end development:
```
npm run dev
```
Alternatively, serve the PHP application using a local server (e.g., PHP's built-in server):
```
php -S localhost:8000 -t public
```
Access the CMS: Open your browser and go to the address where the PHP application is served (e.g. http://localhost:8000 when using php -S localhost:8000 -t public, or your local domain such as http://content_management_system.test). Use http://localhost:3000 only when running npm run dev for front-end hot reload.

Usage

Admin Panel: Log in via the login page; after authentication you are redirected to the dashboard (admin panel).
Customizing Templates: Modify Twig templates in the app/Views directory.
Adding Routes: Define routes in config/routes.php using pecee/simple-router.
Asset Management: Update SCSS files in public/scss or JavaScript in public/js, then run npm run build. Compiled assets are output to public/css and public/js.

Project Structure

cms/
├── app/                    # Application logic
│   ├── Controllers/        # HTTP request handlers (uses services)
│   ├── Handlers/           # Exception handlers
│   ├── Middlewares/        # HTTP middlewares (auth, CSRF, API)
│   ├── Models/             # Eloquent ORM models
│   ├── Services/           # Business logic services
│   │   ├── Interfaces/    # Service contracts (SOLID interfaces)
│   │   ├── Twig/          # Custom Twig extensions
│   │   └── *.php          # Service implementations
│   └── Views/              # Twig templates
├── config/                 # Configuration (routes, etc.)
├── core/                   # Core CMS functionality (refactored with SOLID)
├── public/                 # Web root and compiled assets
│   ├── css/                # Compiled CSS (output from Webpack)
│   ├── js/                 # Compiled JS and source files
│   ├── scss/               # SCSS source files
│   └── index.php           # Entry point
├── tests/                  # PHPUnit tests
├── .github/workflows/      # CI (GitHub Actions)
├── vendor/                 # Composer dependencies
├── node_modules/           # npm dependencies
├── .env                    # Environment configuration (create from .env.sample)
├── composer.json           # PHP dependencies
├── package.json            # JavaScript dependencies
├── webpack.config.js       # Webpack configuration (builds into public/)
└── README.md               # Project documentation

Service Architecture Details

Core Services

SliderService: CRUD operations for sliders
SliderFileService: File management and image processing
SliderConfigService: Configuration management
ImageProcessor: Image manipulation and optimization
FileUploadService: File validation and upload handling
LanguageService: Multi-language support
TextUtilities: Text processing utilities
TemplateRenderer: Twig template rendering

Dependency Injection

Controllers receive services through constructor injection, enabling:

Easy unit testing with mocks
Loose coupling between components
Flexible service implementations
Better separation of concerns

Benefits of SOLID Refactoring

Testability: Each service can be tested in isolation
Maintainability: Changes are localized to specific services
Extensibility: New features can be added without modifying existing code
Readability: Clear separation of responsibilities
Reusability: Services can be reused across different controllers

Testing

This project includes unit tests powered by PHPUnit 10 to ensure SOLID compliance and code quality. Tests can use the database (configured in tests/bootstrap.php).

Test Structure

tests/
├── bootstrap.php              # Test environment setup (DB init, session)
├── Unit/
│   ├── Services/             # Service layer tests
│   │   ├── SliderServiceTest.php
│   │   ├── StaticBlockServiceTest.php
│   │   ├── TextUtilitiesTest.php
│   │   └── FileUploadServiceTest.php
│   └── Controllers/          # Controller tests with mocks
│       ├── AuthControllerTest.php
│       └── SliderControllerTest.php

Test Coverage

Service Layer: Business logic testing with isolated units
Controller Layer: HTTP request/response testing with mocked dependencies
Validation: Input validation and error handling
Integration: Service interaction testing

Key Testing Features

Mock Objects: PHPUnit mocks for dependency isolation
Data Providers: Parameterized tests for comprehensive coverage
Test Doubles: Stubs and mocks for external dependencies
Assertion Methods: Rich set of assertions for behavior verification

Development

Code Quality: Use GrumPHP for automated code quality checks:
```
composer run-script grumphp
```
Unit Testing: Run PHPUnit tests to ensure SOLID compliance:
```
./vendor/bin/phpunit
```

Test Coverage: Generate coverage report:

./vendor/bin/phpunit --coverage-html reports/

Run Specific Tests: Execute tests for specific components:

# Test services only
./vendor/bin/phpunit tests/Unit/Services/

# Test controllers only
./vendor/bin/phpunit tests/Unit/Controllers/

# Test single file
./vendor/bin/phpunit tests/Unit/Services/SliderServiceTest.php

Continuous Integration: GitHub Actions (.github/workflows/ci.yml):
- PHPUnit: Runs on push/PR to master, main, development with MySQL 8.0 service
- PHPStan: Static analysis
- PHP CodeSniffer: PSR-12 check for app/ and core/
- Frontend build: npm run build to verify assets compile
Front-End Development: Run npm run dev for live reloading during development.
Production Build: Generate optimized assets for production:
```
npm run build
```

Contributing

Contributions are welcome! Please follow these steps:

Fork the repository.
Create a new branch (git checkout -b feature/your-feature).
Make your changes and commit (git commit -m 'Add your feature').
Push to the branch (git push origin feature/your-feature).
Open a pull request on GitHub.

Report bugs or suggest features via the GitHub Issues page.

License

This project is licensed under the ISC License. See the LICENSE file for details.

Contact

For questions or support, contact the author:

Name: Maxsoft
Email: 133238725+gmaxsoft@users.noreply.github.com
GitHub: gmaxsoft

Name		Name	Last commit message	Last commit date
Latest commit History 27 Commits
.github/workflows		.github/workflows
app		app
config		config
core		core
dist		dist
public		public
tests		tests
.env.sample		.env.sample
.gitignore		.gitignore
.phpunit.result.cache		.phpunit.result.cache
README.md		README.md
babel.config.cjs		babel.config.cjs
composer.json		composer.json
composer.lock		composer.lock
grumphp.yml		grumphp.yml
package-lock.json		package-lock.json
package.json		package.json
phpstan.neon		phpstan.neon
phpunit.xml		phpunit.xml
publicuploadsliderImg.gitkeep		publicuploadsliderImg.gitkeep
webpack.config.js		webpack.config.js

gmaxsoft/Content_Management_System

Folders and files

Latest commit

History

Repository files navigation