PHPackages                             php-soap/wsdl - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. php-soap/wsdl

ActiveLibrary[Utility & Helpers](/categories/utility)

php-soap/wsdl
=============

Deals with WSDLs

1.19.0(1mo ago)173.5M—6.3%7[2 issues](https://github.com/php-soap/wsdl/issues)5MITPHPPHP ~8.4.0 || ~8.5.0CI passing

Since Jul 8Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/php-soap/wsdl)[ Packagist](https://packagist.org/packages/php-soap/wsdl)[ Fund](https://opencollective.com/php-soap)[ RSS](/packages/php-soap-wsdl/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (38)Versions (22)Used By (5)

WSDL
====

[](#wsdl)

This package provides tools and helpers for dealing with WSDLs.

Want to help out? 💚
===================

[](#want-to-help-out-)

- [Become a Sponsor](https://github.com/php-soap/.github/blob/main/HELPING_OUT.md#sponsor)
- [Let us do your implementation](https://github.com/php-soap/.github/blob/main/HELPING_OUT.md#let-us-do-your-implementation)
- [Contribute](https://github.com/php-soap/.github/blob/main/HELPING_OUT.md#contribute)
- [Help maintain these packages](https://github.com/php-soap/.github/blob/main/HELPING_OUT.md#maintain)

Want more information about the future of this project? Check out this list of the [next big projects](https://github.com/php-soap/.github/blob/main/PROJECTS.md) we'll be working on.

Installation
============

[](#installation)

```
composer require php-soap/wsdl
```

WSDL Loader
-----------

[](#wsdl-loader)

A WSDL loader is able to load the contents of a WSDL file.

### Psr18Loader

[](#psr18loader)

For loading WSDL's, you might want to use a PSR-18 client to do the hard HTTP work. You'll have to include the [php-soap/psr18-transport](https://github.com/php-soap/psr18-transport/#psr18loader) in order to use this loader:

```
composer require php-soap/psr18-transport
```

```
use Http\Client\Common\PluginClient;
use Soap\Psr18Transport\Wsdl\Psr18Loader;

$loader = Psr18Loader::createForClient(
    $wsdlClient = new PluginClient(
        $psr18Client,
        ...$middleware
    )
);

$contents = $loader('http://some.wsdl');
```

### StreamWrapperLoader

[](#streamwrapperloader)

Loads the content of a WSDL by using any of the enabled [stream wrappers](https://www.php.net/manual/en/wrappers.php). It can either be a file, http, ...

```
use Soap\Wsdl\Loader\StreamWrapperLoader;

$loader = new StreamWrapperLoader(
    stream_context_create([
        'http' => [
            'method' => 'GET',
            'header'=>"User-Agent: my loader\r\n",
        ],
    ])
);
$contents = $loader($wsdl);
```

### FlatteningLoader

[](#flatteningloader)

This loader can be used if your WSDL file contains WSDL or XSD imports. It will any other loader internally to load all the parts. The result of this loader is a completely flattened WSDL file which you can e.g. cache on your local filesystem.

```
use Soap\Wsdl\Loader\FlatteningLoader;
use Soap\Wsdl\Loader\StreamWrapperLoader;

$loader = new FlatteningLoader(new StreamWrapperLoader());

$contents = $loader($wsdl);
```

### CallbackLoader

[](#callbackloader)

This loader can be used if you want to have more control about how to load a WSDL. It can be used to decorate another loader, add debug statements, apply custom loading logic, ...

```
use Soap\Wsdl\Loader\CallbackLoader;

$loader = new CallbackLoader(static function (string $location) use ($loader, $style): string {
    $style->write('> Loading '.$location . '...');

    $result =  $loader($location);
    $style->writeln(' DONE!');

    return $result;
})

$contents = $loader($wsdl);
```

WSDL CLI Tools
--------------

[](#wsdl-cli-tools)

```
wsdl-tools 1.0.0

Available commands:
  completion  Dump the shell completion script
  flatten     Flatten a remote or local WSDL file into 1 file that contains all includes.
  help        Display help for a command
  list        List commands
  validate    Run validations a (flattened) WSDL file.

```

### Flattening

[](#flattening)

```
./bin/wsdl flatten 'https://your/?wsdl' out.wsdl

```

This command will download the provided WSDL location. If any imports are detected, it will download these as well. The final result is stored in a single WSDL file.

### Validating

[](#validating)

```
./bin/wsdl validate out.wsdl

```

This command performs some basic validations on the provided WSDL file. If your WSDL contains any imports, you'll have to flatten the WSDL into a single file first.

### Extensions

[](#extensions)

By installing additional packages from `php-soap`, additional commands will be added to the WSDL tools:

- [wsdl-reader](https://github.com/php-soap/wsdl-reader): Will install inspect commands that will give you a human-readable version of all information inside your WSDL.

### Custom WSDL Loader

[](#custom-wsdl-loader)

By default, all CLI tools use the StreamWrapperLoader. All CLI tools have a `--loader=file.php` option that can be used to apply a custom WSDL loader. This can be handy if your WSDL is located behind authentication or if you want to get control over the HTTP level.

Example custom PHP loader:

```