iszsw/curd

thinkphp6 低代码自动构建CURD页面

可视化CURD代码生成工具.

源码

gitee地址：https://gitee.com/iszsw/curd

github地址：https://github.com/iszsw/curd

文档

https://doc.zsw.ink

演示

https://demo.curd.zsw.ink/

安装

# 运行环境要求 PHP8+
composer require iszsw/curd

在线编辑生成页面

curd作为surface的自定义组件，完全遵循surface的开发规范，因此，你可以直接在surface中调用curd组件，无需任何配置，直接使用即可。

// 演示地址完整代码
<?php

use curd\Curd;
use surface\components\Input;
use surface\components\Number;
use surface\components\Upload;
use surface\components\TableColumn;

// 预定义的列
$tableColumns = [
    (new TableColumn())->props(['label' => '用户名', 'prop' => 'username']),
    (new TableColumn())->props(['label' => '年龄', 'prop' => 'age']),
    (new TableColumn())->props(['label' => '手机号', 'prop' => 'phone']),
    (new TableColumn())->props(['label' => '邮箱', 'prop' => 'email']),
    (new TableColumn())->props(['label' => '头像', 'prop' => 'avatar']),
    (new TableColumn())->props(['label' => '注册时间', 'prop' => 'create_time']),
];
$formColumns = [
    (new Input(["label" => "用户名", "name" => "username"]))->rules(['required' => true, 'message' => '请输入用户名']),
    (new Number(["label" => "年龄", "name" => "age"])),
    (new Input(["label" => "手机号", "name" => "phone"])),
    (new Input(["label" => "邮箱", "name" => "email"])),
    (new Upload(["label" => "头像", "name" => "avatar"])),
];

// curd组件
$curd = (new Curd())->props([
    'extComponent' => [
        [
            'label'      => "扩展组件",
            'components' => [
                [
                    'component' => [
                        (new Input(['label' => 'Input1', 'name' => '第一项'])),
                        (new Input(['label' => 'Input2', 'name' => '第二项']))
                    ],
                    'label'     => '批量插入',
                    'icon'      => "组件"
                ],
            ],
        ]
    ],
    "default-form" => [
        'options' => new \stdClass(),
        'columns' => $formColumns,
    ],
    "default-table" => [
        'options' => [
            "request" => [
                "url" => ""
            ]
        ],
        'columns' => $tableColumns,
    ]
]);

// 渲染页面
echo $curd->view();

根据数据库源生成默认配置

调用 Curd::withDbSource(\PDO $pdo, string $database, string $tableName = '') 方法,指定数据库源，生成默认配置。

下面提供一个ThinkPHP在页面上选择数据库源的示例：

// 从参数中获取表名
$table = $this->request->get('table', '');

$curd = (new \curd\Curd())->props([
    'extComponent' => [
        [
            'label'      => "扩展组件",
            'components' => [
                [
                    'component' => [
                        (new Input(['label' => 'Input1', 'name' => 'Input1'])),
                        (new Input(['label' => 'Input2', 'name' => 'Input2']))
                    ],
                    'label'     => '批量插入',
                    'icon'      => "组件"
                ],
            ],
        ]
    ],
])
// Tp框架获取Pdo连接：Db::connect()->connect()
->withDbSource(Db::connect()->connect(), '数据库名', $table);

$surface = new Surface();

// 下面代码提供一个下拉选择框浮动到页面上，选中表名之后生成默认配置
$surface->addStyle(
"<style>
.table-list{
    position: fixed;
    top: 10px;
    right: 510px;
    z-index: 99;
    width: 200px;
}
</style>");

$tableNames = [];
foreach (Db::query("SHOW TABLES") as $info) {
    $name = $info['Tables_in_surface'];
    $tableNames[$name] = $name;
}
$surface->append((new Select())->props([
    'class' => "table-list",
    'filterable' => true,
    'model-value' => new Vmodel("cur_table_name", $table),
    'model-value' => $table,
    // 将选中的表名同步到url刷新页面
    'onChange' => Functions::create(<<<JS
let url = window.location.href
let paramName = 'table'
let pattern = new RegExp('(' + paramName + '=).*?(&|$)');
if (url.search(pattern)>=0) {
    url = url.replace(pattern,'$1' + name + '$2');
} else {
    url += (url.indexOf('?')>0 ? '&' : '?') + paramName + '=' + name;
}
window.location.href = url;
JS, ['name'])
])->options($tableNames));
$surface->append($curd);

return $surface->view();

curd's Issues

缺少完善的文档

文档缺失，
配置里只有路由前缀，
生成菜单后的地址一般是什么样？如何访问 只能看demo才知道是curd/page/index?_table=z_user，生成菜单感觉有歧义，只是生成路由映射吧，所有的数据表配置保存在配置里，不透明。
然后上传改了之后上传报错403
去看源码suface 才知道要返回

echo json_encode(
    [
        'code' => 0,
        'msg'  => 'success',
        'data' => [
            'url'  => 'http://q1.qlogo.cn/g?b=qq&nk=191587'.rand(100, 999).'&s=640',
        ],
    ], JSON_UNESCAPED_UNICODE
);

这种格式，
相当于上传后的字段只能存路径，像一般cms是上传后插入附件表md5 去重，返回id,展示用id获取路径的。

curd如何使用可编辑开关？

数据库表在tinyint字段下应该如何配置，定义开关修改键值为0或者1？
直接采用默认设置无法修改数据

字段展开后会导致操作按钮错位

1,数值数据转换为字符串输出会导致排序时按字典序排列 2,分页功能无效

curd/src/lib/ResolveTable.php

Line 505 in 506468b

return is_array($data) ? json_encode($data, JSON_UNESCAPED_UNICODE) : (string)$data;

switcher组件的数据绑定有问题，需要把目标字段的值强制转换成bool类型