使用php-xbase向.dbf追加记录时.fpt备注文件消失问题

在PHP环境中使用hasumi/php-xbase库向.dbf文件追加记录时，每次执行追加操作后，存储memo备注数据的.fpt文件会直接消失。操作全程无报错抛出，且已确认存储备注的itemdesc字段已正确注册为memo类型。
复现代码如下：

use XBase\Enum\FieldType;
use XBase\Enum\TableType;
use XBase\Header\Column;
use XBase\Header\HeaderFactory;
use XBase\TableCreator;
use XBase\TableEditor;
use XBase\TableReader;
use XBase\Column\ColumnInterface;

$table_ed = new TableEditor('file.dbf',['columns' =>['pk','itemdesc']]);
$record = $table_ed->appendRecord()
        ->set("pk", 11111)
        ->set("itemdesc","");
$table_ed->writeRecord($record);
$table_ed->save()->close();

该问题属于配置遗漏或版本bug导致的逻辑异常：

• 实例化TableEditor时未显式开启memo文件支持，库默认以无备注模式打开表文件，save操作时不会关联读写.fpt文件，旧版本库还会在重写dbf时清理未被引用的同名fpt文件。
• 若创建dbf表时未指定带memo支持的表类型，即使字段设置为memo类型，库也不会维护对应的fpt文件。
• 1.2.0以下版本的库存在空memo值写入逻辑bug，会误判fpt文件无有效内容直接删除。

• 实例化TableEditor时显式传入memo配置项，强制开启备注文件关联读写，后续追加记录、写入、保存关闭的逻辑不需要调整：

// 修正后的实例化代码
$table_ed = new TableEditor('file.dbf',[
    'columns' => ['pk','itemdesc'],
    'memo' => true // 开启fpt文件同步读写
]);

• 若为新建表场景，创建时必须指定支持memo的表类型，禁止使用无memo支持的表类型创建带memo字段的表，示例：

use XBase\Enum\TableType;
$options = [
    'type' => TableType::DBASE_III_PLUS_MEMO, // 可根据业务需求选择VFP_MEMO等其他支持备注的表类型
    'columns' => [
        // 字段定义
    ]
];

• 排查目录权限：确保PHP运行进程对dbf、fpt文件所在目录有完整读写权限，低版本库在fpt写入失败时会直接删除临时生成的fpt文件，不会抛出权限相关报错。
• 版本校验：将hasumi/php-xbase库升级至1.2.0及以上稳定版本，规避空memo值写入时误删fpt文件的已知bug。

内容的提问来源于stack exchange，提问作者cp_bmwebdev