php dbf

Base de dados PHP

Uma biblioteca simples para lidar com bancos de dados dbf como dBase e FoxPro. É uma versão da classe PHPXbase escrita por Erwin Kooi, atualizada para um código compatível com PSR-2 e ajustada para desempenho e para resolver alguns problemas que o código original tinha.

Instalação

Você pode instalá-lo através do Composer:

$ composer require totalcrm/php-dbf

Uso de amostra

Mais amostras na pasta de examle .

Lendo dados

 use TotalCRM  DBase  TableReader ;

$ table = new TableReader ( ' test.dbf ' );

while ( $ record = $ table -> nextRecord ()) {
    echo $ record -> get ( ' my_column ' );
    //or
    echo $ record -> my_column ;
}

Se os dados no banco de dados não estiverem em UTF-8, você poderá especificar um conjunto de caracteres para converter os dados:

 use TotalCRM  DBase  TableReader ;

$ table = new TableReader (
    ' test.dbf ' ,
    [
        ' encoding ' => ' cp1251 '
    ]
);

Também é possível ler Memos de arquivos dedicados. Apenas certifique-se de que exista um arquivo .fpt com o mesmo nome do banco de dados principal.

Desempenho

Você pode passar uma matriz das colunas necessárias para o construtor e, se sua tabela tiver colunas que você não usa, elas não serão carregadas. Dessa forma, o analisador pode rodar muito mais rápido.

 use TotalCRM  DBase  TableReader ;

$ table = new TableReader (
    ' test.dbf ' , 
    [
        ' columns ' => [ ' my_column ' , ' another_column ' ]
    ]
);

while ( $ record = $ table -> nextRecord ()) {
    echo $ record -> my_column ;
    echo $ record -> another_column ;
}

Se você já conhece o tipo de coluna, também pode chamar a função específica do tipo para esse campo, o que também aumenta a velocidade.

 while ( $ record = $ table -> nextRecord ()) {
    echo $ record -> get ( ' my_column ' );
    echo $ record -> get ( ' another_column ' );
}

Editando Dados

Para abrir uma tabela para edição, é necessário utilizar um objeto TableEditor , como neste exemplo:

 use TotalCRM  DBase  TableEditor ;

$ table = new TableEditor ( ' test.dbf ' );

for ( $ i = 0 ; $ i < 10 ; $ i ++) {
    $ record = $ table -> nextRecord ();
    
    $ record -> set ( ' field ' , ' string ' );
    //or
    $ record -> field = ' string ' ;

    $ table -> writeRecord ();
}

$ table
    -> save ()
    -> close ();

Adicionar novo registro

 use TotalCRM  DBase  TableEditor ;

$ table = new TableEditor (
    ' file.dbf ' ,
    [
        ' editMode ' => TableEditor:: EDIT_MODE_CLONE , //default
    ]
);
$ record = $ table -> appendRecord ();
$ record -> set ( ' name ' , ' test name ' );
$ record -> set ( ' age ' , 20 );

$ table
    -> writeRecord ()
    -> save ()
    -> close ();

Excluir registro

 use TotalCRM  DBase  TableEditor ;

$ table = new TableEditor ( ' file.dbf ' );

while ( $ record = $ table -> nextRecord ()) {
    if ( $ record -> get ( ' delete_this_row ' )) {
        $ table -> deleteRecord (); //mark record deleted
    }    
}

$ table
    -> pack () //remove deleted rows
    -> save () //save changes
    -> close ();

Criando tabela

Para criar um arquivo de tabela você precisa usar o objeto TableCreator .

 use TotalCRM  DBase  Enum  FieldType ;
use TotalCRM  DBase  Enum  TableType ;
use TotalCRM  DBase  Header  Column ;
use TotalCRM  DBase  Header  HeaderFactory ;
use TotalCRM  DBase  TableCreator ;
use TotalCRM  DBase  TableEditor ;

// you can specify any other database version from TableType
$ header = HeaderFactory:: create (TableType:: DBASE_III_PLUS_MEMO );
$ filepath = ' /path/to/new/file.dbf ' ;

$ tableCreator = new TableCreator ( $ filepath , $ header );
$ tableCreator
    -> addColumn ( new Column ([
        ' name '   => ' name ' ,
        ' type '   => FieldType:: CHAR ,
        ' length ' => 20 ,
    ]))
    -> addColumn ( new Column ([
        ' name '   => ' birthday ' ,
        ' type '   => FieldType:: DATE ,
    ]))
    -> addColumn ( new Column ([
        ' name '   => ' is_man ' ,
        ' type '   => FieldType:: LOGICAL ,
    ]))
    -> addColumn ( new Column ([
        ' name '   => ' bio ' ,
        ' type '   => FieldType:: MEMO ,
    ]))
    -> addColumn ( new Column ([
        ' name '         => ' money ' ,
        ' type '         => FieldType:: NUMERIC ,
        ' length '       => 20 ,
        ' decimalCount ' => 4 ,
    ]))
    -> addColumn ( new Column ([
        ' name '   => ' image ' ,
        ' type '   => FieldType:: MEMO ,
    ]))
    -> save (); //creates file

$ table = new TableEditor ( $ filepath );
//... add records 

Solução de problemas

Não sou especialista em dBase e não conheço todas as especificidades dos tipos e versões dos campos, portanto a lib pode não conseguir lidar com algumas situações. Se você encontrar um erro, abra um problema e envie-me uma tabela de exemplo onde posso reproduzir seu problema e tentarei ajudar.

Links úteis

Descrição do formato de arquivo Xbase

Estrutura de arquivo para dBASE 7

ESTRUTURA DE ARQUIVOS DBF E DBT/FPT