From 54c43dc69169d939933179534e66e035aa563b9a Mon Sep 17 00:00:00 2001
From: tianfenghan <rango@swoole.com>
Date: Thu, 12 Feb 2026 13:21:10 +0800
Subject: [PATCH] =?UTF-8?q?feat(php):=20=E6=94=AF=E6=8C=81=20PHP=20?=
 =?UTF-8?q?=E5=91=BD=E5=90=8D=E5=8F=82=E6=95=B0=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 实现命名参数解析和重排逻辑
- 添加函数定义参数信息获取功能
- 支持命名参数与位置参数混合使用
- 确保参数按正确顺序传递给原生函数
- 添加命名参数测试用例
- 提供命名参数使用示例
---
 examples/named_args.php   | 10 ++++++++++
 src/Php/CompilerBase.php  | 37 ++++++++++++++++++++++++++++---------
 tests/aot/named-args.phpt | 18 ++++++++++++++++++
 3 files changed, 56 insertions(+), 9 deletions(-)
 create mode 100644 examples/named_args.php
 create mode 100644 tests/aot/named-args.phpt

diff --git a/examples/named_args.php b/examples/named_args.php
new file mode 100644
index 00000000..d42bfbc9
--- /dev/null
+++ b/examples/named_args.php
@@ -0,0 +1,10 @@
+<?php
+function foo($a, $b, $c): void
+{
+    var_dump($a, $b, $c);
+}
+
+function main(): void
+{
+    foo(c: 3, a: 1, b: 2);
+}
diff --git a/src/Php/CompilerBase.php b/src/Php/CompilerBase.php
index 0cdd3046..d2defa67 100644
--- a/src/Php/CompilerBase.php
+++ b/src/Php/CompilerBase.php
@@ -1959,13 +1959,32 @@ class CompilerBase extends \PhpAot\Core\Translator
         return $call . '(' . $fn . ', {' . $this->parseCallArgs($expr->args, $name) . '})';
     }
 
-    protected function parseNativeCallArgs(array $args, string $nativeFunc): string
-    {
-        $list_args = [];
-        foreach ($args as $i => $arg) {
-            if ($arg->name !== null) {
-                $this->fatalError($arg, 'Named arguments are not supported');
+    protected function parseNativeCallArgs(array $callArgs, string $nativeFunc): string
+    {
+        $argList = [];
+        $functionDef = $this->functions[$nativeFunc];
+        $args = [];
+        $hasNamedArg = false;
+        // 对命名参数进行重排
+        foreach ($callArgs as $i => $arg) {
+            if ($arg->name) {
+                foreach($functionDef->argInfoList as $k => $argInfo) {
+                    if ($argInfo->name === $arg->name->name) {
+                        $args[$k] = $arg;
+                        $hasNamedArg = true;
+                        break;
+                    }
+                }
+            } else {
+                $args[$i] = $arg;
             }
+        }
+        // 对 key 进行排序，确保参数顺序正确
+        if ($hasNamedArg) {
+            ksort($args);
+        }
+
+        foreach ($args as $i => $arg) {
             $argInfo = $this->getArgInfo($arg, $nativeFunc, $i);
             if ($argInfo->variadic) {
                 $vargs = array_slice($args, $i);
@@ -1973,14 +1992,14 @@ class CompilerBase extends \PhpAot\Core\Translator
                 foreach ($vargs as $varg) {
                     $list_vargs[] = $this->getTypeConvertedArg($varg, $argInfo);
                 }
-                $list_args[] = '{' . implode(', ', $list_vargs) . '}';
+                $argList[] = '{' . implode(', ', $list_vargs) . '}';
                 break;
             } else {
-                $list_args[] = $this->getTypeConvertedArg($arg, $argInfo);
+                $argList[] = $this->getTypeConvertedArg($arg, $argInfo);
             }
         }
 
-        return implode(', ', $list_args);
+        return implode(', ', $argList);
     }
 
     protected function parseCallArgs(array $args, string $funcName = '', string $className = ''): string
diff --git a/tests/aot/named-args.phpt b/tests/aot/named-args.phpt
new file mode 100644
index 00000000..462eb618
--- /dev/null
+++ b/tests/aot/named-args.phpt
@@ -0,0 +1,18 @@
+--TEST--
+named args
+--FILE--
+<?php
+function foo($a, $b, $c): void
+{
+    var_dump($a, $b, $c);
+}
+
+function main(): void
+{
+    foo(c: 3, a: 1, b: 2);
+}
+?>
+--EXPECT--
+int(1)
+int(2)
+int(3)