Propel 技术文档

1. 安装指南

1.1 系统要求

• PHP 5.x 或更高版本
• 支持的数据库：MySQL, SQLite, PostgreSQL, Oracle, MSSQL

1.2 安装步骤

1. 使用 Composer 安装 Propel：

   composer require propel/propel1
   

2. 生成配置文件：

   vendor/bin/propel-gen
   

3. 根据生成的配置文件，配置数据库连接信息。

2. 项目的使用说明

2.1 初始化项目

1. 创建数据库表结构。
2. 使用 Propel 生成模型文件：

   vendor/bin/propel-gen model
   

3. 生成 SQL 文件并执行：

   vendor/bin/propel-gen sql
   vendor/bin/propel-gen insert-sql
   

2.2 基本操作

• 创建记录：

  $book = new Book();
  $book->setTitle('Propel Book');
  $book->save();
  

• 查询记录：

  $books = BookQuery::create()->find();
  foreach ($books as $book) {
      echo $book->getTitle();
  }
  

• 更新记录：

  $book = BookQuery::create()->findPk(1);
  $book->setTitle('New Title');
  $book->save();
  

• 删除记录：

  $book = BookQuery::create()->findPk(1);
  $book->delete();
  

3. 项目API使用文档

3.1 生成代码

• 生成模型：

  vendor/bin/propel-gen model
  

• 生成 SQL：

  vendor/bin/propel-gen sql
  

• 插入 SQL：

  vendor/bin/propel-gen insert-sql
  

3.2 数据库操作

• 查询：

  $books = BookQuery::create()->find();
  

• 插入：

  $book = new Book();
  $book->setTitle('New Book');
  $book->save();
  

• 更新：

  $book = BookQuery::create()->findPk(1);
  $book->setTitle('Updated Book');
  $book->save();
  

• 删除：

  $book = BookQuery::create()->findPk(1);
  $book->delete();
  

4. 项目安装方式

4.1 使用 Composer 安装

composer require propel/propel1

4.2 手动安装

1. 下载 Propel 源码。
2. 将源码放置在项目目录中。
3. 配置 autoload.php 文件，确保 Propel 类可以被正确加载。

通过以上步骤，您可以顺利安装并使用 Propel ORM 进行数据库操作。