一个简单的PHP框架

news2025/3/14 14:07:24

原文地址:一个简单的PHP框架 更多内容请关注:智想天开

框架概述

一个基本的 PHP 框架通常包含以下几个部分:

  • 前端控制器(Front Controller):处理所有的 HTTP 请求,统一入口。

  • 路由器(Router):解析请求的 URI,并将其映射到相应的控制器和方法。

  • 控制器(Controller):处理具体的业务逻辑。

  • 视图(View):负责展示数据(本示例主要关注控制器部分)。

通过这种结构,框架能够有效地组织代码,提高可维护性和扩展性。

目录结构

假设我们的项目目录结构如下:

my_framework/
├── index.php
├── Router.php
├── Controller.php
└── controllers/
    └── HomeController.php
  • index.php:前端控制器,所有请求都通过它入口。

  • Router.php:路由器类,负责解析 URI 并调用相应的控制器方法。

  • Controller.php:控制器基类,其他控制器可以继承它。

  • controllers/:存放具体的控制器类文件。

实现步骤

1. 前端控制器(index.php)

前端控制器是框架的入口文件,负责接收所有的 HTTP 请求,并将其传递给路由器处理。

<?php
// index.php

// 启用错误报告(开发阶段使用,生产环境请关闭)
ini_set('display_errors', 1);
error_reporting(E_ALL);

// 自动加载类文件
spl_autoload_register(function ($class) {
    if (file_exists($class . '.php')) {
        require_once $class . '.php';
    } elseif (file_exists('controllers/' . $class . '.php')) {
        require_once 'controllers/' . $class . '.php';
    }
});

// 获取请求的 URI 和方法
$requestUri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$requestMethod = $_SERVER['REQUEST_METHOD'];

// 实例化路由器并添加路由
$router = new Router();

// 定义路由规则
$router->add('GET', '/', 'HomeController@index');
$router->add('GET', '/about', 'HomeController@about');
$router->add('POST', '/submit', 'HomeController@submit');

// 处理请求
$router->dispatch($requestMethod, $requestUri);
?>

说明:

  • 错误报告:在开发阶段启用错误报告,便于调试。

  • 自动加载:使用 spl_autoload_register 自动加载类文件,简化类的引入。

  • 获取请求信息:通过 $_SERVER 全局变量获取请求的 URI 和 HTTP 方法。

  • 路由定义:使用 $router->add 方法添加路由规则,格式为 HTTP_METHODURIController@method

  • 请求分发:调用 $router->dispatch 方法,根据请求信息分发到相应的控制器方法。

2. 路由器类(Router.php)

路由器类负责解析请求的 URI,并调用相应的控制器和方法。

<?php
// Router.php

class Router
{
    private $routes = [];

    /**
     * 添加路由规则
     *
     * @param string $method HTTP 方法(GET, POST, etc.)
     * @param string $uri 请求的 URI
     * @param string $action 控制器和方法,例如 'HomeController@index'
     */
    public function add($method, $uri, $action)
    {
        $this->routes[] = [
            'method'  => strtoupper($method),
            'uri'     => $uri,
            'action'  => $action
        ];
    }

    /**
     * 分发请求到相应的控制器方法
     *
     * @param string $requestMethod HTTP 方法
     * @param string $requestUri 请求的 URI
     */
    public function dispatch($requestMethod, $requestUri)
    {
        foreach ($this->routes as $route) {
            if ($route['method'] === strtoupper($requestMethod) && $route['uri'] === $requestUri) {
                $this->executeAction($route['action']);
                return;
            }
        }
        // 如果没有匹配的路由,返回 404
        $this->sendNotFound();
    }

    /**
     * 执行控制器的方法
     *
     * @param string $action 控制器和方法,例如 'HomeController@index'
     */
    private function executeAction($action)
    {
        list($controllerName, $method) = explode('@', $action);
        if (class_exists($controllerName)) {
            $controller = new $controllerName();
            if (method_exists($controller, $method)) {
                call_user_func([$controller, $method]);
                return;
            }
        }
        // 如果控制器或方法不存在,返回 404
        $this->sendNotFound();
    }

