PHP 怎么HTTP调试

wen PHP项目 2026-08-04 188

本文目录导读：

PHP 怎么HTTP调试

基础调试方法
使用调试工具
记录请求日志
使用开发中间件
命令行调试工具
专业调试技巧
完整调试示例
最佳实践建议

在 PHP 中进行 HTTP 调试，有多种方法和工具，以下是系统化的调试方案：

基础调试方法

打印请求信息

<?php
// 查看所有请求头
print_r(getallheaders());
// 查看请求方法
echo $_SERVER['REQUEST_METHOD'];
// 查看请求体
$requestBody = file_get_contents('php://input');
echo $requestBody;
// 查看GET参数
print_r($_GET);
// 查看POST参数
print_r($_POST);
?>

创建调试函数

<?php
function debugRequest() {
    $debug = [
        'method' => $_SERVER['REQUEST_METHOD'],
        'uri' => $_SERVER['REQUEST_URI'],
        'headers' => getallheaders(),
        'get' => $_GET,
        'post' => $_POST,
        'cookies' => $_COOKIE,
        'body' => file_get_contents('php://input')
    ];
    // 输出到日志文件
    file_put_contents('debug.log', 
        date('Y-m-d H:i:s') . ' ' . 
        json_encode($debug, JSON_PRETTY_PRINT) . "\n", 
        FILE_APPEND
    );
}
?>

使用调试工具

Xdebug（最强大）

// php.ini 配置
[xdebug]
xdebug.mode = debug
xdebug.start_with_request = yes
xdebug.log = /path/to/xdebug.log

使用 Chrome DevTools

// 在浏览器中查看网络请求
fetch('/api/data', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({key: 'value'})
})
.then(response => response.json())
.then(data => console.log(data));

记录请求日志

自定义日志系统

<?php
class ApiLogger {
    private $logFile;
    public function __construct($logFile = 'api_log.txt') {
        $this->logFile = $logFile;
    }
    public function log($type, $message, $extra = []) {
        $logEntry = [
            'timestamp' => date('Y-m-d H:i:s'),
            'type' => $type,
            'message' => $message,
            'uri' => $_SERVER['REQUEST_URI'] ?? 'CLI',
            'method' => $_SERVER['REQUEST_METHOD'] ?? 'CLI',
            'ip' => $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0',
            'extra' => $extra
        ];
        file_put_contents(
            $this->logFile,
            json_encode($logEntry, JSON_PRETTY_PRINT) . "\n",
            FILE_APPEND
        );
    }
}
// 使用示例
$logger = new ApiLogger();
$logger->log('REQUEST', 'API调用', ['data' => $_POST]);
$logger->log('ERROR', '参数错误', ['field' => 'email']);
?>

使用开发中间件

Slim Framework 调试中间件

<?php
// 使用 Slim 框架
use Slim\Factory\AppFactory;
use Slim\Middleware\ErrorMiddleware;
$app = AppFactory::create();
// 添加错误处理中间件
$errorMiddleware = new ErrorMiddleware(
    $app->getCallableResolver(),
    $app->getResponseFactory(),
    true, // 显示错误详情
    true, // 记录错误
    true  // 详细日志
);
$app->add($errorMiddleware);
// 自定义日志中间件
$app->add(function ($request, $handler) {
    $logger = new ApiLogger();
    $logger->log('REQUEST', 'Incoming request', [
        'uri' => $request->getUri()->__toString(),
        'method' => $request->getMethod(),
        'headers' => $request->getHeaders(),
        'body' => $request->getBody()->__toString()
    ]);
    $response = $handler->handle($request);
    $logger->log('RESPONSE', 'Outgoing response', [
        'status' => $response->getStatusCode(),
        'headers' => $response->getHeaders(),
        'body' => $response->getBody()->__toString()
    ]);
    return $response;
});
?>

命令行调试工具

PHP 内置服务器 + Curl

# 启动PHP内置服务器
php -S localhost:8000 -t public
# 在另一个终端发送请求
curl -X POST http://localhost:8000/api/data \
  -H "Content-Type: application/json" \
  -d '{"key":"value"}' \
  -v  # -v 显示详细信息
