如何写一个php框架

如何从零开始构建一个PHP框架

在PHP开发领域,框架已成为提升开发效率、规范代码结构的核心工具，无论是Laravel的优雅还是Symfony的灵活，其底层都遵循着一套清晰的架构逻辑，本文将从零开始，拆解构建一个PHP框架的核心步骤与关键设计，带你理解框架背后的“为什么”与“怎么做”。

明确框架定位：从“需求”出发

在敲下第一行代码前,先要回答：我们要做一个什么样的框架？

框架的定位决定了其技术选型与架构设计,常见的PHP框架定位包括：

全栈框架：如Laravel，提供路由、ORM、模板、中间件等完整功能，适合快速开发Web应用；
微框架：如Slim，聚焦HTTP路由与请求处理，轻量级，适合API或小型项目；
组件化框架：如Symfony，以独立组件为核心，可灵活组合，适合中大型项目或需要高度定制的场景。

本文以轻量级全栈框架为例，目标是实现一个“五脏俱全”但结构简单的框架，覆盖路由、请求处理、控制器、响应、中间件等核心功能。

搭建项目骨架：目录与入口文件

一个清晰的目录结构是框架可维护性的基础,我们采用经典的PSR-4自动加载规范，设计如下目录结构：

my-framework/  
├── app/                  # 应用目录  
│   ├── Controllers/     # 控制器  
│   ├── Models/         # 模型  
│   └── Views/          # 视图模板  
├── config/              # 配置文件  
├── src/                 # 框架核心代码  
│   ├── Core/           # 核心类（应用、容器等）  
│   ├── Database/       # 数据库相关（ORM、查询构造器）  
│   ├── Http/           # HTTP层（请求、响应、路由）  
│   └── Providers/      # 服务提供者  
├── public/             # Web入口  
│   └── index.php       # 公共入口文件  
├── vendor/             # Composer依赖  
└── composer.json       # 项目依赖管理

入口文件（public/index.php）

入口文件是框架的“大门”，负责引导请求进入应用，核心作用包括：定义常量、加载autoload、初始化应用实例并运行：

<?php  
// 定义根目录常量  
define('ROOT_PATH', dirname(__DIR__));  
// 加载Composer自动加载器  
require_once ROOT_PATH . '/vendor/autoload.php';  
// 加载环境配置（如数据库连接、调试模式等）  
$dotenv = Dotenv\Dotenv::createImmutable(ROOT_PATH);  
$dotenv->load();  
// 初始化并运行应用  
$app = new MyFramework\Core\Application();  
$app->run();

核心组件实现：从“请求”到“响应”

框架的本质是接收HTTP请求，经过一系列处理，返回HTTP响应，这个过程依赖几个核心组件：路由、请求、响应、控制器。

请求处理：封装HTTP信息

PHP原生$_SERVER、$_GET、$_POST等超全局变量分散且不直观，我们需要封装一个Request类，统一管理HTTP请求信息：

// src/Http/Request.php  
namespace MyFramework\Http;  
class Request  
{  
    public function getMethod(): string  
    {  
        return $_SERVER['REQUEST_METHOD'] ?? 'GET';  
    }  
    public function getUri(): string  
    {  
        return $_SERVER['REQUEST_URI'] ?? '/';  
    }  
    public function getParam(string $key, $default = null)  
    {  
        return $_REQUEST[$key] ?? $default;  
    }  
    public function getBody(): array  
    {  
        return json_decode(file_get_contents('php://input'), true) ?? [];  
    }  
}

响应处理：返回客户端数据

响应可以是HTML、JSON、重定向等，我们设计一个Response类，统一响应格式：

// src/Http/Response.php  
namespace MyFramework\Http;  
class Response  
{  
    private $content;  
    private $statusCode = 200;  
    private $headers = [];  
    public function __construct($content, $statusCode = 200, array $headers = [])  
    {  
        $this->content = $content;  
        $this->statusCode = $statusCode;  
        $this->headers = $headers;  
    }  
    public function send()  
    {  
        http_response_code($this->statusCode);  
        foreach ($this->headers as $name => $value) {  
            header("$name: $value");  
        }  
        echo $this->content;  
    }  
    // JSON响应快捷方法  
    public static function json($data, $statusCode = 200): self  
    {  
        return new self(json_encode($data), $statusCode, ['Content-Type' => 'application/json']);  
    }  
    // 重定向快捷方法  
    public static function redirect(string $url, $statusCode = 302): self  
    {  
        return new self('', $statusCode, ['Location' => $url]);  
    }  
}

路由系统：匹配请求与处理逻辑

路由是框架的“导航系统”，负责将URI映射到具体的处理方法（通常是控制器方法），我们设计一个简单的路由注册与匹配机制：

// src/Http/Router.php  
namespace MyFramework\Http;  
class Router  
{  
    private $routes = [];  
    private $request;  
    public function __construct(Request $request)  
    {  
        $this->request = $request;  
    }  
    // 注册路由（支持GET、POST等方法）  
    public function get(string $uri, $handler): void  
    {  
        $this->addRoute('GET', $uri, $handler);  
    }  
    public function post(string $uri, $handler): void  
    {  
        $this->addRoute('POST', $uri, $handler);  
    }  
    private function addRoute(string $method, string $uri, $handler): void  
    {  
        $this->routes[] = [  
            'method' => strtoupper($method),  
            'uri' => $uri,  
            'handler' => $handler,  
        ];  
    }  
    // 匹配路由并返回处理器  
    public function resolve()  
    {  
        $method = $this->request->getMethod();  
        $uri = $this->request->getUri();  
        foreach ($this->routes as $route) {  
            if ($route['method'] === $method && $route['uri'] === $uri) {  
                return $route['handler'];  
            }  
        }  
        throw new \Exception('Route not found', 404);  
    }  
}

控制器：业务逻辑的“组织者”

控制器负责接收路由传来的参数,调用模型处理数据，并返回响应，我们约定控制器存放在app/Controllers目录，方法名对应HTTP方法（如indexAction处理GET请求）：

// app/Controllers/HomeController.php  
namespace App\Controllers;  
use MyFramework\Http\Request;  
use MyFramework\Http\Response;  
class HomeController  
{  
    public function indexAction(Request $request): Response  
    {  
        return new Response('Hello, My Framework!');  
    }  
    public function helloAction(Request $request, string $name): Response  
    {  
        return new Response("Hello, $name!");  
    }  
}

应用启动：串联所有组件

现在需要一个“大脑”串联上述组件——Application类，它的核心职责是：

初始化容器（依赖注入的基础）；
注册路由；
解析请求、匹配路由、调用控制器、返回响应。

// src/Core/Application.php  
namespace MyFramework\Core;  
use MyFramework\Http\Request;  
use MyFramework\Http\Response;  
use MyFramework\Http\Router;  
class Application  
{  
    private $router;  
    private $request;  
    public function __construct()  
    {  
        $this->request = new Request();  
        $this->router = new Router($this->request);  
        $this->registerRoutes();  
    }  
    private function registerRoutes(): void  
    {  
        // 示例路由注册  
        $this->router->get('/', [App\Controllers\HomeController::class, 'indexAction']);  
        $this->router->get('/hello/{name}', [App\Controllers\HomeController::class, 'helloAction']);  
    }  
    public function run(): void  
    {  
        try {  
            $handler = $this->router->resolve();  
            // 假设handler是[Controller::class, 'method']格式  
            if (is_array($handler)) {  
                [$controller, $method] = $