README

数据层是数据库的持久抽象组件，PDO已为执行常见操作（如注册、读取、编辑和删除数据）准备了指令。

数据层是一个持久抽象组件，您的数据库使用PDO（预编译语句）执行常见操作，如注册、读取、编辑和删除数据。

关于CoffeeCode

CoffeeCode是一组小型且经过优化的PHP组件，用于常见任务。由Robson V. Leite和UpInside团队维护。与他们一起，您可以以更少的代码执行常规任务，写得更少，做得更多。

CoffeeCode是一组小型且经过优化的PHP组件，用于常见任务。由Robson V. Leite和UpInside团队维护。与他们一起，您可以以更少的代码执行常规任务，写得更少，做得更多。

亮点

• 易于设置（简单设置）
• 总CRUD抽象（完全CRUD抽象）
• 创建安全模型（创建安全模型）
• Composer就绪（Composer就绪）
• PSR-2兼容（PSR-2兼容）

安装

数据层可通过Composer获取

"coffeecode/datalayer": "2.0.*"

或运行

composer require coffeecode/datalayer

文档

有关如何使用数据层的详细信息，请参阅组件目录中的示例文件夹

有关如何使用数据层的更多详细信息，请参阅组件目录中的示例文件夹

连接

要开始使用数据层，您需要连接到数据库（MariaDB / MySQL）。有关更多信息，请参阅PHP.net上的PDO连接手册

为了开始使用数据层，我们需要连接到您的数据库。有关更多信息，请参阅PHP.net上的PDO连接手册

const DATA_LAYER_CONFIG = [
    "driver" => "mysql",
    "host" => "localhost",
    "port" => "3306",
    "dbname" => "datalayer_example",
    "username" => "root",
    "passwd" => "",
    "options" => [
        PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8",
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_OBJ,
        PDO::ATTR_CASE => PDO::CASE_NATURAL
    ]
];

您的模型

数据层基于MVC结构，采用Layer Super Type和Active Record设计模式。要使用它，需要创建您的表模型并继承数据层。

数据层基于MVC结构，采用Layer Super Type和Active Record设计模式。要使用它，需要创建您的表模型并继承数据层。

<?php

class User extends DataLayer
{
    /**
     * User constructor.
     */
    public function __construct()
    {
        //string "TABLE_NAME", array ["REQUIRED_FIELD_1", "REQUIRED_FIELD_2"], string "PRIMARY_KEY", bool "TIMESTAMPS"
        parent::__construct("users", ["first_name", "last_name"]);
    }
}

查找

<?php

use Example\Models\User;

$model = new User();

//find all users
$users = $model->find()->fetch(true);

//find all users limit 2
$users = $model->find()->limit(2)->fetch(true);

//find all users limit 2 offset 2
$users = $model->find()->limit(2)->offset(2)->fetch(true);

//find all users limit 2 offset 2 order by field ASC
$users = $model->find()->limit(2)->offset(2)->order("first_name ASC")->fetch(true);

// find all users with in operator
$users = $model->find()->in("id", [1, 2, 3])->fetch(true);

//looping users
foreach ($users as $user) {
    echo $user->first_name;
}

//find one user by condition
$user = $model->find("first_name = :name", "name=Robson")->fetch();
echo $user->first_name;

//find one user by two conditions
$user = $model->find("first_name = :name AND last_name = :last", "name=Robson&last=Leite")->fetch();
echo $user->first_name . " " . $user->first_last;

//find one user by condition and with in operator
$user = $model->find("first_name = :name", "name=Robson")->in("last_name",["Menezes", "Sampaio"])->fetch(true);

foreach ($users as $user) {
    echo $user->first_name . " " . $user->first_last;
}

按ID查找

<?php

use Example\Models\User;

$model = new User();
$user = $model->findById(2);
echo $user->first_name;

安全参数

查看find_example.php示例和模型类

请查看find_example.php示例和模型类

<?php

$params = http_build_query(["name" => "UpInside & Associated"]);
$company = (new Company())->find("name = :name", $params);
var_dump($company, $company->fetch());

连接方法

查看find_example.php示例和模型类

请查看find_example.php示例和模型类

<?php

$addresses = new Address();
$address = $addresses->findById(22);
//get user data to this->user->[all data]
$address->user();
var_dump($address);

计数

<?php

use Example\Models\User;

$model = new User();
$count = $model->find()->count();

保存创建

<?php

use Example\Models\User;

$user = new User();
$user->first_name = "Robson";
$user->last_name = "Leite";
$userId = $user->save();

保存更新

<?php

use Example\Models\User;

$user = (new User())->findById(2);
$user->first_name = "Robson";
$userId = $user->save();

销毁

<?php

use Example\Models\User;

$user = (new User())->findById(2);
$user->destroy();

失败

<?php

use Example\Models\User;

$user = (new User())->findById(2);
if($user->fail()){
    echo $user->fail()->getMessage();
}

自定义数据方法

<?php

class User{

    public function fullName(): string 
    {
        return "{$this->first_name} {$this->last_name}";
    }
    
    public function document(): string
    {
        return "Restrict";
    }
}

echo $this->full_name; //Robson V. Leite
echo $this->document; //Restrict

贡献

有关详细信息，请参阅CONTRIBUTING

支持

安全：如果您发现任何安全问题，请通过电子邮件cursos@upinside.com.br联系，而不是使用问题跟踪器。

如果您发现任何安全问题，请通过电子邮件cursos@upinside.com.br联系，而不是使用问题跟踪器。

谢谢

鸣谢

• Robson V. Leite（开发者）
• UpInside Treinamentos（团队）
• 所有贡献者（这块岩石）

许可协议

MIT 许可协议（MIT）。有关更多信息，请参阅许可文件。