akourpro/wheat

Wheat 是一个 PHP 库,极大地简化了开发人员的代码编写。它以许多简洁且安全的函数为特点。

dev-main 2024-07-14 23:32 UTC

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 的变量中。

使用方法

  1. 数据查询
dbSelect($table, $selects, $where = null, $vars = null);

真实示例

$columns = "column1, column2";
$where = "WHERE name = ?";
$value = ["wheat"];
dbSelect('table', $columns, $where, $value);
  1. 插入新数据
dbInsert($table, $columns, $vars);

真实示例

$columns = "name, email, password";
$values = [$name, $email, $password];
dbInsert("users", $columns, $values);
  1. 更新数据
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);
  1. 删除数据
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: 用于指定值类型,面粉库中的检查类型是
    1. 数字,用 num 表示
    2. 电子邮件,用 email 表示
    3. 文本,用 txt 表示
    4. 阿拉伯语,用 ar 表示
    5. 拉丁语,用 en 表示
    6. 链接,用 url 表示

    处理位置设置

    • 要使用面粉库处理位置设置,我们假设您有一个名为 settings 的数据库表,其中包含 3 个单元格:idnamevalue。其中,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]

    贡献

    这个项目对所有开发者开放,欢迎贡献以共同开发这个库,种下一粒小麦,收获一片麦田。