README

简单的WSDL到PHP类转换器。接受一个WSDL文件并输出可用的类文件。

使用MIT许可证。

公告：我们正在寻找一两名具有提交权限的共同维护者，以帮助推进该项目，审查pull请求并响应问题。如果您已为此项目做出贡献或在开源项目中积极参与，并且拥有GitHub个人资料以供审查，请联系@kasperg 表达您的兴趣。

新主要版本：3.0

wsdl2phpgenerator的新主要版本最近已发布：3.0。

这引入了对配置和生成代码的更改。这些更改使其更灵活，更容易包含在其他项目中，促进贡献并减少维护。

2.x用户应阅读3.0中的新功能概述。

贡献者

最初由 @walle 开发，并包括了来自 @vakopian、@statikbe、@ecolinet、@nuth、@chriskl、@RSully、@jrbasso、@dypa、@Lafriks、@SamMousa、@xstefanox、@garex、@honzap、@jk、@sheeep、@colinodell、@red-led、@ivol84、@wasinger、@devlead、@NoUseFreak、@HighOnMikey、@theHarvester、@fduch、@methodin、@nkm、@jongotlin、@yethee、@rindeal、@vtsao、@xoeoro、@lunetics、@peter-vanpoucke、@jabiinfante、@renatomefi 和 @kasperg 的错误修复和改进。

欢迎提交拉取请求。请阅读我们的贡献指南。

邮件列表

项目有一个邮件列表，地址为 https://groups.google.com/forum/#!forum/wsdl2phpgenerator

安装

将 wsdl2phpgenerator 添加到您的 Composer 项目

composer require wsdl2phpgenerator/wsdl2phpgenerator

项目也将作为 命令行应用程序 提供，可以作为 Phar 文件下载。

用法

要生成类，创建一个 Generator 实例，并将其传递一个 Config 实例。

$generator = new \Wsdl2PhpGenerator\Generator();
$generator->generate(
	new \Wsdl2PhpGenerator\Config(array(
        'inputFile' => 'input.wsdl',
        'outputDir' => '/tmp/output'
    ))
);

生成代码后，根据需要配置现有的自动加载器。生成的代码还包含一个简单的 autoload.php 文件，可以直接包含。这为生成的类注册了一个简单的自动加载器。

示例用法

以下示例将在单个过程中从 Web 服务生成代码，加载生成的类，调用 Web 服务并返回结果。

$generator = new \Wsdl2PhpGenerator\Generator();
$generator->generate(
	new \Wsdl2PhpGenerator\Config(array(
        'inputFile' => 'http://www.webservicex.net/CurrencyConvertor.asmx?WSDL',
        'outputDir' => '/tmp/CurrencyConverter'
    ))
);

require '/tmp/CurrencyConverter/autoload.php';

// A class will generated representing the service.
// It is named after the element in the WSDL and has a method for each operation.
$service = new \CurrencyConvertor();
$request = new \ConversionRate(\Currency::USD, \Currency::EUR);
$response = $service->ConversionRate($request);

echo $response->getConversionRateResult();

请注意，这不是推荐的用法。通常代码生成和 Web 服务调用将是两个独立的过程。

选项

生成器支持一系列可以在配置中设置的选项。

inputFile

生成类的WSDL路径或URL。

outputDir

存放生成的类的目录。如果该目录不存在，将会被创建。

namespaceName

用于生成的类的命名空间。如果没有设置，生成的类将没有命名空间。

示例用法

以下配置将CDYNE Weather网络服务的生成代码放置在CDyne\Weather命名空间下。

$generator = new \Wsdl2PhpGenerator\Generator();
$generator->generate(
    new \Wsdl2PhpGenerator\Config(array(
        'inputFile' => 'http://wsf.cdyne.com/WeatherWS/Weather.asmx?wsdl',
        'outputDir' => '/tmp/weather',
        'namespaceName' => 'CDyne\Weather'
    ))
);

classNames

要生成的类名列表或数组，以逗号分隔。WSDL中所有其他类将被忽略。

此选项已弃用，将在4.0.0版本中删除。请使用operationNames代替。

示例用法

以下配置将只从Amazon EC2网络服务生成AmazonEC2和CopyImageType类。

$generator = new \Wsdl2PhpGenerator\Generator();
$generator->generate(
    new \Wsdl2PhpGenerator\Config(array(
        'inputFile' => 'https://s3.amazonaws.com/ec2-downloads/2013-10-01.ec2.wsdl',
        'outputDir' => '/tmp/amazon',
        'classNames' => 'AmazonEC2, CopyImageType'
    ))
);

