# fastphp
**Repository Path**: adilt/fastphp
## Basic Information
- **Project Name**: fastphp
- **Description**: FastPHP 是一个轻量级的 PHP MVC 框架，采用 ThinkPHP 风格的设计理念，提供完整的 Web 开发解决方案
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-31
- **Last Updated**: 2025-07-31
## Categories & Tags
**Categories**: Uncategorized
**Tags**: PHP, MVC, 轻量级, RedBeanPHP
## README
# FastPHP - 轻量级PHP MVC框架
[](https://php.net)
[](LICENSE)
[](https://fastphp.com)
FastPHP 是一个轻量级的 PHP MVC 框架，采用 ThinkPHP 风格的设计理念，提供完整的 Web 开发解决方案。
## ✨ 特性
- 🚀 **轻量级** - 核心代码精简，易于理解和扩展
- 🏗️ **MVC架构** - 经典的Model-View-Controller模式
- 🔄 **多应用分组** - 支持admin、home等多个应用分组
- 🛣️ **灵活路由** - 支持PATH_INFO、Query String等多种路由模式
- 🗄️ **RedBeanPHP** - 强大的ORM数据库操作
- ✅ **数据验证** - 内置多种验证规则和自定义验证
- 💾 **缓存系统** - 支持文件、Redis等多种缓存驱动
- 🛡️ **安全防护** - CSRF令牌、输入过滤等安全机制
- 🎨 **美观界面** - 现代化的错误页面和跳转界面
- 📚 **完整文档** - 基于VitePress的详细文档
## 🚀 快速开始
### 环境要求
- PHP >= 7.0
- MySQL >= 5.6
- Web服务器（Apache/Nginx）
### 安装使用
1. **克隆项目**
```bash
git clone https://github.com/your-repo/fastphp.git
cd fastphp
```
2. **配置数据库**
```php
// config/database.php
return [
'type' => 'mysql',
'host' => 'localhost',
'port' => 3306,
'dbname' => 'fastphp',
'charset' => 'utf8',
'username' => 'root',
'password' => '',
];
```
3. **创建控制器**
```php
assign('message', 'Hello FastPHP!');
$this->display();
}
}
```
4. **创建视图**
```php
Hello
```
5. **访问应用**
```
http://your-domain.com/admin/hello/index.html
```
## 📁 目录结构
```
fastphp.com/
├── admin/ # 后台管理应用
│ ├── app/
│ │ ├── controller/ # 控制器目录
│ │ ├── model/ # 模型目录
│ │ ├── validate/ # 验证器目录
│ │ └── view/ # 视图目录
│ ├── config/ # 应用配置
│ ├── runtime/ # 运行时文件
│ └── index.php # 后台入口文件
├── home/ # 前台应用
│ ├── app/
│ │ ├── controller/
│ │ ├── model/
│ │ ├── validate/
│ │ └── view/
│ ├── config/
│ ├── runtime/
│ └── index.php
├── config/ # 全局配置
│ ├── app.php # 应用配置
│ ├── database.php # 数据库配置
│ └── cache.php # 缓存配置
├── FastPHP/ # 框架核心
│ ├── Core/ # 核心类
│ ├── Library/ # 扩展库
│ └── tpl/ # 模板文件
├── docs/ # 文档目录
│ └── .vitepress/ # VitePress配置
└── index.php # 主入口文件
```
## 🔧 核心功能
### 路由系统
```php
// 支持多种URL格式
http://fastphp.com/admin/user/login.html
http://fastphp.com/?s=admin&c=user&a=login
// 自定义路由规则
'admin/login' => 'admin/user/login',
'admin/user/:id' => 'admin/user/profile',
```
### 数据库操作
```php
// 使用RedBeanPHP进行数据库操作
$users = \R::findAll('user');
$user = \R::findOne('user', 'username = ?', ['admin']);
$user = \R::load('user', 1);
```
### 数据验证
```php
// 验证器定义
protected $rule = [
'username' => 'require|length:3,20',
'email' => 'require|email',
'password' => 'require|length:6,20',
];
// 验证使用
$validate = new \admin\app\validate\User();
if (!$validate->check($data)) {
$this->error($validate->getError());
}
```
### 缓存系统
```php
// 缓存操作
cache()->set('key', 'value', 3600);
$value = cache()->get('key');
cache()->delete('key');
```
## 📖 文档
详细的文档请访问：[FastPHP 文档](https://fastphp.com)
### 本地运行文档
```bash
cd docs
npm install
npm run docs:dev
```
## 🛠️ 开发
### 项目结构说明
- **FastPHP/Core/** - 框架核心类
- `Controller.php` - 基础控制器类
- `Model.php` - 基础模型类
- `Router.php` - 路由解析类
- `ErrorHandler.php` - 错误处理类
- **FastPHP/Library/** - 扩展库
- `Request.php` - 请求处理类
- `Response.php` - 响应处理类
- `Validate.php` - 数据验证类
- `Cache.php` - 缓存处理类
- `Common.php` - 公共函数库
- **FastPHP/tpl/** - 模板文件
- `error.php` - 错误页面模板
- `dispatch_jump.tpl` - 跳转页面模板
### 配置说明
#### 应用配置 (config/app.php)
```php
return [
'app_name' => 'FastPHP',
'debug' => true,
'route' => [
'suffix' => '.html',
'mode' => 'auto',
],
'jump' => [
'template' => 'FastPHP/tpl/dispatch_jump.tpl',
'title' => '提示信息',
],
];
```
#### 数据库配置 (config/database.php)
```php
return [
'type' => 'mysql',
'host' => 'localhost',
'port' => 3306,
'dbname' => 'fastphp',
'charset' => 'utf8',
'username' => 'root',
'password' => '',
];
```
## 🚀 部署
### 生产环境配置
1. **关闭调试模式**
```php
// config/app.php
'debug' => false,
```
2. **配置Web服务器**
```nginx
# Nginx配置
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
```
3. **设置文件权限**
```bash
chmod -R 755 runtime/
chmod 644 config/*.php
```
详细部署指南请参考：[部署指南](docs/guide/deployment.md)
## 🤝 贡献
欢迎提交 Issue 和 Pull Request！
### 开发流程
1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request
## 📄 许可证
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
## 🙏 致谢
- [ThinkPHP](https://thinkphp.cn/) - 设计理念参考
- [RedBeanPHP](https://redbeanphp.com/) - ORM数据库操作
- [VitePress](https://vitepress.dev/) - 文档生成
## 📞 联系我们
- 项目主页：[https://github.com/your-repo/fastphp](https://github.com/your-repo/fastphp)
- 文档地址：[https://fastphp.com](https://fastphp.com)
- 问题反馈：[Issues](https://github.com/your-repo/fastphp/issues)
---
**FastPHP** - 让 Web 开发更简单！ 🚀