# dba_fetch

(PHP 4, PHP 5, PHP 7, PHP 8)

dba_fetch — 获取由键指定的数据

### 说明

dba_fetch(string|array `$key`, Dba\Connection `$dba`, int `$skip` = 0): string|false

自 8.3.0 起，已废弃重载签名：

dba_fetch(string|array `$key`, int `$skip`, resource `$dba`): string

dba_fetch() 从 `dba` 指定的数据库中获取由 `key` 指定的数据。

### 参数

`key`
  指定数据的键。

  > 注意: 在处理 inifiles 时，此函数接受数组作为键，其中索引 0 是组，索引 1 是值名称。参见： dba_key_split()。

`dba`
  一个由 dba_open() 或 dba_popen() 返回的 Dba\Connection 实例。
`skip`
  使用 cdb 数据库时要忽略的键值对数。 对于不支持同名多个键的所有其他数据库，此值将被忽略。

### 返回值

如果找到键/数据对，则返回关联的字符串，否则返回 `false`。

### 更新日志

版本 | 说明
--- | ---
8.4.0 | `dba` 参数现在接受 Dba\Connection 实例， 之前接受有效的 `dba` resource。
8.3.0 | 废弃了使用 `dba` 作为第三个参数调用 dba_fetch() 的方法。
8.2.0 | dba_fetch() 的可选参数 `skip` 现在在最后， 与 PHP 用户空间语义一致。以前的重载签名仍然被接受，但不推荐使用。

### 参见

- dba_exists() - 检查键是否存在
- dba_delete() - 删除由键指定的 DBA 条目
- dba_insert() - 插入条目
- dba_replace() - 替换或插入条目
- dba_key_split() - 将键的字符串表示分割为数组表示

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open