PackageGenerator

包生成器

包生成器从任何 WSDL 生成 PHP SDK。

Package Generator 从任何 WSDL 生成 PHP SDK，因此您可以轻松使用任何 SOAP Web 服务，而无需了解 SOAP 的底层使用方式。

包生成器提供了许多选项来生成包，即使需要一些选项。该项目已经过许多 WSDL 的测试，目前在 Providr.IO 平台上使用。

包生成器生成 MANIFEST 中详细说明的文件。我们鼓励您阅读它以了解如何以及为何生成文件以及生成的类的使用方式。

安装

在一个项目中：

composer require wsdltophp/ PackageGenerator --dev

使用命令行：

$ wget https://phar.wsdltophp.com/wsdltophp-php7.phar
$ chmod +x wsdltophp-php7.phar
$ mv wsdltophp-php7.phar /usr/local/bin/wsdltophp

使用 Docker：

$ docker run --rm -it mikaelcom/wsdltophp:tagname

用法

有两种方法可以生成包（除了在项目中并通过命令行生成之外）：

• 独立（默认行为）：这意味着包是作为一个独立的项目生成的，具有自己的composer.json文件。生成结束时，生成包的根目录将包含composer.json 、 composer.lock文件和vendor目录。
• 不是独立的：这意味着该包是使用其自己的composer.json文件作为现有项目的一部分生成的。

standalone选项在独立部分中有详细介绍。

所有选项均在“选项”页面中详细说明。

在一个项目中：

PackageGeneratorConfigurationReaderGeneratorOptions; use WsdlToPhp PackageGenerator GeneratorGenerator; // Options definition: the configuration file parameter is optional $options = GeneratorOptions::instance(/* '/path/file.yml' */); $options ->setOrigin('http://developer.ebay.com/webservices/latest/ebaySvc.wsdl') ->setDestination('./MySdk') ->setComposerName('myproject/mysdk'); // Generator instantiation $generator = new Generator($options); // Package generation $generator->generatePackage();">

 use WsdlToPhp  PackageGenerator  ConfigurationReader  GeneratorOptions ;
use WsdlToPhp  PackageGenerator  Generator  Generator ;

// Options definition: the configuration file parameter is optional
$ options = GeneratorOptions:: instance ( /* '/path/file.yml' */ );
$ options
    -> setOrigin ( ' http://developer.ebay.com/webservices/latest/ebaySvc.wsdl ' )
    -> setDestination ( ' ./MySdk ' )
    -> setComposerName ( ' myproject/mysdk ' );
// Generator instantiation
$ generator = new Generator ( $ options );
// Package generation
$ generator -> generatePackage ();

使用命令行：

命令行是：

$ wsdltophp generate:package 
    --urlorpath= " http://developer.ebay.com/webservices/latest/ebaySvc.wsdl " 
    --destination= " ./MySdk " 
    --composer-name= " myproject/mysdk " 
    --force

为了查看所有使用的选项，只需删除--force参数即可。

使用 Docker：

如上面的命令行，只需使用之前的docker run命令行即可：

$ docker run --rm -it --volume $PWD :/var/www mikaelcom/wsdltophp:tagname generate:package 
    --urlorpath= " http://developer.ebay.com/webservices/latest/ebaySvc.wsdl " 
    --destination= " /var/www/MySdk " 
    --composer-name= " myproject/mysdk " 
    --force

为了查看所有使用的选项，只需删除--force参数即可。

版本

4.0

首次发布于 2021 年 4 月 3 日，一直维护到 6.0 版本发布。请阅读 UPGRADE-4.0 说明以确认主要更改。

3.0

首次发布于 2018 年 5 月 4 日，一直维护到 5.0 版本发布。请阅读 UPGRADE-3.0 说明以确认主要更改。

不再维护：即使版本 5 没有发布，也不会很快发布，维护 2 个版本，尤其是旧的 PHP 版本，非常耗时，对于仍在使用它的人来说很抱歉，因为他们会遇到最新版本中修复的问题。

2.0

自 2021 年 4 月 3 日起不再维护。

首次发布于 2016 年 4 月 29 日，一直维护到 4.0 版本发布。

1.0

不再维护了

测试

PackageGenerator $ phpunit --testsuite=model">

 # launch all tests
$ phpunit

# launch a testsuite: command, configuration, utils, model, container, parser, file, PackageGenerator
$ phpunit --testsuite=model

使用 Docker 进行测试

感谢 phpfarm 的 Docker 镜像，可以使用 cli 在任何PHP 版本下本地运行测试：

• PHP-7.4

首先，您需要创建容器，您可以通过从项目的根目录运行以下命令行来使用 docker-compose 来创建容器：

$ docker-compose up -d --build

然后，您将拥有一个名为package_generator容器，您可以在其中运行composer命令和php cli命令，例如：

 # install deps in container (using update ensure it does use the composer.lock file if there is any)
$ docker exec -it package_generator php-7.4 /usr/bin/composer update
# run tests in container
$ docker exec -it package_generator php-7.4 -dmemory_limit=-1 vendor/bin/phpunit

贡献

详细信息请参阅贡献。此外，代码文档位于 doc.wsdltophp.com。

制作人员

为该项目提供帮助的开发人员在composer.json 文件中被列为Contributor ，他们是：

• 格莫罗伊
• 塞拉姆
• 乔治·奥加尼斯扬
• 简·泽斯克
• 汤姆·莫特拉姆
• 卡蒂劳·米哈伊尔
• 亚历山大·图雷克
• 瓦莱里安·吉拉德
• 霍代克
• 安德烈亚斯·默勒
• 安德烈亚斯·金青格
• 亨德里克·鲁普
• 雅各布·德雷森
• 克利福德·维克里
• 阿诺·波因特
• 迪帕
• 特布勒斯
• 保罗·梅列霍夫
• 亚历克斯·克拉特基

常问问题

如果您有任何疑问，请阅读选项页面，了解生成包的可用选项。

还有一个常见问题解答，其中包含有关包生成及其使用的各种问题。

然后，如果您仍有疑问，请随时创建问题。

执照

麻省理工学院许可证 (MIT)。请参阅许可证文件以获取更多信息。