函数名:ibase_gen_id()
适用版本:PHP 4, PHP 5, PHP 7
用法:ibase_gen_id() 函数用于获取一个生成的 ID 值,该值是与指定的生成器相关联的。生成器是在创建数据库时定义的一个对象,用于生成唯一的 ID 值。
语法:ibase_gen_id ( resource $generator [, int $increment = 1 ] ) : mixed
参数:
- generator:一个指向生成器对象的 InterBase/ Firebird 连接的资源标识符。
- increment:可选参数,指定生成的 ID 值的增量,默认为 1。
返回值:返回生成的 ID 值,如果出错则返回 FALSE。
示例:
// 连接到数据库
$db = ibase_connect('localhost:/path/to/database.fdb', 'username', 'password');
// 定义一个生成器对象
$generator = 'gen_customer_id';
// 生成一个唯一的 ID 值
$id = ibase_gen_id($generator);
// 输出生成的 ID 值
echo "Generated ID: " . $id;
// 关闭数据库连接
ibase_close($db);
在上述示例中,我们首先使用 ibase_connect()
函数连接到数据库。然后,我们定义了一个生成器对象 $generator
,它是在创建数据库时定义的。接下来,我们使用 ibase_gen_id()
函数生成一个唯一的 ID 值,并将其存储在变量 $id
中。最后,我们通过 echo
语句输出生成的 ID 值。最后,使用 ibase_close()
函数关闭数据库连接。
请注意,ibase_gen_id()
函数需要与 InterBase/ Firebird 数据库一起使用,并且需要在数据库中定义生成器对象。生成器对象的创建和定义超出了本函数的范围,因此在使用该函数之前,请确保数据库中已经定义了适当的生成器对象。