    /**
     * 发送 404 响应
     */
    private function sendNotFound()
    {
        header("HTTP/1.0 404 Not Found");
        echo "404 Not Found";
    }
}
?>

说明:

  • 添加路由:add 方法用于添加新的路由规则。

  • 分发请求:dispatch 方法遍历所有路由规则,找到匹配的规则后调用相应的控制器方法。

  • 执行动作:executeAction 方法解析控制器和方法名称,并调用相应的方法。

  • 404 处理:如果没有匹配的路由或控制器方法不存在,返回 404 响应。

3. 控制器基类(Controller.php)

控制器基类可以包含一些公共的方法或属性,供具体的控制器继承和使用。在这个简单的示例中,我们暂时不添加任何内容,但在实际项目中,您可以根据需要扩展它。

<?php
// Controller.php

class Controller
{
    // 在这里可以添加公共的方法或属性
}
?>

4. 示例控制器(HomeController.php)

这是一个示例控制器,包含几个方法来处理不同的请求。

<?php
// controllers/HomeController.php

class HomeController extends Controller
{
    /**
     * 主页方法
     */
    public function index()
    {
        echo "<h1>欢迎来到主页!</h1>";
    }

    /**
     * 关于页面方法
     */
    public function about()
    {
        echo "<h1>关于我们</h1><p>这是关于页面。</p>";
    }

    /**
     * 处理表单提交的方法
     */
    public function submit()
    {
        // 假设有一个表单提交到 /submit
        // 处理 POST 数据
        $data = $_POST;
        echo "<h1>表单已提交</h1>";
        echo "<pre>";
        print_r($data);
        echo "</pre>";
    }
}
?>

说明:

  • index 方法:处理主页请求,输出欢迎信息。

  • about 方法:处理关于页面请求,输出关于信息。

  • submit 方法:处理表单提交的 POST 请求,输出提交的数据。

添加新路由和控制器

假设添加一个新的路由 /contact,并将其映射到 HomeController 的 contact 方法,可以按照以下步骤进行:

  1. 在 Router.php 中添加路由规则

    // index.php 中的路由定义部分
    $router->add('GET', '/contact', 'HomeController@contact');
    
  2. 在 HomeController.php 中添加 contact 方法

    // controllers/HomeController.php
    
    class HomeController extends Controller
    {
        // 现有方法...
    
        /**
         * 联系我们页面方法
         */
        public function contact()
        {
            echo "<h1>联系我们</h1><p>这是联系我们页面。</p>";
        }
    }
    

现在,当用户访问 http://yourdomain.com/contact 时,HomeController 的 contact 方法将被调用,输出相应的内容。

完整代码示例

以下是所有文件的完整代码。

1. index.php

<?php
// index.php

// 启用错误报告(开发阶段使用,生产环境请关闭)
ini_set('display_errors', 1);
error_reporting(E_ALL);

// 自动加载类文件
spl_autoload_register(function ($class) {
    if (file_exists($class . '.php')) {
        require_once $class . '.php';
    } elseif (file_exists('controllers/' . $class . '.php')) {
        require_once 'controllers/' . $class . '.php';
    }
});

// 获取请求的 URI 和方法
$requestUri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$requestMethod = $_SERVER['REQUEST_METHOD'];

// 实例化路由器并添加路由
$router = new Router();

// 定义路由规则
$router->add('GET', '/', 'HomeController@index');
$router->add('GET', '/about', 'HomeController@about');
$router->add('GET', '/contact', 'HomeController@contact'); // 新增联系页面
$router->add('POST', '/submit', 'HomeController@submit');

// 处理请求
$router->dispatch($requestMethod, $requestUri);
?>

2. Router.php

<?php
// Router.php

class Router
{
    private $routes = [];

    /**
     * 添加路由规则
     *
     * @param string $method HTTP 方法(GET, POST, etc.)
     * @param string $uri 请求的 URI
     * @param string $action 控制器和方法,例如 'HomeController@index'
     */
    public function add($method, $uri, $action)
    {
        $this->routes[] = [
            'method'  => strtoupper($method),
            'uri'     => $uri,
            'action'  => $action
        ];
    }

