README

Rammewerk Request 是一个PHP组件，旨在简化处理HTTP请求、会话、文件上传和闪存消息。此组件提供了一种结构化的方式来与请求数据交互，包括输入、Cookie、服务器变量和上传的文件，同时提供强大的会话管理和闪存消息功能。

功能

• 请求处理：轻松访问和操作请求数据，例如输入、Cookie和服务器变量。
• 会话管理：使用内置的CSRF令牌处理安全地启动、管理和销毁会话。
• 文件上传处理：通过直观的API规范化和管理上传的文件。
• 闪存消息：在请求之间设置和检索用于用户通知的闪存消息。
• 类型安全的输入方法：以类型安全的方式检索输入（例如，字符串、整数、浮点数、布尔值、数组等）。
• 域名和URI检查：确定请求路径、域名、子域名并检查HTTPS。

安装

要安装Rammewerk Request组件，您可以使用Composer

composer require rammewerk/request

使用方法

基本请求处理

use Rammewerk\Component\Request\Request;

// Initialize Request
$request = new Request();

// Retrieve a specific input value
$username = $request->input('username');

// Retrieve all inputs
$allInputs = $request->all();

会话管理

// Set a session value
$request->session->set('user_id', 42);

// Get a session value
$userId = $request->session->get('user_id');

// Regenerate CSRF Token
$request->session->regenerateCsrfToken();

文件上传处理

// Retrieve an uploaded file
$uploadedFile = $request->file('profile_picture');

if ($uploadedFile) {
    // Handle the uploaded file
    $uploadedFile->move('/path/to/folder', 'name.jpg' );
}

闪存消息

// Set a success message
$request->flash->success('Your profile has been updated!');

// Get and display flash messages
foreach ($request->flash->get() as $message) {
    echo $message->type . ': ' . $message->message;
}

域名和URI检查

// Check if the request is over HTTPS
if ($request->isHttps()) {
    echo "Secure connection";
}

// Get the request path
$path = $request->path();

// Get the root domain
$rootDomain = $request->rootDomain();

类型安全的输入检索

// Retrieve a string input
$username = $request->inputString('username');

// Retrieve an integer input
$age = $request->inputInt('age');

// Retrieve a boolean input
$isActive = $request->inputBool('is_active');

// Retrieve an array input
$data = $request->inputArray('data');

// Retrieve a date input
$date = $request->inputDateTime('date', 'Y-m-d H:i:s');

// Retrieve an email input, validates the email address. null if not valid
$email = $request->inputEmail('email');

贡献

如果您想为Rammewerk Request组件做出贡献，请随时提交拉取请求。所有贡献都受欢迎！

许可

Rammewerk Request 是开源软件，许可协议为MIT。