无法通过WSDLDocument.php生成含方法参数的XML（PHP SOAP）

看起来你的核心问题出在自定义的WSDLDocument.php生成器上——它目前仅实现了类级别的PHPDoc注释解析，没有遍历并处理Shop类中的方法及方法的注释信息。虽然你的SOAP服务端能正常响应请求（因为SoapServer可以基于类反射直接处理请求，不需要依赖WSDL），但WSDL生成器没有完成它本该做的方法/参数定义输出工作。

下面是具体的排查和解决步骤：

1. 检查WSDLDocument.php的核心实现 #

打开这个生成器文件，确认它是否包含了遍历类方法、解析方法PHPDoc的逻辑。一个合格的WSDL生成器应该利用PHP的反射API来获取方法信息，示例逻辑如下：

// WSDLDocument中应该具备的关键逻辑片段
$reflectionClass = new ReflectionClass($className);
// 解析类级注释
$classComment = $reflectionClass->getDocComment();

// 遍历所有公共方法（排除魔术方法）
foreach ($reflectionClass->getMethods(ReflectionMethod::IS_PUBLIC) as $method) {
    if ($method->isConstructor() || $method->isDestructor()) continue;
    
    // 获取方法的PHPDoc注释
    $methodComment = $method->getDocComment();
    // 获取方法参数列表
    $parameters = $method->getParameters();
    
    // 解析@param、@return等标签，生成WSDL对应的operation、message、types节点
    // ... 这里是生成WSDL方法定义的核心逻辑
}

如果你的WSDLDocument.php里没有这段逻辑，那它自然不会输出任何方法和参数的WSDL内容。

2. 确认方法的PHPDoc注释格式合规 #

你的getFamilyProducts方法注释看起来没问题，但要确保：

• 注释块是标准PHPDoc格式（以/**开头，*/结尾，每行以*开头）
• @param标签的类型和参数名没有拼写错误
• @return标签明确指定了返回值类型

3. 尝试将静态方法改为非静态 #

虽然SoapServer::setClass可以兼容静态方法，但部分自定义WSDL生成器对静态方法的支持不佳。你可以尝试把方法改为非静态：

public function getFamilyProducts($familyId){
    // 原方法逻辑保持不变
}

修改后重新生成WSDL，看看是否能识别到方法信息。

4. 手动补充WSDL内容（临时应急方案） #

如果暂时不想修改WSDLDocument.php，可以手动在生成的WSDL中补全方法和参数的定义。比如需要添加以下核心节点：

<types>
  <xsd:schema targetNamespace="http://localhost/Shop">
    <xsd:element name="getFamilyProducts">
      <xsd:complexType>
        <xsd:sequence>
          <xsd:element name="familyId" type="xsd:string"/>
        </xsd:sequence>
      </xsd:complexType>
    </xsd:element>
    <xsd:element name="getFamilyProductsResponse">
      <xsd:complexType>
        <xsd:sequence>
          <xsd:element name="return" type="xsd:string"/>
        </xsd:sequence>
      </xsd:complexType>
    </xsd:element>
  </xsd:schema>
</types>
<message name="getFamilyProductsRequest">
  <part name="parameters" element="tns:getFamilyProducts"/>
</message>
<message name="getFamilyProductsResponse">
  <part name="parameters" element="tns:getFamilyProductsResponse"/>
</message>
<portType name="ShopPortType">
  <operation name="getFamilyProducts">
    <input message="tns:getFamilyProductsRequest"/>
    <output message="tns:getFamilyProductsResponse"/>
  </operation>
</portType>

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