Summary

Implements #164 — fine-grained control over what enters the diff comparison across four dimensions.

What's New

Table filtering

• tables (+ --tables CLI flag) — include list: only diff tables matching these names/globs
• tablesToIgnore (+ --ignore-tables CLI flag) — exclude list: skip tables entirely (now supports glob patterns)
• tablesDataToIgnore — exclude from data diff only; schema is still compared
• Priority: include list narrows first → exclude list narrows further

Column filtering

• fieldsToIgnore — per-table column exclusion. Keys now support glob patterns (wp_*, audit_?), so one rule can cover multiple tables.

Row filtering

• rowsToIgnore — per-table list of { column, pattern } rules. Rows where column matches the regex pattern are skipped from the data diff.

Scope override

• tableScope — override diff scope per table to schema, data, or all.

All list values support glob patterns: * (any chars), ? (single char).

Implementation

• New TableFilter utility class (src/Params/TableFilter.php) — centralises all filtering logic, stateless, glob-aware, fully unit tested.
• Six new params added to DefaultParams and parsed from config/CLI.
• DBSchema and DBData updated to use glob-aware TableFilter::filterTables().
• TableSchema, LocalTableData, DistTableData, ArrayDiff updated to use TableFilter::getFieldsToIgnore() (now glob-aware for keys).
• StreamingMergeDiff, LocalTableData, TableData updated to apply rowsToIgnore filtering.

Tests

• 40+ new unit tests in tests/Unit/TableFilterTest.php covering all filtering paths: include/exclude combination, glob matching, field resolution, row rule matching, regex edge cases.
• Fixed StreamingMergeDiffTest — added ParamsFactory setup so row-filter code path is safe to call in tests.
• All 563 tests pass (946 assertions).

Configuration example

# Only diff these tables (globs supported)
tables:
  - users
  - orders
  - wp_*

tablesToIgnore:
  - cache_*

tablesDataToIgnore:
  - audit_log

fieldsToIgnore:
  users:
    - updated_at
  wp_*:
    - ID

rowsToIgnore:
  wp_options:
    - { column: option_name, pattern: "_transient_.*" }

tableScope:
  audit_log: schema

CLI

dbdiff server1.db1:server2.db2 --tables=users,orders,wp_* --ignore-tables=cache_*