Stdlib: utf8_encode()/utf8_decode() — scalar-to-string coercion (ext/standard/basic_functions.c parity)

[PurHur]

Category

stdlib

Problem

utf8_encode() and utf8_decode() reject non-string operands with LogicException instead of coercing scalars like Zend.

php-src reference

• php/php-src ext/standard/basic_functions.c — PHP_FUNCTION(utf8_encode), PHP_FUNCTION(utf8_decode) (convert_to_string on argument Php stdlib specs implementation #1)

Repro

Maintainer script: test/repro-maintainer/utf8_encode_scalar.php

HARNESS_DOCKER_RUN_OPTS='--memory=8g --cpus=2' ./script/docker-exec.sh -- bash -lc '
  source script/php-env.sh
  php test/repro-maintainer/utf8_encode_scalar.php
  php bin/vm.php test/repro-maintainer/utf8_encode_scalar.php
'

Mode	utf8_encode(65) / utf8_decode(195)
Zend	string(2) "65" / string(3) "195"
VM	LogicException — only supports strings

Scope

Area	Files
VM	ext/standard/utf8_encode.php, ext/standard/utf8_decode.php
Helpers	VmReflection::stringArg() or shared scalar coercion (see #4310 htmlspecialchars)
JIT	JitUtf8Latin1 — already uses jitString(); align VM

Done when

• utf8_encode() / utf8_decode() coerce int/float/bool to string before ISO-8859-1 ↔ UTF-8 transform
• Invalid types (array/object/resource) throw TypeError like Zend, not LogicException
• test/compliance/cases/stdlib/utf8_encode_decode_scalar.phpt passes VM + JIT

Verification

• Add test/compliance/cases/stdlib/utf8_encode_decode_scalar.phpt
• VM + JIT filter; AOT if lowering exists

[PurHur]

claim: PHP Compiler STD Lib — starting this run

[PurHur]

Merged via #7964.

Verification:

• php test/repro-maintainer/utf8_encode_scalar.php — Zend: scalar coercion + TypeError on array/object
• php bin/vm.php test/repro-maintainer/utf8_encode_scalar.php — same
• php bin/jit.php test/repro-maintainer/utf8_encode_scalar.php — same
• vendor/bin/phpunit --filter utf8_encode_decode_scalar — OK (4 tests, 8 assertions) VM + JIT scalar + AOT

Change: utf8_decode() now uses VmString::coerceStringBuiltinArg / JitStringBuiltinArg (php-src ext/standard/basic_functions.c).