README

风音框架

面向 PHP 8.2 的轻量开发辅助框架：可接入任意 PHP 项目，内置业务开发里高频出现的能力。

定位：不引入依赖注入容器，不接管路由、中间件与 MVC 基类。装配结果是一组不可变对象，业务代码按需取用；工具类均为纯静态，可直接调用。余下的判断留给宿主框架。

能力矩阵

能力	适用场景	入口
参数定义与整形	入口参数补默认值、定形状、按需挑选	`Fxri\Param\Definition`
字段与数据整理	生成 SQL 字段表达式、列表转树、差异比对	`Fxri\Data\Field`
链式条件构造	拼 SQL 片段与绑定值，执行交给调用方	`Fxri\Sql\WhereBuilder`
文本与时间	字符串处理、编解码、IP 转换、UUID	`Fxri\Text\Str`
文件与路径	目录读写、路径归一、MIME 映射	`Fxri\File\Filesystem`
安全	摘要、对称与非对称加解密、一次性令牌	`Fxri\Security\Cipher`
HTTP	统一响应信封、请求上下文、Cookie、视图	`Fxri\Http\Envelope`
装配与配置	配置目录加载、日志、翻译器、框架适配	`Fxri\KernelBuilder`

文档

文档	适合谁
快速开始	第一次接触，想先跑起来
内核与装配	了解内核边界与装配方式
配置	配置目录、环境变量与翻译词条
参数	入参定义、合并与挑选
数据	字段表达式、树形结构与数据比对
SQL	链式条件与语句片段构造
文本	字符串、编码、IP、时间、UUID
文件	目录读写、路径与 MIME
安全	摘要、加密、签名与令牌
HTTP	响应信封、请求上下文、Cookie、视图与客户端
支撑	类型判定、随机串、格式化、调试输出
接入已有框架	把内核绑定进宿主容器
2.0 迁移说明	从 1.x 升级，查旧 API 的新写法
常见问题	遇到问题先来这里找
贡献指南	本地开发、验收命令与发版链路
更新日志	查各版本变更内容
完整文档站	在线阅读体验

安装

composer require fxri/fxyin

运行环境要求 PHP 8.2 起，需开启 mbstring 扩展，安全相关功能另需 openssl；其余能力依赖的 PSR 包按需安装。

快速上手

<?php

declare(strict_types=1);

use Fxri\KernelBuilder;

$kernel = KernelBuilder::make()
    ->withConfigDir(__DIR__ . '/config')
    ->build();

// config/app.php 的内容位于 app 键下
echo $kernel->config()->get('app.name', '未命名');

装配项均可选，目录结构、注入方式与更多示例见快速开始。

参与贡献

开发环境、验收命令（composer check）、提交规范与发版链路见贡献指南；问题反馈走 GitHub Issues。

版权信息

作者：唐启云 tqy@fxri.net

出品：方弦研究所

网站：方弦研究信息网

协议：Apache License 2.0

商标："方弦®"为第42类注册商标（注册号89648411），本开源许可不授予商标使用权，详见 TRADEMARK.md

方弦研究所为唐启云个人项目品牌与出品方，非独立法人实体；本软件著作权归唐启云所有。

fxri / fxyin

Package info

Security

Statistics