Merge branch 'main' into copilot/fix-search-replace-hyphen-issue

Author: swissspidy

.github/workflows/copilot-setup-steps.yml

@@ -17,17 +17,17 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v6
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
 
       - name: Check existence of composer.json file
         id: check_composer_file
-        uses: andstor/file-existence-action@v3
+        uses: andstor/file-existence-action@076e0072799f4942c8bc574a82233e1e4d13e9d6 # v3
         with:
           files: "composer.json"
 
       - name: Set up PHP environment
         if: steps.check_composer_file.outputs.files_exists == 'true'
-        uses: shivammathur/setup-php@v2
+        uses: shivammathur/setup-php@44454db4f0199b8b9685a5d763dc37cbf79108e1 # v2
         with:
           php-version: 'latest'
           ini-values: zend.assertions=1, error_reporting=-1, display_errors=On
@@ -38,7 +38,7 @@ jobs:
 
       - name: Install Composer dependencies & cache dependencies
         if: steps.check_composer_file.outputs.files_exists == 'true'
-        uses: ramsey/composer-install@v3
+        uses: ramsey/composer-install@3cf229dc2919194e9e36783941438d17239e8520 # v3
         env:
           COMPOSER_ROOT_VERSION: dev-${{ github.event.repository.default_branch }}
         with:

.github/workflows/issue-triage.yml

@@ -13,6 +13,13 @@ name: Issue and PR Triage
         required: false
         type: string
 
+permissions:
+  issues: write
+  pull-requests: write
+  actions: write
+  contents: read
+  models: read
+
 jobs:
   issue-triage:
     uses: wp-cli/.github/.github/workflows/reusable-issue-triage.yml@main

.github/workflows/regenerate-readme.yml

@@ -10,6 +10,10 @@ on:
       - "features/**"
       - "README.md"
 
+permissions:
+  contents: write
+  pull-requests: write
+
 jobs:
   regenerate-readme:
     uses: wp-cli/.github/.github/workflows/reusable-regenerate-readme.yml@main

.github/workflows/welcome-new-contributors.yml

@@ -7,6 +7,9 @@ on:
       - main
       - master
 
+permissions:
+  pull-requests: write
+
 jobs:
   welcome:
     uses: wp-cli/.github/.github/workflows/reusable-welcome-new-contributors.yml@main

.typos.toml

@@ -0,0 +1,6 @@
+[default]
+extend-ignore-re = [
+	"(?Rm)^.*(#|//)\\s*spellchecker:disable-line$",
+	"(?s)(#|//)\\s*spellchecker:off.*?\\n\\s*(#|//)\\s*spellchecker:on",
+	"(#|//)\\s*spellchecker:ignore-next-line\\n.*"
+]

README.md

@@ -82,8 +82,10 @@ change primary key values.
 		specify multiple columns.
 
 	[--precise]
-		Force the use of PHP (instead of SQL) which is more thorough,
-		but slower.
+		Force the use of PHP (instead of SQL) for all columns. By default, the command
+		uses fast SQL queries, but automatically switches to PHP for columns containing
+		serialized data. Use this flag to ensure PHP processes all columns, which is
+		slower but handles complex serialized data structures more reliably.
 
 	[--recurse-objects]
 		Enable recursing into objects to replace strings. Defaults to true;
@@ -150,6 +152,9 @@ change primary key values.
     # Search/replace string containing hyphens
     $ wp search-replace --old='--old-string' --new='new-string'
 
+    # Use precise mode for complex serialized data
+    $ wp search-replace 'oldurl.com' 'newurl.com' --precise
+
     # Bash script: Search/replace production to development url (multisite compatible)
     #!/bin/bash
     if $(wp --url=http://example.com core is-installed --network); then

src/Search_Replace_Command.php

@@ -191,8 +191,10 @@ class Search_Replace_Command extends WP_CLI_Command {
 	 * specify multiple columns.
 	 *
 	 * [--precise]
-	 * : Force the use of PHP (instead of SQL) which is more thorough,
-	 * but slower.
+	 * : Force the use of PHP (instead of SQL) for all columns. By default, the command
+	 * uses fast SQL queries, but automatically switches to PHP for columns containing
+	 * serialized data. Use this flag to ensure PHP processes all columns, which is
+	 * slower but handles complex serialized data structures more reliably.
 	 *
 	 * [--recurse-objects]
 	 * : Enable recursing into objects to replace strings. Defaults to true;
@@ -258,6 +260,9 @@ class Search_Replace_Command extends WP_CLI_Command {
 	 *
 	 *     # Search/replace string containing hyphens
 	 *     $ wp search-replace --old='--old-string' --new='new-string'
+   *
+	 *     # Use precise mode for complex serialized data
+	 *     $ wp search-replace 'oldurl.com' 'newurl.com' --precise
 	 *
 	 *     # Bash script: Search/replace production to development url (multisite compatible)
 	 *     #!/bin/bash