Agile Toolkit 技术文档

1. 安装指南

1.1 下载安装包

首先，您可以从 Agile Toolkit 官网 下载最新的安装包。下载完成后，解压缩文件到您的项目目录。

1.2 使用 Composer 安装

如果您是高级开发者，可以通过 Composer 来安装 Agile Toolkit。在您的 composer.json 文件中添加以下代码：

"require": {
    "atk4/atk4": "4.3.*@dev"
}

然后运行 composer install 命令来安装依赖。

2. 项目的使用说明

2.1 创建新项目

在 Agile Toolkit 中，您可以通过下载的安装包或 Composer 安装来创建一个新的 Web 应用程序。安装完成后，您可以在项目目录中找到 page/index.php 文件，这是项目的入口文件。

2.2 示例代码

以下是一个简单的示例代码，展示了如何使用 Agile Toolkit 创建一个 AJAX 表单：

$form = $this->add('Form');
$form->addField('line', 'subject')->validateNotNull();
$form->addField('password','password');
$form->addSubmit();

if ($form->isSubmitted()) {
    $this->js()->univ()
        ->dialogOK('Hello World','Subject: '.$form['subject'])
        ->execute();
}

将上述代码复制到 page/index.php 文件的 init() 方法中，即可创建一个带有验证功能的 AJAX 表单。

3. 项目API使用文档

3.1 核心类

• Application: 顶层应用对象，负责管理所有其他对象的创建和生命周期。
• Form: 用于创建表单的类，支持多种字段类型和验证。
• Grid: 用于展示数据的表格组件，支持分页和排序。
• Menu: 用于创建导航菜单的类。

3.2 常用方法

• add($class): 向当前对象添加一个新的组件。
• validateNotNull(): 验证字段不能为空。
• isSubmitted(): 检查表单是否已提交。
• js()->univ()->dialogOK(): 显示一个对话框，支持 AJAX 调用。

4. 项目安装方式

4.1 手动安装

1. 下载安装包并解压缩到项目目录。
2. 配置 Web 服务器，确保项目目录可以通过浏览器访问。
3. 打开浏览器，访问项目入口文件（如 index.php）。

4.2 Composer 安装

1. 在项目根目录下创建 composer.json 文件，并添加 Agile Toolkit 依赖。
2. 运行 composer install 命令安装依赖。
3. 配置 Web 服务器，确保项目目录可以通过浏览器访问。
4. 打开浏览器，访问项目入口文件（如 index.php）。

通过以上步骤，您可以成功安装并开始使用 Agile Toolkit 开发 Web 应用程序。