编辑“︁PHP Slim框架”︁

{{Note|本文介绍的是PHP Slim框架的基础知识、核心功能及实际应用，适合从初学者到进阶开发者阅读。}}

= PHP Slim框架 =

'''Slim框架'''是一个轻量级的PHP微框架，专注于构建快速、简洁的Web应用和API。它提供路由、中间件、依赖注入等核心功能，适合小型项目或作为大型应用的组件。其设计哲学是“少即是多”，通过最小化封装降低学习成本，同时保持扩展性。

== 核心特性 ==
* '''路由系统'''：支持RESTful风格的路由定义。
* '''中间件'''：基于PSR-7标准，可嵌套处理HTTP请求/响应。
* '''依赖容器'''：内置DI容器管理服务依赖。
* '''低耦合'''：可与其他库（如Eloquent、Twig）无缝集成。

== 安装与配置 ==
通过Composer安装：
<syntaxhighlight lang="bash">
composer require slim/slim:"^4.0"
</syntaxhighlight>

基础启动脚本示例：
<syntaxhighlight lang="php">
<?php
use Slim\Factory\AppFactory;

require __DIR__ . '/vendor/autoload.php';

$app = AppFactory::create();

// 定义路由
$app->get('/hello/{name}', function ($request, $response, $args) {
    $name = $args['name'];
    $response->getBody()->write("Hello, $name");
    return $response;
});

$app->run();
</syntaxhighlight>

== 路由详解 ==
Slim支持多种HTTP方法的路由绑定：

{| class="wikitable"
|+ 路由方法示例
! 方法 !! 描述 !! 示例
|-
| <code>GET</code> || 获取资源 || <code>$app->get('/users', handler)</code>
|-
| <code>POST</code> || 创建资源 || <code>$app->post('/users', handler)</code>
|-
| <code>PUT</code> || 更新资源 || <code>$app->put('/users/{id}', handler)</code>
|}

=== 路由分组 ===
使用<code>group()</code>方法组织相关路由：
<syntaxhighlight lang="php">
$app->group('/api', function ($group) {
    $group->get('/users', getUsersHandler);
    $group->post('/users', createUserHandler);
});
</syntaxhighlight>

== 中间件机制 ==
中间件执行顺序遵循“洋葱模型”：
<mermaid>
graph LR
    A[请求] --> B[中间件1] --> C[中间件2] --> D[核心逻辑] --> C --> B --> A[响应]
</mermaid>

示例：添加JSON响应中间件
<syntaxhighlight lang="php">
$app->add(function ($request, $handler) {
    $response = $handler->handle($request);
    return $response->withHeader('Content-Type', 'application/json');
});
</syntaxhighlight>

== 依赖注入 ==
通过容器管理服务：
<syntaxhighlight lang="php">
$container = $app->getContainer();
$container['db'] = function () {
    return new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
};

// 在路由中使用
$app->get('/data', function ($request, $response) {
    $data = $this->get('db')->query('SELECT * FROM table');
    return $response->withJson($data);
});
</syntaxhighlight>

== 实战案例：构建API端点 ==
以下实现用户数据API：
<syntaxhighlight lang="php">
$app->group('/api/v1', function ($group) {
    // 获取所有用户
    $group->get('/users', function ($request, $response) {
        $users = $this->get('db')->query('SELECT * FROM users')->fetchAll();
        return $response->withJson($users);
    });

    // 创建用户
    $group->post('/users', function ($request, $response) {
        $data = $request->getParsedBody();
        $stmt = $this->get('db')->prepare('INSERT INTO users (name) VALUES (?)');
        $stmt->execute([$data['name']]);
        return $response->withStatus(201);
    });
});
</syntaxhighlight>

== 性能优化建议 ==
* 启用路由缓存：<code>$app->getRouteCollector()->setCacheFile()</code>
* 使用OPcache加速PHP
* 按需加载中间件

== 常见问题 ==
=== 如何处理404响应？ ===
自定义NotFound处理：
<syntaxhighlight lang="php">
$app->add(function ($request, $handler) {
    try {
        return $handler->handle($request);
    } catch (Slim\Exception\HttpNotFoundException $e) {
        $response = new \Slim\Psr7\Response();
        return $response->withStatus(404)->write('Custom 404 Page');
    }
});
</syntaxhighlight>

=== 如何扩展请求对象？ ===
通过中间件添加属性：
<syntaxhighlight lang="php">
$app->add(function ($request, $handler) {
    $request = $request->withAttribute('timestamp', time());
    return $handler->handle($request);
});
</syntaxhighlight>

{{Warning|生产环境务必关闭错误详情显示：<code>$app->addErrorMiddleware(false, false, false);</code>}}

== 进阶主题 ==
* 单元测试：使用PHPUnit模拟PSR-7请求
* 性能分析：集成XHProf
* 微服务架构：与RabbitMQ结合

== 参见 ==
* [[PSR-7标准]]
* [[RESTful API设计]]
* [[PHP中间件模式]]

[[Category:编程语言]]
[[Category:PHP]]
[[Category:PHP框架]]