Skip to content

风音框架可接入任意 PHP 项目的辅助框架

不引入容器、不接管路由,装配结果是一组不可变对象;参数、数据、SQL、文本、文件、HTTP 与安全等高频能力以纯静态类提供,随取随用。

30 秒上手 ​

bash
composer require fxri/fxyin

装配一个内核,随后按需取用配置与翻译:

php
<?php

declare(strict_types=1);

use Fxri\KernelBuilder;

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

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

// 取翻译,未注入翻译器时由内置词条兜底
echo $kernel->trans('欢迎');

详细步骤见快速开始。

解决什么痛点 ​

痛点本框架的做法
参数校验、文件操作、加解密这些碎活,换个项目就得重写一遍九类高频能力内置为纯静态类,use 进来即可调用,不绑定任何框架生命周期
为了一个工具函数引入重量级框架,容器、路由、中间件一并背上不引入依赖注入容器、不提供路由与 MVC 基类;装配项全部可选,缺省即有可用实现
老代码里的数字码与点分模式号,过半年没人看得懂全部改为具名枚举与链式方法,调用处自带语义
1.x 升级到 2.0 改动面大,不知从哪下手2.0 迁移说明 逐项列出旧 API 到新 API 的对照与不再提供的能力
文档散落在 README,翻起来靠关键词硬找独立文档站,带全站中文搜索、按能力层划分的侧栏与逐页目录

文档索引 ​

文档适合谁
快速开始第一次接触,想先把框架跑起来
2.0 迁移从 1.x 升级,需要逐项对照改造
更新日志查各版本变更内容

环境要求 ​

  • PHP >= 8.2
  • 扩展 mbstring(必需)、openssl(安全相关功能需要)
  • 可选依赖:psr/http-client、psr/http-message、psr/http-factory 及其实现(如 symfony/http-client、nyholm/psr7)

Apache License 2.0