README

简单的 PHP 扩展用于 Datatables

安装

使用包管理器 composer 安装库

composer require riculum/php-datatables

初始设置

凭证

基本数据库设置可以通过环境变量设置。在项目的根目录中添加一个 .env 文件。确保将 .env 文件添加到您的 .gitignore 中，以便它不会被代码检查。默认情况下，库会查找以下变量

• DB_HOST
• DB_NAME
• DB_USERNAME
• DB_PASSWORD

有关如何使用环境变量的更多信息，请参阅 这里

配置

导入 vendor/autoload.php 并加载 .env 设置

require_once 'vendor/autoload.php';

use Database\Core\Database as DB;

$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();

Datatables

基础

要获取正确格式的数据，您只需定义表格和列即可

$table = "user";
$columns = ["id", "firstname", "lastname", "company", "address", "city", "email", "phone"];

echo Datatable::getDatatable($table, $columns);

连接

要结合多个具有相关列的表格，请使用 SQL JOIN 语句

$table = "user JOIN city ON user.zip = city.zip";
$columns = ["user.id", "firstname", "lastname", "company", "address", "city.name", "email", "phone"];

echo Datatable::getDatatable($table, $columns);

注意指定带有表名的列

WHERE

使用 WHERE 子句仅提取满足特定条件的记录

$table = "user";
$columns = ["id", "firstname", "lastname", "company", "address", "city", "email", "phone"];

$where =     [
    'key' => 'id',
    'operator' => '=',
    'value' => 1
];

echo Datatable::getDatatable($table, $columns, $where);

错误报告 & 贡献

如果您发现错误，请在 github 上创建工单或发起拉取请求

版本控制

我们遵循语义（主要.次要.补丁）版本控制 (https://semver.org/)。这意味着

• 补丁版本 (x.x.patch) 修复错误
• 次要版本 (x.minor.x) 引入新的向后兼容功能或改进现有代码。
• 主要版本 (major.x.x) 引入不兼容的彻底变化。

在您的自动化或流程中，您可以安全地更新补丁和次要版本，而无需担心您的应用程序失败。