array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.dba-popen.php', 1 => 'dba_popen', 2 => 'Abre o banco de dados de forma persistente', ), 'up' => array ( 0 => 'ref.dba.php', 1 => 'Funções de DBA', ), 'prev' => array ( 0 => 'function.dba-optimize.php', 1 => 'dba_optimize', ), 'next' => array ( 0 => 'function.dba-replace.php', 1 => 'dba_replace', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/dba/functions/dba-popen.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

dba_popen

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

dba_popen — Abre o banco de dados de forma persistente

Descrição

dba_popen(
    string $path,
    string $mode,
    ?string $handler = null,
    int $permission = 0644,
    int $map_size = 0,
    ?int $flags = null
): Dba\Connection|false

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.

Parâmetros

path
Normalmente 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_size
Parâ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.

Valor Retornado

Retorna uma instância de Dba\Connection em caso de sucesso ou false em caso de falha.

Erros/Exceções

false é retornado e um erro de nível E_WARNING é emitido quando handler for null mas não houver manipulador padrão.

Registro de Alterações

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.

Veja Também