(PHP 4, PHP 5, PHP 7, PHP 8)
dba_popen — Abre o banco de dados de forma persistente
$path,$mode,$handler = null,$permission = 0644,$map_size = 0,$flags = null
dba_popen() estabelece uma instância persistente do banco de dados
informado em path com o modo definido por mode usando o manipulador
especificado em handler.
pathNormalmente um caminho comum no seu sistema de arquivos.
mode
Define os modos: r para acesso de leitura, w para
acesso de leitura/gravação a um baco de dados já existente, c
para leitura/gravação e criação de banco de dados se ainda não existir,
e n para criar, truncar e acesso leitura/gravação.
handler
O nome do manipulador que
deve ser usado para acessar o arquivo definido em path. São passados
todos os parâmetros opcionais fornecidos para dba_popen() e
pode agir em nome deles. Se handler for null,
o manipulador padrão será invocado.
permission
Parâmetro opcional int que é passado ao driver. Tem o mesmo significado que
o parâmetro permissions de chmod() (*nix)
e o padrão é 0644.
Os drivers db1, db2, db3,
db4, dbm, gdbm,
ndbm e lmdb suportam o
parâmetro permission.
map_sizeParâmetro opcional int que é passado ao driver. Seu valor deve ser um múltiplo do tamanho da página do sistema operacional, ou zero, para usar o tamanho padrão do mapa.
Somente o driver lmdb aceita o parâmetro map_size.
flags
Permite passar opções aos drivers de banco de dados. Atualmente, suporte apenas ao driver LMDB com as opções
DBA_LMDB_USE_SUB_DIR e DBA_LMDB_NO_SUB_DIR.
Retorna uma instância de Dba\Connection em caso de sucesso ou false em caso de falha.
false é retornado e um erro de nível E_WARNING é emitido quando
handler for null mas não houver manipulador padrão.
| Versão | Descrição |
|---|---|
| 8.4.0 | Retorna agora uma instância de Dba\Connection; anteriormente, retornava um resource. |
| 8.2.0 |
flags foi adicionado.
|
| 8.1.0 |
handler agora pode ser nulo.
|
| 7.3.14, 7.4.2 |
O driver lmdb agora suporta o parâmetro adicional
map_size.
|