# CrystalPHP

**Repository Path**: dinghaoran/CrystalPHP

## Basic Information

- **Project Name**: CrystalPHP
- **Description**: CrystalPHP：一个自制的PHP框架
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-04-23
- **Last Updated**: 2026-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CrystalPHP

一个自制的轻量级 PHP 框架

## 项目简介

CrystalPHP 是一个由个人开发者自制的轻量级 PHP 框架，简洁易用，开发效率高。框架名称"Crystal"取自“水晶”之意，寓意代码如水晶般晶莹剔透、结构清晰。

## 框架结构

```
CrystalPHP/
├── crystal/                 # 框架核心目录
│   ├── index.php            # 框架入口，运行框架
│   ├── loader.php           # 类自动加载器
│   └── library/             # 框架核心类库
│       ├── common/          # 公共函数
│       │   └── common.php   # 基础函数工具
│       ├── functions.php    # 全局辅助函数
│       ├── log.php          # 日志类
│       ├── model.php        # 模型基类
│       ├── model/           # 数据库相关
│       │   ├── mysql.php    # MySQL 连接
│       │   ├── query.php    # 查询构造器
│       │   └── record.php   # 记录结果集
│       ├── route.php        # 路由处理
│       └── view.php         # 视图/模板
├── app/                     # 应用目录
│   ├── config.php           # 配置文件
│   ├── common.php           # 应用公共函数
│   └── index/               # 示例模块
│       ├── common.php
│       ├── controller/      # 控制器
│       ├── model/           # 模型
│       └── view/            # 视图模板
├── public/                  # 公开资源目录
├── runtime/                 # 运行时目录
├── vendor/                  # 第三方依赖
└── index.php                # 入口文件
```

## 核心功能

### 路由系统

- URL 路由解析与分发
- 模块/控制器/动作自动映射
- 支持自定义路由规则

### 数据库

- MySQL 数据库连接
- Query Builder 查询构造器
- 支持 where、order、limit、join 等链式操作
- PDO 参数绑定防止 SQL 注入

### 视图

- 模板引擎
- 变量assign分配
- 模板编译与缓存

### 辅助函数

- `_get()` - 获取 GET 参数
- `_post()` - 获取 POST 参数
- `_cookie()` - 获取 Cookie
- `_input()` - 获取输入数据
- `url()` - URL 生成
- `view()` - 渲染视图
- `p()` - 调试打印
- `json()` - JSON 响应

### 日志系统

- notice 信息记录
- error 错误记录
- 按日期分文件存储

## 安装要求

- PHP >= 5.6
- MySQL >= 5.0
- PDO 扩展