db-data.php library

Path in the Gestor bibliotecas/db-data.php

The default part limit is 80 MiB including JSON framing. A record larger than the limit throws; records are never split. Small tables stay monolithic. Readers validate sequence, bytes, SHA-256 and record totals before returning data. Do not deploy a partial table: synchronization, recovery and ZIP packaging share this reader. The writer preserves input order; callers can use db_data_order_rows first. It still returns all records in memory, so partitioning limits file size rather than guaranteeing constant memory.

• db_data_base: Validates the table name and builds the PascalCaseData prefix.

• db_data_order_rows: Sorts by the column list, preserving exporter-defined order.

• db_data_locked: Shared/exclusive directory lock released in finally.

• db_data_json: Validates JSON and optional record lists; invalid input throws.

• db_data_manifest_unlocked: Validates manifest and all parts; caller already holds the lock.

• db_data_table_manifest: Returns a validated manifest or null when absent.

• db_data_read_table: Reads all parts or monolithic/legacy format; parts without a manifest throw.

• db_data_list_tables: Enumerates tables from monolithic names and manifests.

• db_data_table_files: Returns only validated complete-table files.

• db_data_zip_add_tables: Adds all parts and manifests to ZIP; failed addition throws.

• db_data_table_checksum: Keeps the historical key; monolithic uses md5_file, parts use MD5 of metadata.

• db_data_stage_write: Checks bytes written; retries up to five times.

• db_data_publish: Publishes by rename, with up to five attempts.

• db_data_atomic_write: Does not rewrite identical content; uses temporary file and rename for changes.

• db_data_write_table: Keeps whole records, publishes parts before manifest and removes obsolete format.

Generated function reference

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