Clarify JSON-escaped search-replace behavior

Author: yusufhay

README.md

@@ -22,6 +22,9 @@ multisite, this will just be the tables for the current site unless
 
 Search/replace intelligently handles PHP serialized data, and does not
 change primary key values.
+In non-regex mode, it also replaces JSON-escaped versions of the search
+string, such as `http:\/\/example.com` when searching for
+`http://example.com`.
 
 Tables without a primary key are skipped. To check whether a table has a
 primary key, run `wp db query 'DESCRIBE <table>'` and look for 'PRI' in
@@ -161,6 +164,9 @@ the Key column.
     # Use precise mode for complex serialized data
     $ wp search-replace 'oldurl.com' 'newurl.com' --precise
 
+    # Replace a URL in plain text and JSON-escaped data
+    $ wp search-replace 'https://example.com' 'https://example.test'
+
     # 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

@@ -139,6 +139,9 @@ class Search_Replace_Command extends WP_CLI_Command {
 	 *
 	 * Search/replace intelligently handles PHP serialized data, and does not
 	 * change primary key values.
+	 * In non-regex mode, it also replaces JSON-escaped versions of the search
+	 * string, such as `http:\/\/example.com` when searching for
+	 * `http://example.com`.
 	 *
 	 * Tables without a primary key are skipped. To check whether a table has a
 	 * primary key, run `wp db query 'DESCRIBE <table>'` and look for 'PRI' in
@@ -278,6 +281,9 @@ class Search_Replace_Command extends WP_CLI_Command {
 	 *     # Use precise mode for complex serialized data
 	 *     $ wp search-replace 'oldurl.com' 'newurl.com' --precise
 	 *
+	 *     # Replace a URL in plain text and JSON-escaped data
+	 *     $ wp search-replace 'https://example.com' 'https://example.test'
+	 *
 	 *     # Bash script: Search/replace production to development url (multisite compatible)
 	 *     #!/bin/bash
 	 *     if $(wp --url=http://example.com core is-installed --network); then