dba_insert

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

dba_insert — Insert entry

Description

function dba_insert(string|array $key, string $value, Dba\Connection $dba): bool

dba_insert() inserts the entry described with key and value into the database.

Parameters

key

The key of the entry to be inserted. If this key already exists in the database, this function fails. Use dba_replace() if you need to replace an existing key.

The inifile and cdb_make handlers are the exception: they add another entry with the same key and return true. With inifile, use the skip parameter of dba_fetch() to read it.

value

The value to be inserted.

dba

A Dba\Connection instance, returned by dba_open() or dba_popen().

Return Values

Returns true on success or false on failure.

Errors/Exceptions

If dba was opened read-only (mode r), an E_WARNING is raised and false is returned.

Changelog

Version Description
8.4.0 The dba parameter expects a Dba\Connection instance now; previously, a valid dba resource was expected.

See Also