akourpro / wheat
Wheat 是一个 PHP 库,极大地简化了开发人员的代码编写。它以许多简洁且安全的函数为特点。
dev-main
2024-07-14 23:32 UTC
Requires
- php: >=7.3.0
This package is not auto-updated.
Last update: 2024-09-25 15:24:50 UTC
README
面粉
面粉是一个非常简洁且安全的 PHP 库,它极大地简化了开发人员的代码编写。
导入库
- 您可以直接从 Github 下载此库。
- 或者您可以使用以下命令下载:
git clone https://github.com/akourpro/wheat.git
主要功能
例如:从数据库中获取数据
dbSelect($table, $selects, $where = null, $vars = null)
输入
$table
: 要获取数据的表名。$selects
: 要获取数据的单元格。$where
(可选): 搜索条件。$vars
(可选): 搜索条件的变量。
输出
- 函数将结果存储在名为
$rows
的数组中。 - 找到的行数存储在名为
$countrows
的变量中。
使用方法
- 数据查询
dbSelect($table, $selects, $where = null, $vars = null);
真实示例
$columns = "column1, column2"; $where = "WHERE name = ?"; $value = ["wheat"]; dbSelect('table', $columns, $where, $value);
- 插入新数据
dbInsert($table, $columns, $vars);
真实示例
$columns = "name, email, password"; $values = [$name, $email, $password]; dbInsert("users", $columns, $values);
- 更新数据
dbUpdate($table, $columns, $vars, $where = null);
真实示例
$id = 1; $columns = "name = ?, email = ?, password = ?"; $values = [$name, $email, $password, $id]; $where = "WHERE id = ?"; dbUpdate("users", $columns, $values, $where);
- 删除数据
dbDelete($table, $where = null, $vars = null);
真实示例
$where = "WHERE name = ?"; $values = ["Akour"]; dbDelete("users", $where, $values);
上传文件
在面粉库中,我们开发了专门用于处理服务器上文件的系统
up($name, $input, $dir, $max_size);
-
变量
$name
= 将原始文件名更改为此变量的名称 -
变量
$input
= HTML Form (input file) 字段的上传文件名 -
变量
$max_size
= 文件的最大大小(以兆字节为单位) -
变量
$dir
= 保存文件的路径(服务器上的保存位置)在数据库中生成随机且不重复的数字
genCode($table, $column, $type, $size);
例如,创建用于验证邮件或验证密码的操作的令牌代码
该代码会创建一个新令牌,并确保它之前不在数据库中
变量 $size
: 令牌大小可以是 8 或 16 或更多,大小越大,难度越高,长度越长
变量 $table
: 要检查的表
变量 $col
: 要检查的列
变量 $type
: 接受两种类型 token,id 您可以使用随机代码生成器与文件上传功能一起使用
保护输入(文本和数字)
面粉库中有两个用于保护输入的功能:一个是 safer
,用于文本,另一个是 numer
,仅用于数字,例如
$name = safer($_POST['name']); // لحماية النصوص $number = numer($_POST['your_age']); // لحماية الأرقام
检查
您可以通过面粉库中的 check
函数检查输入,例如
check($var, $type);
此函数检查输入类型,如果出错则返回 false
- 变量
$var
: 专门用于接收值 - 变量
$type
: 用于指定值类型,面粉库中的检查类型是
- 数字,用 num 表示
- 电子邮件,用 email 表示
- 文本,用 txt 表示
- 阿拉伯语,用 ar 表示
- 拉丁语,用 en 表示
- 链接,用 url 表示
处理位置设置
- 要使用面粉库处理位置设置,我们假设您有一个名为
settings
的数据库表,其中包含 3 个单元格:id
、name
和value
。其中,name
单元格包含将用于处理的位置的名称,类似于 key value to array,而value
是此数组的值 - 要处理它,我们可以使用以下命令
gsite();
它将从数据库中获取数据
- 以下是在数据库中创建
settings
表的示例命令
CREATE TABLE settings ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(255) NOT NULL, value TEXT NOT NULL );
警报
面粉库使用 Sweet 在查询操作中使用警报,例如
sweet($type, $title, $text, $link = null);
它接收 3 个必需变量和一个可选变量
- 变量
$type
:用于指定警报类型,它接受 error、success、warning、info 和 question,这些是 SweetAlerts 默认使用的 - 变量
$title
是用来指定消息主标题的。 - 变量
$text
是用来编写消息文本的,你可以使用 HTML 代码。 - 变量
$link
是可选的,不是必需的,用于在显示通知后重定向用户到特定路径,你可以写here
来重定向到当前页面。
真实示例
$type = "error"; $title = "خطأ"; $text = "جميع الحقول مطلوبة !"; sweet($type, $title, $text);
结束
- 这个说明是为了完全阐述这个库的基本内容,若想了解更多关于这个库的信息,请查看路径
includes/functions.php
,每个函数都会有简要的说明。 - 或者你也可以在 YouTube 上查看一些教程。
要求
- 需要 PHP 7.3 或更高版本。
开发者
这个库是由以下人员开发的:
许可
[GPL]
贡献
这个项目对所有开发者开放,欢迎贡献以共同开发这个库,种下一粒小麦,收获一片麦田。