operationNames

要生成的服务操作的逗号分隔列表或数组。这将只生成所选操作所需的数据类型。生成的服务类将只包含所选操作。

示例用法

以下配置将为ReplaceRouteTableAssociation和RequestSpotInstances操作生成操作和类型。

$generator = new \Wsdl2PhpGenerator\Generator();
$generator->generate(
    new \Wsdl2PhpGenerator\Config(array(
        'inputFile' => 'https://s3.amazonaws.com/ec2-downloads/2013-10-01.ec2.wsdl',
        'outputDir' => '/tmp/amazon',
        'operationNames' => 'ReplaceRouteTableAssociation, RequestSpotInstances'
    ))
);

sharedTypes

如果启用，这将使所有具有相同标识符的类型使用相同的类，并且只生成一次。默认解决方案是在名称前添加编号以避免名称冲突。

constructorParamsDefaultToNull

如果启用，这将设置所有构造函数中所有参数的默认值为null。如果使用此选项，则必须使用访问器设置属性。

proxy

指定在访问WSDL和其他外部资源时使用的代理。应使用此选项而不是[PHP SoapClient支持的代理选项]（https://php.ac.cn/manual/en/soapclient.soapclient.php），因为wsdl2phpgenerator使用的信息比SOAP客户端更多。

支持以下格式

• 具有以下键的数组：host、port、login和password，与[PHP SoapClient支持的代理选项]（https://php.ac.cn/manual/en/soapclient.soapclient.php）匹配。
• 类似于URL的字符串

代理信息在访问WSDL以生成代码和后续对SOAP服务的请求时使用。

示例用法

以下配置将使用代理访问Google DoubleClick Ad Exchange Buyer SOAP API。

$generator = new \Wsdl2PhpGenerator\Generator();
$generator->generate(
    new \Wsdl2PhpGenerator\Config(array(
        'inputFile' => 'https://ads.google.com/apis/ads/publisher/v201306/ActivityService?wsdl',
        'outputDir' => '/tmp/amazon',
        'proxy' => 'tcp://user:secret@192.168.0.1:8080'
    ))
);

soapClientClass

用于生成服务的基类。这应该是一个PHP SoapClient的子类。

以下是可以使用的第三方SOAP客户端实现示例

• BeSimpleSoapClient
• ZendFramework2 SOAP组件
• soap-plus
• SoapClientEx

请注意，确保在代码生成和调用网络服务时基类可用是周围代码的责任。

示例用法

以下配置将使用BeSimple SOAP客户端作为基类。

$generator = new \Wsdl2PhpGenerator\Generator();
$generator->generate(
    new \Wsdl2PhpGenerator\Config(array(
        'inputFile' => 'input.wsdl',
        'outputDir' => '/tmp/output',
        'soapClientClass' => '\BeSimple\SoapClient\SoapClient'
    ))
);

soapClientOptions

要传递给SoapClient的配置选项数组。它们将在访问WSDL以生成代码和作为后续对SOAP服务的请求的默认值时使用。PHP文档有支持的选项列表。

可以通过使用更高级的SoapClient实现来扩展客户端的选项列表。

请注意，wsdl2phpgenerator 期望 features 选项包含 SOAP_SINGLE_ELEMENT_ARRAYS。这确保了即使序列只有一个元素，类型提示也是一致的。[查看更多](https://php.ac.cn/manual/en/soapclient.soapclient.php#73082) 如果在 soapClientOptions 中显式设置了 features 选项，则必须显式添加 SOAP_SINGLE_ELEMENT_ARRAYS。

示例用法

以下配置将启用基本身份验证并将连接超时设置为60秒。

$generator = new \Wsdl2PhpGenerator\Generator();
$generator->generate(
    new \Wsdl2PhpGenerator\Config(array(
        'inputFile' => 'input.wsdl',
        'outputDir' => '/tmp/output',
        'soapClientOptions' => array(
        	'authentication' => SOAP_AUTHENTICATION_BASIC,
        	'login' => 'username',
        	'password' => 'secret',
        	'connection_timeout' => 60
    ))
));

版本控制

本项目旨在使用语义版本控制。以下构成公共API

• \Wsdl2PhpGenerator\GeneratorInterface
• \Wsdl2PhpGenerator\ConfigInterface
• 生成的代码

对这些的向后不兼容更改意味着主版本号将增加。新特性和错误修复增加次要和补丁版本。