An SUPER simple PHP Framework. > 专为“懒人”设计的轻量级 MVC 解决方案，拒绝反复复制粘贴。

—（本文档由AI优化过）

📖 简介

EZ2PHP 正如其名（Easy to PHP），是为了在处理中小型项目时，既能享受 MVC 模式的清晰结构，又不愿被庞大框架的复杂度困扰而诞生的。

✨ 项目特性

• 极致轻量：仅包含目录结构、视图渲染和数据库控制，核心极简。
• 高扩展性：采用原生 PHP 逻辑，方便根据需求进行二次开发。
• 极简部署：只需简单的 Nginx 伪静态配置即可运行。
• 简洁语法：支持基础的模板变量替换与循环。

🛠️ 开始使用

1. 安装与部署

你可以通过以下两种方式获取源码：

• 方式一：使用 Git Clone 到本地。

  git clone https://github.com/ElythraDev/EZ2PHP.git

• 方式二：直接下载源码解压至 Web 目录。

2. 环境配置

在 config.php 内，你可以配置环境类型及数据库连接信息：

// 设置环境类型: 'development' (开发) 或 'production' (生产)if (!defined('ENVIRONMENT')) define('ENVIRONMENT', 'development');

3. 服务器部署 (Nginx)

为了让路由正常工作，需要将所有请求重写到 public/index.php。以下是参考配置：

server {    listen 80;    root "/your/site/root/public";    index index.php;    location / {        try_files $uri $uri/ /index.php$is_args$args;    }}

📂 了解目录结构

EZ2PHP 的结构非常直观：

💡 提示：/pages 默认缺省 404.php，你可以参照 sample.php 快速编写一个。

🚦 路由 (Routing)

在 router.php 中注册你的路由规则。目前主要支持 GET 请求。

静态路由

$router->get('/', function() {    require __DIR__ . '/pages/sample.php';});

动态参数路由

// 示例：匹配 /article/arc101.html$router->get('/article/arc{id}.html', function($params) {    $id = (int)$params['id']; // 获取路径中的参数    require __DIR__ . '/pages/articleDisplay.php';});

🎮 控制器 (Controller)

以 /pages/sample.php 为例，这是一个典型的控制器实现：

<?phprequire __DIR__ . '/../config.php';   // 数据库连接require __DIR__ . '/../lib/view.php'; // 视图渲染引擎// 业务逻辑处理并渲染模板$content = View::render(__DIR__ . '/../templates/sample.php', [    'title' => 'EZ2PHP OKKKKKKKK!',]);echo $content;?>

🎨 模板引擎 (Templates)

EZ2PHP 支持基础的变量替换和循环输出。

变量输出

在模板文件中使用 {变量名} 进行输出：

<h1>{title}</h1><p>Hello World! EZ2PHP is running.</p>

循环输出

支持与 PHP 语法高度相似的 foreach 循环：

{foreach items as item}    <div class="card">        <h3>{item.title}</h3>        <p>{item.content}</p>    </div>{/foreach}

目前还没有像Smarty那样支持模板内的运算。

🗄️ 数据库操作

推荐使用 PDO 预处理方式以保证安全性：

$sql = 'SELECT * FROM article ORDER BY id DESC LIMIT ?, ?';$stmt = $pdo->prepare($sql);$stmt->execute([$offset, $itemsPerPage]);$posts = $stmt->fetchAll(PDO::FETCH_ASSOC);

🤝 贡献与反馈

Code with love. 如果你在使用中遇到任何问题，欢迎通过 GitHub Issues 提出。

Maintained by Elythra