feat: Improve PHP parity tests and verify 6 more functions (#528)

- Improve PHP parity test handler:
  - Add support for JS single-quoted strings with escape sequences (\n, \t, \r)
  - Add Unicode escape sequence conversion (\uXXXX → actual characters)
  - Fix double-quoted string skipping to avoid processing single quotes inside

- Add parity verification to 6 PHP functions:
  - wordwrap, strcoll, quoted_printable_encode, quoted_printable_decode
  - ctype_cntrl, ctype_space

PHP verification: 164 → 170 (53%)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: kvz

src/php/ctype/ctype_cntrl.js

@@ -1,10 +1,11 @@
 module.exports = function ctype_cntrl(text) {
-  //  discuss at: https://locutus.io/php/ctype_cntrl/
-  // original by: Brett Zamir (https://brett-zamir.me)
-  //   example 1: ctype_cntrl('\u0020')
-  //   returns 1: false
-  //   example 2: ctype_cntrl('\u001F')
-  //   returns 2: true
+  //      discuss at: https://locutus.io/php/ctype_cntrl/
+  // parity verified: PHP 8.3
+  //     original by: Brett Zamir (https://brett-zamir.me)
+  //       example 1: ctype_cntrl('\u0020')
+  //       returns 1: false
+  //       example 2: ctype_cntrl('\u001F')
+  //       returns 2: true
 
   const setlocale = require('../strings/setlocale')
   if (typeof text !== 'string') {

src/php/ctype/ctype_space.js

@@ -1,8 +1,9 @@
 module.exports = function ctype_space(text) {
-  //  discuss at: https://locutus.io/php/ctype_space/
-  // original by: Brett Zamir (https://brett-zamir.me)
-  //   example 1: ctype_space('\t\n')
-  //   returns 1: true
+  //      discuss at: https://locutus.io/php/ctype_space/
+  // parity verified: PHP 8.3
+  //     original by: Brett Zamir (https://brett-zamir.me)
+  //       example 1: ctype_space('\t\n')
+  //       returns 1: true
 
   const setlocale = require('../strings/setlocale')
   if (typeof text !== 'string') {

src/php/strings/quoted_printable_decode.js

@@ -1,5 +1,6 @@
 module.exports = function quoted_printable_decode(str) {
   //       discuss at: https://locutus.io/php/quoted_printable_decode/
+  //  parity verified: PHP 8.3
   //      original by: Ole Vrijenhoek
   //      bugfixed by: Brett Zamir (https://brett-zamir.me)
   //      bugfixed by: Theriault (https://github.com/Theriault)

src/php/strings/quoted_printable_encode.js

@@ -1,14 +1,15 @@
 module.exports = function quoted_printable_encode(str) {
-  //  discuss at: https://locutus.io/php/quoted_printable_encode/
-  // original by: Theriault (https://github.com/Theriault)
-  // improved by: Brett Zamir (https://brett-zamir.me)
-  // improved by: Theriault (https://github.com/Theriault)
-  //   example 1: quoted_printable_encode('a=b=c')
-  //   returns 1: 'a=3Db=3Dc'
-  //   example 2: quoted_printable_encode('abc   \r\n123   \r\n')
-  //   returns 2: 'abc  =20\r\n123  =20\r\n'
-  //   example 3: quoted_printable_encode('0123456789012345678901234567890123456789012345678901234567890123456789012345')
-  //   returns 3: '012345678901234567890123456789012345678901234567890123456789012345678901234=\r\n5'
+  //      discuss at: https://locutus.io/php/quoted_printable_encode/
+  // parity verified: PHP 8.3
+  //     original by: Theriault (https://github.com/Theriault)
+  //     improved by: Brett Zamir (https://brett-zamir.me)
+  //     improved by: Theriault (https://github.com/Theriault)
+  //       example 1: quoted_printable_encode('a=b=c')
+  //       returns 1: 'a=3Db=3Dc'
+  //       example 2: quoted_printable_encode('abc   \r\n123   \r\n')
+  //       returns 2: 'abc  =20\r\n123  =20\r\n'
+  //       example 3: quoted_printable_encode('0123456789012345678901234567890123456789012345678901234567890123456789012345')
+  //       returns 3: '012345678901234567890123456789012345678901234567890123456789012345678901234=\r\n5'
 
   const hexChars = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F']
   const RFC2045Encode1IN = / \r\n|\r\n|[^!-<>-~ ]/gm

src/php/strings/strcoll.js

@@ -1,9 +1,10 @@
 module.exports = function strcoll(str1, str2) {
-  //  discuss at: https://locutus.io/php/strcoll/
-  // original by: Brett Zamir (https://brett-zamir.me)
-  // improved by: Brett Zamir (https://brett-zamir.me)
-  //   example 1: strcoll('a', 'b')
-  //   returns 1: -1
+  //      discuss at: https://locutus.io/php/strcoll/
+  // parity verified: PHP 8.3
+  //     original by: Brett Zamir (https://brett-zamir.me)
+  //     improved by: Brett Zamir (https://brett-zamir.me)
+  //       example 1: strcoll('a', 'b')
+  //       returns 1: -1
 
   const setlocale = require('../strings/setlocale')
 

src/php/strings/wordwrap.js

@@ -1,19 +1,20 @@
 module.exports = function wordwrap(str, intWidth, strBreak, cut) {
-  //  discuss at: https://locutus.io/php/wordwrap/
-  // original by: Jonas Raoni Soares Silva (https://www.jsfromhell.com)
-  // improved by: Nick Callen
-  // improved by: Kevin van Zonneveld (https://kvz.io)
-  // improved by: Sakimori
-  //  revised by: Jonas Raoni Soares Silva (https://www.jsfromhell.com)
-  // bugfixed by: Michael Grier
-  // bugfixed by: Feras ALHAEK
-  // improved by: Rafał Kukawski (https://kukawski.net)
-  //   example 1: wordwrap('Kevin van Zonneveld', 6, '|', true)
-  //   returns 1: 'Kevin|van|Zonnev|eld'
-  //   example 2: wordwrap('The quick brown fox jumped over the lazy dog.', 20, '<br />\n')
-  //   returns 2: 'The quick brown fox<br />\njumped over the lazy<br />\ndog.'
-  //   example 3: wordwrap('Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.')
-  //   returns 3: 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim\nveniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea\ncommodo consequat.'
+  //      discuss at: https://locutus.io/php/wordwrap/
+  // parity verified: PHP 8.3
+  //     original by: Jonas Raoni Soares Silva (https://www.jsfromhell.com)
+  //     improved by: Nick Callen
+  //     improved by: Kevin van Zonneveld (https://kvz.io)
+  //     improved by: Sakimori
+  //      revised by: Jonas Raoni Soares Silva (https://www.jsfromhell.com)
+  //     bugfixed by: Michael Grier
+  //     bugfixed by: Feras ALHAEK
+  //     improved by: Rafał Kukawski (https://kukawski.net)
+  //       example 1: wordwrap('Kevin van Zonneveld', 6, '|', true)
+  //       returns 1: 'Kevin|van|Zonnev|eld'
+  //       example 2: wordwrap('The quick brown fox jumped over the lazy dog.', 20, '<br />\n')
+  //       returns 2: 'The quick brown fox<br />\njumped over the lazy<br />\ndog.'
+  //       example 3: wordwrap('Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.')
+  //       returns 3: 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod\ntempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim\nveniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea\ncommodo consequat.'
 
   intWidth = arguments.length >= 2 ? +intWidth : 75
   strBreak = arguments.length >= 3 ? '' + strBreak : '\n'

test/parity/lib/languages/php.ts

@@ -185,6 +185,108 @@ function convertPropertyAccess(line: string): string {
     .join('')
 }
 
+/**
+ * Convert JS Unicode escape sequence to actual character
+ * \uXXXX -> actual Unicode character
+ */
+function convertUnicodeEscape(hex: string): string {
+  return String.fromCharCode(parseInt(hex, 16))
+}
+
+/**
+ * Convert JS single-quoted strings with escape sequences to PHP double-quoted strings
+ * In JS, 'hello\nworld' interprets \n as newline
+ * In PHP, 'hello\nworld' is literal backslash-n (no escape interpretation)
+ * So we need to convert to double quotes when escape sequences are present
+ *
+ * Also handles Unicode escapes like \uXXXX by converting to actual characters
+ */
+function convertJsStringsToPhp(code: string): string {
+  let result = ''
+  let i = 0
+
+  while (i < code.length) {
+    // Skip double-quoted strings (don't process them)
+    if (code[i] === '"') {
+      result += code[i]
+      i++
+      while (i < code.length && code[i] !== '"') {
+        if (code[i] === '\\' && i + 1 < code.length) {
+          result += code[i] + code[i + 1]
+          i += 2
+        } else {
+          result += code[i]
+          i++
+        }
+      }
+      if (i < code.length) {
+        result += code[i] // closing quote
+        i++
+      }
+      continue
+    }
+
+    // Check for single-quoted string
+    if (code[i] === "'") {
+      let str = ''
+      i++
+      let hasEscapeSequence = false
+      let hasUnicodeEscape = false
+
+      while (i < code.length) {
+        if (code[i] === '\\' && i + 1 < code.length) {
+          const nextChar = code[i + 1]
+          // Handle escaped single quote - don't end string
+          if (nextChar === "'") {
+            str += "\\'"
+            i += 2
+            continue
+          }
+          // Check for Unicode escape sequence \uXXXX
+          if (nextChar === 'u' && i + 5 < code.length) {
+            const hex = code.slice(i + 2, i + 6)
+            if (/^[0-9A-Fa-f]{4}$/.test(hex)) {
+              // Convert Unicode escape to actual character
+              str += convertUnicodeEscape(hex)
+              i += 6
+              hasUnicodeEscape = true
+              continue
+            }
+          }
+          // Check for common escape sequences that need double quotes in PHP
+          if ('nrtv0\\'.includes(nextChar)) {
+            hasEscapeSequence = true
+          }
+          str += code[i] + code[i + 1]
+          i += 2
+        } else if (code[i] === "'") {
+          // End of string
+          break
+        } else {
+          str += code[i]
+          i++
+        }
+      }
+      i++ // skip closing quote
+
+      // If the string has escape sequences, convert to double quotes
+      if (hasEscapeSequence || hasUnicodeEscape) {
+        // Escape any existing double quotes in content, and convert \' to just '
+        let escapedContent = str.replace(/(?<!\\)"/g, '\\"')
+        escapedContent = escapedContent.replace(/\\'/g, "'") // In double quotes, ' doesn't need escaping
+        result += '"' + escapedContent + '"'
+      } else {
+        result += "'" + str + "'"
+      }
+    } else {
+      result += code[i]
+      i++
+    }
+  }
+
+  return result
+}
+
 /**
  * Convert a single JS line to PHP
  */
@@ -200,6 +302,9 @@ function convertJsLineToPhp(line: string): string {
   // Strip trailing semicolons (we add them when building the full PHP)
   php = php.replace(/;+$/, '')
 
+  // Convert JS single-quoted strings with escapes to PHP double-quoted
+  php = convertJsStringsToPhp(php)
+
   php = php.replace(/^\s*(var|let|const)\s+/, '')
 
   // JS static method conversions to PHP equivalents