    /**
     * 分发请求到相应的控制器方法
     *
     * @param string $requestMethod HTTP 方法
     * @param string $requestUri 请求的 URI
     */
    public function dispatch($requestMethod, $requestUri)
    {
        foreach ($this->routes as $route) {
            if ($route['method'] === strtoupper($requestMethod) && $route['uri'] === $requestUri) {
                $this->executeAction($route['action']);
                return;
            }
        }
        // 如果没有匹配的路由,返回 404
        $this->sendNotFound();
    }

    /**
     * 执行控制器的方法
     *
     * @param string $action 控制器和方法,例如 'HomeController@index'
     */
    private function executeAction($action)
    {
        list($controllerName, $method) = explode('@', $action);
        if (class_exists($controllerName)) {
            $controller = new $controllerName();
            if (method_exists($controller, $method)) {
                call_user_func([$controller, $method]);
                return;
            }
        }
        // 如果控制器或方法不存在,返回 404
        $this->sendNotFound();
    }

    /**
     * 发送 404 响应
     */
    private function sendNotFound()
    {
        header("HTTP/1.0 404 Not Found");
        echo "404 Not Found";
    }
}
?>

3. Controller.php

<?php
// Controller.php

class Controller
{
    // 在这里可以添加公共的方法或属性
}
?>

4. controllers/HomeController.php

<?php
// controllers/HomeController.php

class HomeController extends Controller
{
    /**
     * 主页方法
     */
    public function index()
    {
        echo "<h1>欢迎来到主页!</h1>";
    }

    /**
     * 关于页面方法
     */
    public function about()
    {
        echo "<h1>关于我们</h1><p>这是关于页面。</p>";
    }

    /**
     * 联系我们页面方法
     */
    public function contact()
    {
        echo "<h1>联系我们</h1><p>这是联系我们页面。</p>";
    }

    /**
     * 处理表单提交的方法
     */
    public function submit()
    {
        // 假设有一个表单提交到 /submit
        // 处理 POST 数据
        $data = $_POST;
        echo "<h1>表单已提交</h1>";
        echo "<pre>";
        print_r($data);
        echo "</pre>";
    }
}
?>

测试框架

  1. 启动本地服务器

    使用 PHP 内置服务器进行测试。在项目根目录下运行以下命令:

    php -S localhost:8000
    
  2. 访问不同的路由

    • 主页: http://localhost:8000/

    • 关于页面: http://localhost:8000/about

    • 联系我们页面: http://localhost:8000/contact

  3. 测试表单提交

    创建一个简单的 HTML 表单,提交到 /submit

    <!-- save as form.html in project root -->
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>表单提交</title>
    </head>
    <body>
        <h1>提交表单</h1>
        <form action="/submit" method="POST">
            <label for="name">姓名:</label>
            <input type="text" id="name" name="name" required><br><br>
            <label for="email">邮箱:</label>
            <input type="email" id="email" name="email" required><br><br>
            <button type="submit">提交</button>
        </form>
    </body>
    </html>
    

    然后访问 http://localhost:8000/form.html,填写表单并提交,将看到提交的数据被输出。

总结

本文介绍了如何构建一个简单的 PHP 框架,实现将 HTTP 请求映射到类的方法中。通过定义路由规则、创建路由器类和控制器类,可以轻松地管理不同的请求路径和对应的业务逻辑。

关键步骤包括:

  1. 前端控制器:作为所有请求的统一入口,负责初始化路由器并分发请求。

  2. 路由器类:负责解析请求的 URI 和方法,并调用相应的控制器方法。

  3. 控制器类:包含具体的业务逻辑,处理不同的请求。

扩展建议:

  • 动态路由:支持带参数的动态路由,例如 /user/{id}

  • 中间件:实现中间件机制,处理认证、日志记录等功能。

  • 视图模板:集成模板引擎(如 Twig)以分离视图和逻辑。

  • 错误处理:增强错误处理机制,提供更友好的错误页面。

  • 命名空间:使用命名空间组织代码,提高代码的可维护性。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2314912.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

信息安全访问控制、抗攻击技术、安全体系和评估(高软42)

