NexaPHP 简介：轻量级 MVC PHP 框架-php教程-PHP中文网

Introducing NexaPHP: A Lightweight MVC PHP Framework

构建 PHP 应用程序通常涉及大量样板代码和组织以保持干净的结构。许多开发人员使用 Laravel 或 Symfony 等框架来处理此问题，但如果您只需要一个轻量级、简单的 MVC（模型-视图-控制器）框架怎么办？ NexaPHP 可能正是您正在寻找的。这个极简主义框架是为那些想要精益结构而没有大型框架的重量的开发人员而设计的，使其成为学习或创建中小型应用程序的理想选择。

为什么选择 NexaPHP？

NexaPHP 专为重视简单性并希望对核心框架功能有更多控制的开发人员量身定制。 NexaPHP 的设计非常简单，让您可以专注于应用程序的基本方面，而无需浏览繁重的框架抽象。以下是 NexaPHP 提供的功能：

轻量级和最小化 - 核心MVC组件，没有过多的依赖。
轻松设置和配置 - 数据库和路由的直接配置。
中间件支持 - 添加自定义中间件以增强请求过滤。
事件驱动 - 使用自定义事件来自定义应用程序行为。

无论您是想要学习 MVC 原理的初学者还是经验丰富的开发人员，NexaPHP 占用空间小，都可以让您直接进入 PHP Web 开发。

NexaPHP 入门

1. 安装

通过 Composer 安装 NexaPHP，这样可以轻松集成到任何 PHP 项目中：

composer require ravikisha/nexaphp

登录后复制

2. 基本设置

要初始化 NexaPHP 应用程序，请配置应用程序根目录和数据库详细信息：

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);

登录后复制

此设置包括：

userClass：定义用户模型，对于处理用户身份验证和管理至关重要。
db：提供数据库连接参数，包括数据源名称（DSN）、用户和密码。

NexaPHP 中的关键组件

NexaPHP 提供了几个基础类来支持其核心 MVC 结构：

应用程序：管理应用程序的生命周期并协调不同的组件。
路由器：将 URL 映射到特定的控制器和操作。
Request 和 Response：处理 HTTP 请求和响应。
数据库：管理数据库连接和查询。
Session：提供会话管理功能。
View：处理 HTML 模板的渲染。

构建您的第一个控制器

控制器定义 NexaPHP 如何处理不同路由的请求。这是 SiteController 的示例：

composer require ravikisha/nexaphp

登录后复制

使用 $this->render() 渲染视图文件，而 setLayout() 可以定义自定义布局。

定义路线

路由器允许您定义与特定控制器操作相对应的 GET 和 POST 路由：

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 支持带参数的动态路由，允许您处理特定于用户的页面：

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');
    }
}

登录后复制

数据库集成

NexaPHP 使用 PDO 进行数据库交互，可以轻松与各种数据库集成。这是一个快速概述：

定义模型：使用模型与数据库表交互。

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

登录后复制

迁移：NexaPHP 可以运行迁移以保持数据库架构更新：
```
$app->router->get('/profile/{id}', [UserController::class, 'profile']);
```
登录后复制
CRUD 操作：NexaPHP 提供了 save() 和 findOne() 等方法来进行数据库操作。

中间件支持

NexaPHP 的中间件功能允许您实现请求过滤和控制。以下是创建和应用自定义中间件的示例：

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'];
    }
}

登录后复制

注册中间件：

$app->db->applyMigrations();

登录后复制

视图和模板

NexaPHP 视图提供了一种管理 HTML 模板的简单方法。默认情况下，模板存储在views文件夹中，您可以使用布局文件来保持设计的一致性。

namespace app\middlewares;

use ravikisha\nexaphp\middlewares\BaseMiddleware;

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

登录后复制

可以在视图/布局下定义布局，并且像 {{content}} 这样的占位符允许动态插入视图。

表格和字段

NexaPHP 提供了方便的表单和字段生成器，可以轻松创建动态 HTML 表单：

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

登录后复制

您可以呈现各种字段类型，例如密码、电子邮件和日期字段，以满足不同的表单要求。

会话管理

Session 类提供会话处理，允许您设置、获取和管理 Flash 消息：

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

登录后复制

这对于显示临时通知特别有用。

异常处理

NexaPHP 内置了对处理异常的支持，包括：

NotFoundException 无效路由。
ForbiddenException 用于访问控制。

用户认证

用户身份验证通过抽象 UserModel 类进行管理，该类提供了诸如 login()、logout() 和 isGuest() 等基本方法。

composer require ravikisha/nexaphp

登录后复制

NexaPHP 应用程序示例

下面是基本 NexaPHP 应用程序设置的示例：

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);

登录后复制