Introducing NexaPHP: A Lightweight MVC PHP Framework

Building PHP applications often involves a lot of boilerplate code and organization to maintain a clean structure. Many developers reach for frameworks like Laravel or Symfony to handle this, but what if you just need a light, straightforward MVC (Model-View-Controller) framework? NexaPHP might be exactly what you're looking for. This minimalist framework is designed for developers who want a lean structure without all the weight of larger frameworks, making it an ideal choice for learning or creating small to medium-sized applications.

---

Why NexaPHP?

NexaPHP is tailored for developers who value simplicity and want more control over the core framework functionality. The design of NexaPHP is straightforward and lets you focus on essential aspects of your application without navigating through heavy framework abstractions. Here’s what NexaPHP offers:

• Lightweight and minimal - Core MVC components without excessive dependencies.
• Easy setup and configuration - Straightforward configuration for database and routing.
• Middleware support - Add custom middleware for enhanced request filtering.
• Event-driven - Use custom events to customize application behavior.

Whether you're a beginner or an experienced developer wanting to learn MVC principles, NexaPHP’s small footprint allows you to dive directly into PHP web development.

---

Getting Started with NexaPHP

1. Installation

Install NexaPHP via Composer, which makes it easy to integrate into any PHP project:

composer require ravikisha/nexaphp

2. Basic Setup

To initialize a NexaPHP application, configure your application root directory and database details:

use ravikisha\nexaphp\Application;

$config = [
    'userClass' => \app\models\User::class,
    'db' => [
        'dsn' => 'mysql:host=localhost;dbname=testdb',
        'user' => 'root',
        'password' => 'password'
    ]
];

$app = new Application(__DIR__, $config);

This setup includes:

• userClass: Defines the User model, critical for handling user authentication and management.
• db: Provides database connection parameters, including Data Source Name (DSN), user, and password.

---

Key Components in NexaPHP

NexaPHP provides several foundational classes that power its core MVC structure:

1. Application: Manages the lifecycle of your app and orchestrates different components.
2. Router: Maps URLs to specific controllers and actions.
3. Request and Response: Handle HTTP requests and responses.
4. Database: Manages database connections and queries.
5. Session: Offers session management functions.
6. View: Handles the rendering of HTML templates.

---

Building Your First Controller

Controllers define how NexaPHP handles requests for different routes. Here’s an example of a SiteController:

composer require ravikisha/nexaphp

Using $this->render() renders a view file, while setLayout() can define custom layouts.

---

Defining Routes

The Router allows you to define GET and POST routes that correspond to specific controller actions:

use ravikisha\nexaphp\Application;

$config = [
    'userClass' => \app\models\User::class,
    'db' => [
        'dsn' => 'mysql:host=localhost;dbname=testdb',
        'user' => 'root',
        'password' => 'password'
    ]
];

$app = new Application(__DIR__, $config);

NexaPHP supports dynamic routes with parameters, allowing you to handle user-specific pages:

namespace app\controllers;

use ravikisha\nexaphp\Controller;

class SiteController extends Controller
{
    public function home()
    {
        return $this->render('home');
    }

    public function contact()
    {
        return $this->render('contact');
    }
}

---

Database Integration

NexaPHP uses PDO for database interactions, making it easy to integrate with various databases. Here’s a quick overview:

1. Defining a Model: Use models to interact with database tables.
   

   $app->router->get('/', [SiteController::class, 'home']);
   $app->router->post('/contact', [SiteController::class, 'contact']);
   

2. Migrations: NexaPHP can run migrations to keep the database schema updated:
   

   $app->router->get('/profile/{id}', [UserController::class, 'profile']);
   

3. CRUD Operations: NexaPHP provides methods like save() and findOne() for database operations.

---

Middleware Support

NexaPHP’s middleware feature allows you to implement request filtering and control. Here’s an example of creating and applying custom middleware:

namespace app\models;

use ravikisha\nexaphp\db\DBModel;

class User extends DBModel
{
    public string $id;
    public string $name;

    public static function tableName(): string
    {
        return 'users';
    }

    public function attributes(): array
    {
        return ['id', 'name'];
    }
}

To register middleware:

$app->db->applyMigrations();

---

Views and Templating

NexaPHP views offer a simple way to manage HTML templates. By default, templates are stored in the views folder, and you can use layout files to maintain a consistent design.

namespace app\middlewares;

use ravikisha\nexaphp\middlewares\BaseMiddleware;

class AuthMiddleware extends BaseMiddleware
{
    public function execute()
    {
        // Authentication logic
    }
}

Layouts can be defined under views/layouts, and placeholders like {{content}} allow views to be inserted dynamically.

---

Forms and Fields

NexaPHP offers a convenient form and field builder, making it easy to create dynamic HTML forms:

$this->registerMiddleware(new AuthMiddleware(['profile', 'settings']));

You can render various field types such as password, email, and date fields for different form requirements.

---

Session Management

The Session class provides session handling, allowing you to set, get, and manage flash messages:

return $this->render('profile', ['name' => 'John Doe']);

This is particularly useful for displaying temporary notifications.

---

Exception Handling

NexaPHP has built-in support for handling exceptions, including:

• NotFoundException for invalid routes.
• ForbiddenException for access control.

---

User Authentication

User authentication is managed through the abstract UserModel class, which provides foundational methods like login(), logout(), and isGuest().

composer require ravikisha/nexaphp

---

Sample NexaPHP Application

Below is an example of a basic NexaPHP application setup:

use ravikisha\nexaphp\Application;

$config = [
    'userClass' => \app\models\User::class,
    'db' => [
        'dsn' => 'mysql:host=localhost;dbname=testdb',
        'user' => 'root',
        'password' => 'password'
    ]
];

$app = new Application(__DIR__, $config);

---

Conclusion

NexaPHP provides a clean and concise way to build MVC applications with PHP. While it’s intended for learning and small projects, it’s a great choice for those who want to understand how an MVC framework works under the hood. Explore the framework on GitHub or install it via Composer to get started.

GitHub: NexaPHP GitHub

Composer: NexaPHP on Packagist

The above is the detailed content of Introducing NexaPHP: A Lightweight MVC PHP Framework. For more information, please follow other related articles on the PHP Chinese website!