系列文章目录 信息安全访问控制、抗攻击技术、安全体系和评估 文章目录 系列文章目录前言一、信息安全技术1.访问控制2.抗攻击技术 二、欺骗技术1.ARP欺骗2.DNS欺骗3.IP欺骗 三、抗攻击技术1.端口扫描2.强化TCP/IP堆栈 四、保证体系和评估1.保证体系2.安全风险管理 五、真题在…

晋升系列4:学习方法

每一个成功的人&#xff0c;都是从底层开始打怪&#xff0c;不断的总结经验&#xff0c;一步一步打上来的。在这个过程中需要坚持、总结方法论。 对一件事情长久坚持的人其实比较少&#xff0c;在坚持的人中&#xff0c;不断的总结优化的更少&#xff0c;所以最终达到高级别的…

脑电波控制设备:基于典型相关分析(CCA)的脑机接口频率精准解码方法

文章目录 前言一、CCA的用途二、频率求解思路三、输入数据结构四、判断方法五、matlab实践1.数据集获取及处理2.matlab代码3.运行及结果 六、参考文献 前言 在脑机接口(BCI)领域&#xff0c;有SSVEP方向&#xff0c;中文叫做稳态视觉诱发电位&#xff0c;当人观看闪烁的视觉刺激…

Android Spinner总结

文章目录 Android Spinner总结概述简单使用自定义布局自定义Adapter添加分割线源码下载 Android Spinner总结 概述 在 Android 中&#xff0c;Spinner 是一个下拉选择框。 简单使用 xml布局&#xff1a; <Spinnerandroid:id"id/spinner1"android:layout_width&…

element-ui layout 组件源码分享

layout 布局组件源码分享&#xff0c;主要从以下两个方面&#xff1a; 1、row 组件属性。 2、col 组件属性。 一、row 组件属性。 1.1 gutter 栅栏间隔&#xff0c;类型为 number&#xff0c;默认 0。 1.2 type 布局模式&#xff0c;可选 flex&#xff0c;现代浏览器下有效…

OBJ文件生成PCD文件(python 实现)

代码实现 将 .obj 文件转换为 .pcd&#xff08;点云数据&#xff09; 代码文件。 import open3d as o3d# 加载 .obj 文件 mesh o3d.io.read_triangle_mesh("bunny.obj")# 检查是否成功加载 if not mesh.has_vertices():print("无法加载 .obj 文件&#xff0c…

c++介绍智能指针 十二(1)

普通指针&#xff1a;指向内存区域的地址变量。使用普通指针容易出现一些程序错误。 如果一个指针所指向的内存区域是动态分配的&#xff0c;那么这个指针变量离开了所在的作用域&#xff0c;这块内存也不会自动销毁。动态内存不进行释放就会导致内存泄露。如果一个指针指向已…

Appium等待机制--强制等待、隐式等待、显式等待

书接上回&#xff0c;Appium高级操作--其他操作-CSDN博客文章浏览阅读182次&#xff0c;点赞6次&#xff0c;收藏7次。书接上回Appium高级操作--从源码角度解析--模拟复杂手势操作-CSDN博客。https://blog.csdn.net/fantasy_4/article/details/146162851主要讲解了Appium的一些…

计算机视觉cv2入门之图像的读取,显示,与保存

在计算机视觉领域&#xff0c;Python的cv2库是一个不可或缺的工具&#xff0c;它提供了丰富的图像处理功能。作为OpenCV的Python接口&#xff0c;cv2使得图像处理的实现变得简单而高效。 示例图片 目录 opencv获取方式 图像基本知识 颜色空间 RGB HSV 图像格式 BMP格式 …

【QT】事件系统入门——QEvent 基础与示例

一、事件介绍 事件是 应用程序内部或者外部产生的事情或者动作的统称 在 Qt 中使用一个对象来表示一个事件。所有的 Qt 事件均继承于抽象类 QEvent。事件是由系统或者 Qt 平台本身在不同的时刻发出的。当用户按下鼠标、敲下键盘&#xff0c;或者是窗口需要重新绘制的时候&…

5-27 临摹大师-IP-Adapter

