如何让SWIG生成的PHP类方法带static修饰？重载构造函数问题

问题背景 #

需要将C代码转换为PHP，但遇到重载构造函数的处理问题。原始C代码如下：

enum Enum_Foo {
    Foo_A,
    Foo_B,
    Foo_C
};

enum Enum_Bar {
    Bar_A,
    Bar_B,
    Bar_C
};

class Creator
{
public:
    Creator();
    Creator(Enum_Foo);
    Creator(Enum_Bar);
};

SWIG对重载方法会报错，官方建议用%rename处理重载构造函数。以下是Python和PHP的不同处理表现：

Python中的处理方式 #

在Python.i中配置重命名规则：

%rename (CreatorFromBar) Creator::Creator(Enum_Bar);

生成的Python代码为全局函数，可直接调用：

def CreatorFromBar(in_enum_bar):
    val = _SomeNamespacePython.new_CreatorFromBar(in_enum_bar)
    return val

调用示例：

bar = Enum_Bar.Bar_A
creator = CreatorFromBar(bar)

PHP中的问题 #

在PHP.i中配置相同逻辑的重命名规则：

%rename (CreateFromBar) Creator::Creator(Enum_Bar);

但生成的PHP代码是类的非静态方法：

class Creator {
    ...
    function CreateFromBar($in_enum_bar_type) {
        ...
        return new Creator(new_CreateFromBar($in_enum_bar_type));
    }
    ...
}

这种情况下必须先创建一个无用的dummy实例才能调用该方法：

$enum_bar = Enum_Bar::Bar_A;
$dummy = new Creator();
$correct = $dummy->CreatorFromBar($enum_bar);

如果方法带有static修饰符，则可以直接通过类调用，无需创建实例：

$enum_bar = Enum_Bar::Bar_A;
$correct = Creator::CreatorFromBar($enum_bar);

核心问题 #

1. 能否让SWIG生成的PHP方法强制带上static修饰符？
2. 有无其他方式避免创建无用的dummy实例？

解决方案 #

1. 强制生成静态方法 #

使用SWIG的%feature("phpstatic")指令，标记目标方法为静态。修改PHP.i配置：

%rename (CreateFromBar) Creator::Creator(Enum_Bar);
%feature("phpstatic") Creator::CreateFromBar;

这样SWIG生成的PHP方法会自动添加static修饰符，直接通过类调用即可。

2. 其他避免dummy实例的方式 #

• 生成全局工厂函数：参考Python的处理方式，通过%feature("phpglobal")让重载构造函数生成全局函数。修改PHP.i：

  %rename (CreateCreatorFromBar) Creator::Creator(Enum_Bar);
  %feature("phpglobal") CreateCreatorFromBar;
  

  生成后可直接调用全局函数CreateCreatorFromBar($enum_bar)获取Creator实例，无需创建dummy对象。
• 手动添加C++静态工厂方法：在原C++代码中新增静态工厂方法，绕过重载构造函数的问题：

  class Creator
  {
  public:
      Creator();
      Creator(Enum_Foo);
      Creator(Enum_Bar);
      static Creator createFromBar(Enum_Bar bar) {
          return Creator(bar);
      }
  };
  

  通过SWIG导出该静态方法后，PHP中可直接调用Creator::createFromBar($enum_bar)获取实例，逻辑更直观。

内容的提问来源于stack exchange，提问作者Naum