Download the PHP package devmboo/monolog without Composer

Monolog PHP Framework 🎤

Welcome to Monolog, a custom PHP framework for building modern and dynamic web applications. This framework is designed to be simple, flexible, and efficient for both small and large projects.

🛠️ Framework Overview

Monolog is a PHP framework that streamlines the development process by providing easy-to-use CLI commands, project scaffolding, and environment configurations. It helps you quickly build out essential features like controllers, models, migrations, views, and more.

It was built using PHP 8.3.x and relies on Composer for dependency management.

🗂️ Project Structure

Here's a breakdown of the directory structure in the Monolog project:

• /src: Contains the main source files for the framework.

  • /app: Core application files.
  • /config: Configuration files (e.g., stacking.php).
  • /console/commands: Holds all the custom CLI commands.
    • MakeComponent.php
    • MakeController.php
    • MakeLayout.php
    • MakeMigrate.php
    • MakeMiddleware.php
    • MakeMigration.php
    • MakeModel.php
    • MakeSeeder.php
    • MakeView.php
    • ServerCommand.php
  • /controller: Contains controller files.
    • Controller.php
  • /helpers: Helper files for different purposes.
    • /common: Common helpers like env.php.
    • /database: Helpers related to database, e.g., Migration.php.
    • /environment: Environment helpers like Env.php.
  • /http: HTTP-related files such as requests and responses.
    • Request.php
    • Response.php
    • Router.php
  • /middlewares: Middleware files for API and Web.
    • /api: API-related middlewares.
    • EnsureApplicationJWT.php
    • /web: Web-related middlewares.
    • EnsureApplicationActive.php
    • EnsureApplicationCrsfToken.php
    • EnsureAutenticateSessionUser.php
  • /resources: Resource files like views and components.
    • Component.php
    • View.php
    • /views: Views of the application.
    • public.html
  • /database: Database-related files.
    • Database.php
    • /migrations: Migration files for the database schema.
    • 2025_03_04_01_52_03_create_migrations_table.php
    • /seeders: Database seeding files.
  • /model: Contains model files.
    • Model.php
  • /router: Contains routing files.
    • web.php
  • /view: Stores view files for the application.
    • /public: Public assets like CSS, images, and JS.
    • /css
    • /ico
    • /images
    • /js
    • /resources: Stores additional resource files.
    • /views: Stores view files.
      • app.html
      • /components: Individual components like banner.html.
      • /pages: Static page views like home.html.

• /vendor: Composer dependencies and autoload files.

  • autoload.php
  • /composer: Composer-specific files.
  • autoload_classmap.php
  • autoload_namespaces.php
  • autoload_psr4.php
  • autoload_real.php
  • autoload_static.php
  • ClassLoader.php
  • installed.json
  • installed.php
  • InstalledVersions.php
  • LICENSE
  • platform_check.php

• /resources: Stores resources like layouts, static views, and the environment file (.env).

• /node_modules: Contains the installed NPM packages for front-end development, including Tailwind CSS.

📋 Features

• Custom CLI commands: Automate repetitive tasks such as creating controllers, models, migrations, views, etc.
• Simple and clean structure: Based on the MVC pattern to promote scalability and maintainability.
• Environment configuration: Using .env files to manage environment variables for different environments (e.g., development, production).
• Tailwind CSS Integration: Easily configure Tailwind for front-end styling.

⚙️ Installation & Setup

To get started with Monolog, follow these steps:

1. Install project CLI

2. Navigate to the project directory

3. Install dependencies using Composer

Ensure that you have Composer installed. If you don't have it, you can install it by following the instructions on the official website.

This will install all the required dependencies for the project.

4. Install front-end dependencies (Tailwind CSS)

Monolog uses Tailwind CSS for styling. To install the required NPM packages, run the following:

This will install Tailwind and other necessary front-end dependencies.

5. Configure the .env file

Rename the .env.example file to .env and fill in the necessary configuration details:

6. Build the front-end assets

Once NPM packages are installed, you can build the front-end assets by running:

This will compile your assets, including Tailwind CSS, and make them ready for use.

7. Start the development server

Use the following command to start the server:

This command will launch the built-in PHP server using the port defined in your .env file. By default, it uses port 8000.

8. Create layouts and other components

You can create layouts, controllers, models, migrations, and other components using the following commands:

• Create a new layout:

• Create a new controller:

• Create a new model:

• Create a new migration:

• Create a new view:

• Create a new seeder:

🚀 How to Code

1. Controllers: Store your controllers in the /src/app/controllers directory. You can generate them using the make:controller command.
2. Models: Create models in /src/app/models. Use the make:model command for automatic generation.
3. Migrations: Define your database structure using migrations. Generate them with make:migration.
4. Views: All views are stored in /resources/views. You can create views with make:view or create layouts that are used globally.
5. Layouts: Use layouts for structuring the HTML template of your application. These can be created using the make:layout command.

You can easily extend and modify any part of this framework to meet your project's needs.

🔧 Available CLI Commands

Here’s a list of the available commands:

📄 License

This project is open source and available under the MIT License.

🔑 Documentation Summary

Monolog - Basic CRUD Example

Introduction

This document provides a basic implementation of a CRUD (Create, Read, Update, Delete) system for a User model using the Model class. The User model extends Model, leveraging its built-in database methods.

Prerequisites

• PHP 8+
• PDO Extension enabled
• A properly configured database connection

User Model Implementation

Create a User model that extends Model use cli php mono.php make:model :

CRUD Operations

1. Create a User

2. Retrieve All Users

3. Find a User by ID

4. Update a User

5. Delete a User

Conclusion

This example demonstrates how to implement a basic CRUD system using the Model class. You can extend this functionality by adding additional methods and refining validations.

/**

• Monolog PHP Framework.
• Version 1.0 (2025).
• Monolog is a fresh take on project structure, inspired by Laravel and CodeIgniter 4.
• It aims to provide a clean, efficient, and developer-friendly architecture.
• @see https://github.com/devMboo/monolog The Monolog GitHub repository
• @author Luan Chaves
• @copyright 2025 Luan Chaves
• @license https://opensource.org/licenses/MIT MIT License
• @note This framework is distributed in the hope that it will be useful,
• but WITHOUT ANY WARRANTY; without even the implied warranty of
• MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. */

💬 Questions?

Feel free to open an issue or ask questions through our discussion board. Happy coding! 😊