前言&#xff1a; 前一节我们主要介绍ControlNet中如何对黑白照片进行上色 主要介绍ControlNet中的IP-Adapter。这个也是一种类似的风格借鉴&#xff0c;类似Reference的能力。 当然IP-Adapter有两点或许可以吸引我们&#xff0c;一个是国人腾讯公司制作的。另一个在速度和效…

Spring MVC面试题(一)

1.什么是Spring MVC&#xff1f; 全称为Model View Controller&#xff0c;Spring MVC是Spring的一个模块&#xff0c;基于MVC架构模式的一个框架 2.Spring MVC优点&#xff1f; 1.可用各种视图技术&#xff0c;不仅限于JSP 2.支持各种请求资源映射策略 3. Spring MVC工作原…

Unity开发的抖音小游戏接入抖音开放平台中的流量主(抖音小游戏接入广告)

前言:作者在进行小游戏审核版本的过程中,碰到了下列问题,所以对这个抖音小游戏接入广告研究了下。 还有就是作者的TTSDK版本号是6.2.6,使用的Unity版本是Unity2022.3.29f1,最好和作者的两个版本号保持一致,因为我发现TTSDK旧版的很多函数在新版中就已经无法正常使用了,必…

统一 Elastic 向量数据库与 LLM 功能,实现智能查询

作者&#xff1a;来自 Elastic Sunile Manjee 利用 LLM 功能进行查询解析&#xff0c;并使用 Elasticsearch 搜索模板&#xff0c;将复杂的用户请求转换为结构化的、基于模式的搜索&#xff0c;从而实现高精度查询结果。 想象一下&#xff0c;你在搜索“距离 Belongil Beach 25…

[操作系统] 学校课程关于“静态优先级抢占式调度“作业

今天我们来分享两道题目哈, 学校弄得题目. T1: 静态优先级, 抢占式(1为高优先级) 图解: 以下是静态优先级抢占式调度的解题过程和结果&#xff1a; 解题思路&#xff1a; 优先级规则&#xff1a; 数值越小优先级越高。新进程到达时&#xff0c;若其优先级高于当前运行进程&…

【SpringBoot】MD5加盐算法的详解

目录 一、什么是加盐算法 二、如何实现加盐算法 2.1 加盐算法代码实现 2.2 注册页面中进行密码加盐 2.3 登录页面进行加盐的解密 2.4 注册和登录 一、什么是加盐算法 加盐算法是一种用于增强密码安全性的技术。这种技术通过在密码存储过程中添加一个随机生成的盐值&…

累计完工数量达到了xxxx超过了最大可完工数量xxxx

之前解决过一次&#xff0c;没有记录下来&#xff0c;不记得发生什么事情。又浪费几个小时去分析问题。这次的经历有点痛苦&#xff0c;碰上多表关连数据的勾稽。分析是河南用户的非法操作造成的。没有领料记录入不了库&#xff0c;跨月了。财务要求删单处理。删单之后&#xf…

飞鸟与鱼不同路

看&#xff0c;好美的太阳。 正是因为有人看才会觉得美&#xff0c;若无人问津&#xff0c;美又从何而来。 嘿嘿&#xff0c;今天提出辞去综合教研室主任一职&#xff0c;不想在这个管理上废时间啦~ 把时间用来考试.........用来做自己的事情&#xff0c;花在自己的身上&…

若依RuoYi-Cloud-Plus微服务版(完整版)前后端部署

一.目标 在浏览器上成功登录进入 二.源码下载 后端源码&#xff1a;前往Gitee下载页面(https://gitee.com/dromara/RuoYi-Cloud-Plus)下载解压到工作目录。 前端源码&#xff1a; 前往Gitee下载页面(https://gitee.com/JavaLionLi/plus-ui)下载解压到工作目录。 文档地址&a…

【redis】list类型:基本命令(下)

文章目录 LLENLREMLTRIMLSET阻塞版本命令BLPOP 和 BRPOP区别使用方式 命令小结内部编码 LLEN 获取 list 的长度 语法&#xff1a; LLEN key时间复杂度&#xff1a; O ( 1 ) O(1) O(1)返回值&#xff1a; list 长度 LREM 删除 count 个 key 中的元素 语法&#xff1a; LREM…