Biblioteca db-data.php

Caminho no Gestor bibliotecas/db-data.php

O limite padrão por parte é 80 MiB, incluindo a estrutura JSON. Um registro maior que o limite gera exceção; nunca é cortado. Tabelas pequenas continuam monolíticas. O leitor valida sequência, bytes, SHA-256 e totais antes de devolver dados. Não publique tabela parcial: sincronização, recuperação e ZIP usam o leitor compartilhado. O escritor preserva a ordem recebida; o chamador pode usar db_data_order_rows antes. A leitura ainda retorna todos os registros em memória: o fracionamento limita arquivos, não garante memória constante.

• db_data_base: Valida o nome da tabela e monta o prefixo PascalCaseData.

• db_data_order_rows: Ordena pela lista de colunas, preservando a ordem definida pelo exportador.

• db_data_locked: Trava compartilhada/exclusiva por diretório, liberada em finally.

• db_data_json: Valida JSON e, opcionalmente, lista de registros; inválido gera exceção.

• db_data_manifest_unlocked: Valida manifesto e todas as partes; chamador já segura a trava.

• db_data_table_manifest: Retorna manifesto validado ou null quando não existe.

• db_data_read_table: Lê todas as partes ou formato monolítico/legado; partes sem manifesto geram erro.

• db_data_list_tables: Enumera tabelas pelos nomes monolíticos e manifestos.

• db_data_table_files: Retorna somente arquivos de tabela inteira validada.

• db_data_zip_add_tables: Adiciona todas as partes e manifestos ao ZIP; falha de inclusão lança exceção.

• db_data_table_checksum: Mantém chave histórica; monolítico usa md5_file, partes usam MD5 dos metadados.

• db_data_stage_write: Confere quantidade escrita; tenta até cinco vezes.

• db_data_publish: Publica via rename, com até cinco tentativas.

• db_data_atomic_write: Não regrava conteúdo idêntico; temporário e troca para alterações.

• db_data_write_table: Mantém registros inteiros, publica partes antes do manifesto e remove formato obsoleto.

Referência extraída de funções

db_data_base(string $table): string

db_data_order_rows(array $rows, array $columns): array

db_data_locked(string $dir, int $mode, callable $operation)

db_data_json(string $path, bool $list = false): array

db_data_manifest_unlocked(string $table, string $dir): ?array

db_data_table_manifest(string $table, string $dir): ?array

db_data_read_table(string $table, string $dir): array

db_data_list_tables(string $dir): array

db_data_table_files(string $table, string $dir): array

db_data_zip_add_tables(ZipArchive $zip, string $dir): void

db_data_table_checksum(string $table, string $dir): string

db_data_stage_write(string $path, string $json): string

db_data_publish(string $tmp, string $path): void

db_data_atomic_write(string $path, string $json): void

db_data_write_table(string $table, array $rows, string $dir, array $options = []): array