php dbf

База данных PHP

Простая библиотека для работы с базами данных dbf , такими как dBase и FoxPro. Это порт класса PHPXbase, написанный Эрвином Кои, обновленный до кода, совместимого с PSR-2, настроенный для повышения производительности и для решения некоторых проблем, которые были в исходном коде.

Установка

Вы можете установить его через Composer:

$ composer require totalcrm/php-dbf

Пример использования

Больше примеров в папке examle .

Чтение данных

 use TotalCRM  DBase  TableReader ;

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

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

Если данные в БД не в UTF-8, вы можете указать кодировку для преобразования данных:

 use TotalCRM  DBase  TableReader ;

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

Также можно читать заметки из специальных файлов. Просто убедитесь, что существует файл .fpt с тем же именем, что и у основной базы данных.

Производительность

Вы можете передать массив нужных вам столбцов конструктору, тогда если в вашей таблице есть столбцы, которые вы не используете, они не будут загружены. Таким образом, парсер может работать намного быстрее.

 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 ;
}

Если вы уже знаете тип столбца, вы также можете вызвать функцию, специфичную для этого типа, для этого поля, что также увеличивает скорость.

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

Редактирование данных

Чтобы открыть таблицу для редактирования, вам необходимо использовать объект TableEditor , как в этом примере:

 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 ();

Добавить новую запись

 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 ();

Удалить запись

 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 ();

Создание таблицы

Чтобы создать файл таблицы, вам необходимо использовать объект 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 

Поиск неисправностей

Я не эксперт по dBase и не знаю всех особенностей типов и версий полей, поэтому библиотека может не справиться с некоторыми ситуациями. Если вы обнаружите ошибку, откройте проблему и пришлите мне образец таблицы, чтобы я мог воспроизвести вашу проблему и постараюсь помочь.

Полезные ссылки

Описание формата файла Xbase

Структура файла для dBASE 7

СТРУКТУРА ФАЙЛОВ DBF И DBT/FPT