Skip to content

创建应用

请根据以下步骤来创建一个应用以便更好的理解应用开发,应用创建均使用 dux 命令行工具。

创建结构

使用 dux 命令行工具创建应用:

bash
./dux generate:app 应用名
./dux generate:app 应用名

应用将会被创建在 app 目录下,其中应用名是自定义的。

TIP

该命令还会将应用注册到系统内 config/app.yaml 配置中,该配置可加载应用入口。

创建模型

创建数据模型,可以使用以下命令生成模型文件:

bash
# 执行后请根据提示输入模型名
./dux generate:model 应用名
# 执行后请根据提示输入模型名
./dux generate:model 应用名

生成的模型文件位于应用的 Models 目录下,示例:

php
<?php

declare(strict_types=1);

namespace App\Test\Models;

use Dux\Database\Attribute\AutoMigrate;

#[AutoMigrate]
class Test extends \Dux\Database\Model
{
    // 表名
	public $table = 'test';

    // 数据表同步结构
	public function migration(\Illuminate\Database\Schema\Blueprint $table)
	{
		$table->id();
		
		// 自定义数据表字段
		$table->string('name')->comment('名称');
		
		$table->timestamps();
	}
}
<?php

declare(strict_types=1);

namespace App\Test\Models;

use Dux\Database\Attribute\AutoMigrate;

#[AutoMigrate]
class Test extends \Dux\Database\Model
{
    // 表名
	public $table = 'test';

    // 数据表同步结构
	public function migration(\Illuminate\Database\Schema\Blueprint $table)
	{
		$table->id();
		
		// 自定义数据表字段
		$table->string('name')->comment('名称');
		
		$table->timestamps();
	}
}

migration 方法中定义需要的字段。调用字段时可以参考文档 数据库迁移字段

定义完字段后,可以使用以下命令将字段同步至数据库,无需手动操作数据库:

bash
./dux db:sync 应用名
./dux db:sync 应用名

创建管理控制器

可以使用以下命令生成后台管理控制器与前端文件:

bash
./dux generate:manage 应用名
./dux generate:manage 应用名

使用该命令将生成对应的控制器文件类,需要手动将 $model 公共变量修改为模型的命名空间类名,会自动生成注解中的路由、权限信息。

创建前端页面

使用创建管理控制器命令会顺便在 web/src/pages/应用名/admin 中创建对应的页面目录,可进行后续开发修改。

预览调试应用

在配置文件 use.yaml 中打开前端调试,在 web 目录中使用以下命令启动前端调试:

bash
 yarn dev
 yarn dev

通过浏览器访问后台即可进入前端开发者模式。

结束

现在,您已经掌握了一个应用的基础开发方式。要深入了解更多内容,请参考类库文档和第三方包文档。

Released under the MIT License.