dBase や FoxPro などのdbfデータベースを処理するためのシンプルなライブラリ。これは、Erwin Kooi によって書かれた 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 ;
}
DB 内のデータが 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 ファイル構造