[PHP] Rewrite URLs in live databases with resumable record cursors

[adamziel]

Adds db-rewrite-urls to rewrite URL-bearing values in a live MySQL or SQLite database without exporting or parsing SQL.

DatabaseUrlRewriteProcessor owns the DatabaseRowsReader introduced in #606, receives structured records directly, and performs one bounded record step at a time. Changed records use primary-key-scoped prepared UPDATE statements with positional bindings. No table lock or lifecycle-long transaction is taken.

The positional Reprint API URL is optional, and this command does not use --fs-root. Omitted database options fall back to the target recorded by db-apply when available.

Examples

reprint db-rewrite-urls --state-dir=./state \
  --rewrite-url https://old.example https://new.example

reprint db-rewrite-urls --state-dir=./state \
  --target-engine=sqlite --target-sqlite-path=./wordpress.sqlite \
  --rewrite-url https://old.example https://new.example

Resume semantics

Progress is saved after each record decision. SIGINT or SIGTERM stops after the active step and exits with status 2; rerun the command to resume. Completed records are not scanned again. An update interrupted before its cursor is saved may be read again, but the already-rewritten value produces no second update.

A non-empty table without a primary key stops the command. Resume also rejects a changed target or URL mapping, and a concurrent change to the selected row stops rather than overwriting it.

Testing

The importer and MariaDB suites cover structured records, bound updates, identifiers, saved targets, primary keys, batch boundaries, and cursor resume. An E2E test sends SIGTERM mid-table, resumes in a new process, and confirms each content row is processed and updated once.

[github-actions]

Pull pipeline performance — large-directory

Site: large-directory · 2,000+ plus targeted file-transfer scenarios files · 10,000 posts · 25,000 postmeta · PHP 8.5.9

trunk baseline unavailable — showing PR numbers only.

Stage	Wall time	Resume attempts	Status	Details
playground-sqlite-db-pull	9.79 s	1	✓	condition=db-pull in PHP.wasm runtime=php.wasm 8.3 wp_mysql_parser=enabled mode=lexer native_lexer=verified native_token_stream=WP_MySQL_Native_Token_Stream native_token_count=18 native_parser=selected
playground-sqlite-db-apply	3.88 s	1	✓	condition=db-apply to SQLite in PHP.wasm runtime=php.wasm 8.3 wp_mysql_parser=enabled mode=parser native_lexer=verified native_token_stream=WP_MySQL_Native_Token_Stream native_token_count=18 native_parser=verified native_ast=WP_MySQL_Native_Parser_Node sqlite_driver_parser=verified
Total	13.67 s

_{Numbers carry runner noise; treat single-run deltas as directional, not authoritative.}

_{📈 Trunk performance history — commit-by-commit timeline.}