# 使用 --trace 查看完整请求
curl -X GET http://localhost:8000/api/users \
  --trace-ascii /dev/stdout

使用 Postman/Insomnia

这些工具可以方便地调试,支持：

环境变量
自动化测试
请求历史
集合管理

专业调试技巧

捕获异常并记录

<?php
set_exception_handler(function ($exception) {
    $logger = new ApiLogger();
    $logger->log('EXCEPTION', $exception->getMessage(), [
        'file' => $exception->getFile(),
        'line' => $exception->getLine(),
        'trace' => $exception->getTraceAsString()
    ]);
    // 返回 JSON 错误
    header('Content-Type: application/json');
    echo json_encode([
        'success' => false,
        'error' => $exception->getMessage()
    ]);
});
?>

性能分析

<?php
// 测量请求时间
$start = microtime(true);
// 你的业务代码
// ...
$end = microtime(true);
$executionTime = $end - $start;
$logger->log('PERFORMANCE', '请求耗时', [
    'time' => $executionTime . ' 秒',
    'memory' => memory_get_peak_usage(true) / 1024 / 1024 . ' MB'
]);
?>

完整调试示例

<?php
class HttpDebugger {
    private $logFile;
    private $requestId;
    public function __construct($logFile = 'http_debug.log') {
        $this->logFile = $logFile;
        $this->requestId = uniqid('req_', true);
    }
    public function capture() {
        // 捕获请求信息
        $request = [
            'id' => $this->requestId,
            'time' => date('Y-m-d H:i:s'),
            'method' => $_SERVER['REQUEST_METHOD'],
            'uri' => $_SERVER['REQUEST_URI'],
            'ip' => $_SERVER['REMOTE_ADDR'],
            'user_agent' => $_SERVER['HTTP_USER_AGENT'] ?? '',
            'headers' => getallheaders(),
            'get' => $_GET,
            'post' => $_POST,
            'cookies' => $_COOKIE,
            'files' => $_FILES,
            'raw_body' => file_get_contents('php://input')
        ];
        $this->writeLog('REQUEST', $request);
    }
    public function executeAndLog(callable $callback) {
        $start = microtime(true);
        try {
            $result = $callback();
            $status = 'SUCCESS';
            $data = $result;
        } catch (Exception $e) {
            $status = 'ERROR';
            $data = [
                'message' => $e->getMessage(),
                'file' => $e->getFile(),
                'line' => $e->getLine()
            ];
        }
        $response = [
            'id' => $this->requestId,
            'status' => $status,
            'execution_time' => microtime(true) - $start,
            'memory_usage' => memory_get_peak_usage(true),
            'data' => $data
        ];
        $this->writeLog('RESPONSE', $response);
        return $result;
    }
    private function writeLog($type, $data) {
        $log = [
            'timestamp' => date('Y-m-d H:i:s'),
            'type' => $type,
            'request_id' => $this->requestId,
            'data' => $data
        ];
        file_put_contents(
            $this->logFile,
            json_encode($log, JSON_PRETTY_PRINT) . "\n\n",
            FILE_APPEND
        );
    }
}
// 使用示例
$debugger = new HttpDebugger();
$debugger->capture();
// 执行业务逻辑
$debugger->executeAndLog(function() {
    // 你的业务代码
    return ['status' => 'ok'];
});
?>

最佳实践建议

开发环境：开启所有错误报告

error_reporting(E_ALL);
ini_set('display_errors', '1');

生产环境：记录到日志而不是输出

error_reporting(E_ALL);
ini_set('display_errors', '0');
ini_set('log_errors', '1');

使用环境变量区分模式

define('DEBUG_MODE', true); // 或 false

if (DEBUG_MODE) { // 调试代码 }


4. **保持日志文件大小限制**
```php
if (filesize($logFile) > 1048576) { // 1MB
    rename($logFile, $logFile . '.old');
}

这些方法可以根据实际需求组合使用,选择最适合你项目的调试方案。

本文地址： https://bmjup.com/post/38222.html