comphp/web

为基于Web的应用程序提供基本功能

v0.1 2024-02-18 02:44 UTC

This package is auto-updated.

Last update: 2024-09-18 04:13:25 UTC


README

CommonPHP Web库提供了一套组件,旨在通过提供一套标准化的、易于使用的实用工具来简化Web应用程序的开发,包括处理HTTP请求和响应的强大异常处理。受PHP的灵活性和现代Web开发中需要更简单、解耦的组件的启发,这个库旨在为PHP开发者提供一个可靠的工具包,以增强他们的Web项目。

特性

  • HTTP请求处理:简化了管理HTTP请求的过程,包括方法、方案、头和Cookies。
  • HTTP响应管理:提供了一种结构化的方式来创建和管理HTTP响应,包括状态码、头和正文内容。
  • 异常处理:提供专门的异常来处理常见的Web开发问题,提高应用程序的可调试性和可靠性。
  • 支持类:包括枚举请求方法、方案和响应状态,使代码更具可读性和可维护性。

安装

您可以使用Composer安装CommonPHP Web库

composer require comphp/web

your/package-name 替换为Packagist上CommonPHP Web库的实际包名。

使用

处理请求

要处理HTTP请求,您可以轻松实例化一个Request对象

use CommonPHP\Web\Request;

$request = Request::fromRequest();

这将自动将Request对象填充为当前HTTP请求的详细信息,包括方法、方案、头和任何参数。

创建响应

要创建HTTP响应,您可以使用Response

use CommonPHP\Web\Response;
use CommonPHP\Web\Support\ResponseStatus;

$response = new Response(
    body: 'Hello, world!',
    status: ResponseStatus::SUCCESS_OK,
    headers: ['Content-Type' => 'text/plain']
);

$response->send();

这将发送具有指定正文、状态码和头的响应。

异常处理

该库包括几个异常,旨在处理Web开发中的常见错误

  • UndefinedRequestMethodException
  • UndefinedRequestSchemeException
  • UndefinedResponseStatusCodeException

这些可以用来更有效地捕获和响应应用程序中的错误。

贡献

我们欢迎社区的贡献,无论是通过提交错误报告、提出增强建议还是创建pull请求。请参阅我们的CONTRIBUTING.md文件,了解更多有关如何为CommonPHP Web库做出贡献的详细信息。

许可证

这个库是在MIT许可证下许可的。