如何写一个php框架

如何从零开始构建一个PHP框架：理论与实践指南

在PHP开发领域，框架是提升开发效率、保证代码规范的核心工具，无论是Laravel的优雅还是Symfony的 robust，其底层都遵循着相似的设计逻辑，本文将带你从零开始，一步步拆解构建PHP框架的核心步骤，涵盖基础架构、路由系统、请求处理、MVC模式、中间件机制等关键模块,并结合代码示例让你理解框架设计的本质。

明确框架定位：从“为什么”到“做什么”

在敲下第一行代码前，先要明确框架的定位：解决重复性问题，提供标准化的开发流程，与现有框架（如Laravel、CodeIgniter）不同，我们的目标是构建一个轻量级、可扩展、易于理解的框架,核心功能包括：

路由系统：将URL映射到对应的处理逻辑（如控制器方法）。
请求与响应处理：统一管理HTTP请求参数、Header，规范响应格式。
MVC架构：分离业务逻辑（Model）、数据展示（View）和请求调度（Controller）。
依赖注入容器：降低模块间耦合，提升代码可测试性。
中间件机制：实现请求拦截（如身份验证、日志记录）。

搭建基础项目结构

一个清晰的目录结构是框架可维护性的基础，我们采用以下结构（类似主流框架的分层设计）：

my-php-framework/  
├── app/                    # 应用层代码  
│   ├── Controllers/        # 控制器  
│   ├── Models/            # 数据模型  
│   └── Views/             # 视图文件  
├── config/                # 配置文件（如数据库、路由）  
├── src/                   # 框架核心代码  
│   ├── Core/              # 核心类（如应用启动类、容器）  
│   ├── Routing/           # 路由组件  
│   ├── Http/              # 请求与响应处理  
│   └── Middleware/        # 中间件基类  
├── public/                # Web入口目录（仅暴露index.php）  
├── vendor/                # Composer依赖  
└── composer.json          # 项目依赖管理

初始化Composer项目

通过Composer管理依赖是现代PHP项目的标准做法，在项目根目录运行：

composer init --name="my/framework" --description="A lightweight PHP framework"

添加必要的依赖（如phpunit用于测试，monolog用于日志记录），最终composer.json类似：

{
    "name": "my/framework",
    "require": {
        "php": ">=8.0",
        "monolog/monolog": "^2.3"
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Framework\\": "src/"
        }
    }
}

运行composer install生成vendor目录，并自动加载PSR-4规范的类。

实现核心模块

应用启动类：框架的“入口门卫”

应用启动类（Bootstrap或Kernel）负责初始化框架核心组件，加载配置，并调度请求到对应的处理逻辑，我们创建src/Core/Application.php：

<?php
namespace Framework\Core;
use Framework\Http\Request;
use Framework\Routing\Router;
use Framework\Container\Container;
class Application
{
    private Container $container;
    private Router $router;
    public function __construct()
    {
        $this->container = new Container();
        $this->router = new Router($this->container);
        $this->loadConfig();
    }
    private function loadConfig(): void
    {
        // 加载配置文件（如routes.php、database.php）
        $config = require __DIR__ . '/../../config/routes.php';
        $this->router->loadRoutes($config);
    }
    public function handleRequest(Request $request): void
    {
        $response = $this->router->dispatch($request);
        $response->send();
    }
}

请求与响应处理：统一HTTP交互

请求类（Request） 封装PHP全局变量（$_GET、$_POST、$_SERVER）,提供统一的参数访问接口：

// src/Http/Request.php
namespace Framework\Http;
class Request
{
    public function get(string $key, $default = null): mixed
    {
        return $_GET[$key] ?? $default;
    }
    public function post(string $key, $default = null): mixed
    {
        return $_POST[$key] ?? $default;
    }
    public function method(): string
    {
        return $_SERVER['REQUEST_METHOD'] ?? 'GET';
    }
    public function uri(): string
    {
        return $_SERVER['REQUEST_URI'] ?? '/';
    }
    public function headers(): array
    {
        $headers = [];
        foreach ($_SERVER as $key => $value) {
            if (str_starts_with($key, 'HTTP_')) {
                $headerKey = str_replace(' ', '-', ucwords(strtolower(str_replace('_', ' ', substr($key, 5)))));
                $headers[$headerKey] = $value;
            }
        }
        return $headers;
    }
}

响应类（Response） 封装HTTP响应内容，支持设置状态码、Header和响应体：

// src/Http/Response.php
namespace Framework\Http;
class Response
{
    private int $statusCode = 200;
    private array $headers = [];
    private string $content = '';
    public function __construct(string $content = '')
    {
        $this->content = $content;
    }
    public function setStatusCode(int $code): self
    {
        $this->statusCode = $code;
        return $this;
    }
    public function setHeader(string $key, string $value): self
    {
        $this->headers[$key] = $value;
        return $this;
    }
    public function send(): void
    {
        http_response_code($this->statusCode);
        foreach ($this->headers as $key => $value) {
            header("$key: $value");
        }
        echo $this->content;
    }
}

路由系统：URL与逻辑的“桥梁”

路由的核心是将URI和HTTP方法映射到回调函数或控制器方法，我们实现一个基于“闭包+控制器”的路由器：

// src/Routing/Router.php
namespace Framework\Routing;
use Framework\Http\Request;
use Framework\Http\Response;
use Framework\Container\Container;
class Router
{
    private array $routes = [];
    private Container $container;
    public function __construct(Container $container)
    {
        $this->container = $container;
    }
    public function loadRoutes(array $routes): void
    {
        $this->routes = $routes;
    }
    public function dispatch(Request $request): Response
    {
        $method = $request->method();
        $uri = $request->uri();
        $routeKey = "$method $uri";
        if (!isset($this->routes[$routeKey])) {
            return new Response('Route not found', 404);
        }
        $handler = $this->routes[$routeKey];
        if (is_callable($handler)) {
            return $handler($request);
        }
        // 处理控制器路由（如 "HomeController@index"）
        if (is_string($handler) && str_contains($handler, '@')) {
            [$controllerClass, $method] = explode('@', $handler);
            $controller = $this->container->get($controllerClass);
            return $controller->$method($request);
        }
        return new Response('Invalid route handler', 500);
    }
}

在config/routes.php中定义路由规则：

<?php
return [
    'GET /' => 'HomeController@index',
    'GET /hello/{name}' => function (Request $request) {
        $name = $request->get('name', 'Guest');
        return new Response("Hello, $name!");
    },
    'POST /api/users' => 'UserController@store',
];

依赖注入容器：解耦的“粘合剂”

依赖注入（DI）容器负责管理对象的创建和依赖关系，避免硬编码依赖,我们实现一个简单的容器：

// src/Core/Container.php
namespace Framework\Core;
class Container
{
    private array $bindings = [];
    public function bind(string $abstract, callable $concrete): void
    {
        $this->bindings[$abstract] = $concrete;
    }
    public function get(string $abstract): object
    {
        if (!isset($this->bindings[$abstract])) {
            throw new \Exception("Binding $abstract not found");
        }
        return $this->bindings[$abstract]($this);
    }
}

使用容器解析控制器（如HomeController）：

// app/Controllers/HomeController.php
namespace App\Controllers;
use Framework\Http\Request;
use Framework\Http\Response;
class HomeController
{
    public function index