PHPackages                             der-spiegel/ww-elvis-client - 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. [File &amp; Storage](/categories/file-storage)
4. /
5. der-spiegel/ww-elvis-client

Abandoned → [der-spiegel/ww-assets-client](/?search=der-spiegel%2Fww-assets-client)Library[File &amp; Storage](/categories/file-storage)

der-spiegel/ww-elvis-client
===========================

PHP client for the WoodWing Assets (formerly: Elvis DAM) system https://www.woodwing.com/en/products/woodwing-assets

v9.5.1(5mo ago)5373MITPHPPHP &gt;=8.4 &lt;8.6CI passing

Since Apr 27Pushed 4mo ago4 watchersCompare

[ Source](https://github.com/DerSpiegel/ww_assets_php_client)[ Packagist](https://packagist.org/packages/der-spiegel/ww-elvis-client)[ Docs](https://github.com/DerSpiegel/ww_assets_php_client)[ RSS](/packages/der-spiegel-ww-elvis-client/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (5)Versions (59)Used By (0)

A PHP client for WoodWing Assets
================================

[](#a-php-client-for-woodwing-assets)

[WoodWing Assets](https://www.woodwing.com/en/products/woodwing-assets) is a DAM (Digital Asset Management) system. This PHP client library uses its [REST API](https://helpcenter.woodwing.com/hc/en-us/sections/360008455892-APIs-REST).

This is not an official library supplied by the WoodWing vendor. It has been developed during the WoodWing Assets implementation at the German [SPIEGEL Gruppe](https://www.spiegelgruppe.de), 2019-2020.

Functionality
-------------

[](#functionality)

- [API login](https://helpcenter.woodwing.com/hc/en-us/articles/360041851192-Assets-Server-REST-API-API-login)
- [Search](https://helpcenter.woodwing.com/hc/en-us/articles/360041851432-Assets-Server-REST-API-search): `SearchRequest`
- [Browse](https://helpcenter.woodwing.com/hc/en-us/articles/360042268711-Assets-Server-REST-API-browse): `BrowseRequest`
- [Create](https://helpcenter.woodwing.com/hc/en-us/articles/360042268771-Assets-Server-REST-API-create): `CreateRequest`
- [Update](https://helpcenter.woodwing.com/hc/en-us/articles/360042268971-Assets-Server-REST-API-update-check-in): `UpdateRequest`
- [Update bulk](https://helpcenter.woodwing.com/hc/en-us/articles/360042268991-Assets-Server-REST-API-updatebulk): `UpdateBulkRequest`
- [Copy asset](https://helpcenter.woodwing.com/hc/en-us/articles/360042268731-Assets-Server-REST-API-copy): `CopyAssetRequest`
- [Move / rename](https://helpcenter.woodwing.com/hc/en-us/articles/360042268891-Assets-Server-REST-API-move-rename): `MoveRequest`
- [Remove](https://helpcenter.woodwing.com/hc/en-us/articles/360041851352-Assets-Server-REST-API-remove): `RemoveRequest`
- [Create relation](https://helpcenter.woodwing.com/hc/en-us/articles/360042268751-Assets-Server-REST-API-create-relation): `CreateRelationRequest`
- Create folder: `CreateFolderRequest`
- Get folder metadata: `GetFolderRequest`
- Update folder metadata: `UpdateFolderRequest`

Installation
------------

[](#installation)

Use [Composer](https://getcomposer.org/) to add this library your project’s composer.json file:

```
$ composer require der-spiegel/ww-assets-client

```

Quick test
----------

[](#quick-test)

Here’s how to do a quick test, starting from scratch with a new project (Docker required):

### Install dependencies using Composer

[](#install-dependencies-using-composer)

```
$ mkdir MyExample && cd MyExample
$ docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --volume ${COMPOSER_HOME:-$HOME/.composer}:/tmp \
  composer/composer require der-spiegel/ww-assets-client monolog/monolog

```

### Copy and edit the example script

[](#copy-and-edit-the-example-script)

`$ cp vendor/der-spiegel/ww-assets-client/UsageExample.php MyExample.php`

Edit your copy, setting the correct Assets URL, username (API user preferred) and password in this section:

```
$assetsConfig = AssetsConfig::create(
    'https://assets.example.com/', // Assets URL (without app/ or services/ postfix)
    'username',                    // Assets user name (API user preferred)
    'password'                     // That user's password
);
```

The example script performs a simple search across all assets (visible for that user) and returns the first 50 asset IDs – you can leave it as is for a first test:

```
$assetsClient = new AssetsClient($assetsConfig, $logger); // Create client

$request = new SearchRequest($assetsClient,               // Create search request
        q: '',                                            // Assets query
        metadataToReturn: ['']                            // Metadata fields to return
);

$response = $request();                                   // Perform search

foreach ($response->hits as $assetResponse) {             // Loop through results
    echo $assetResponse->id . "\n";                       // Access asset metadata
}
```

### Then run your copy

[](#then-run-your-copy)

```
$ docker run -it --rm --name assets-client-example \
  --volume "$PWD":/usr/src/myapp --workdir /usr/src/myapp \
  php:cli php MyExample.php

```

Development
-----------

[](#development)

See [Running tests](https://ww-elvis-php-client.readthedocs.io/en/latest/tests.html) for instructions on how to run unit and integration tests.

To regenerate the documentation in docs/\_build/html from the source files, run Sphinx:

```
$ docker run --rm --volume "$PWD":/usr/src/myapp --workdir /usr/src/myapp/docs sphinxdoc/sphinx:5.3.0 make html

```

Authors
-------

[](#authors)

- [Tim Strehle](https://github.com/tistre) -
- [Luís Ferreira](https://github.com/lcpaf)

License
-------

[](#license)

This library is licensed under the MIT License - see the `LICENSE` file for details.

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance74

Regular maintenance activity

Popularity17

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity87

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 99.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~36 days

Recently: every ~18 days

Total

57

Last Release

173d ago

Major Versions

v4.0.1 → v5.0.02023-05-25

v5.1.1 → v6.0.02024-01-10

v6.3.1 → v7.0.02024-05-16

v7.1.0 → v8.0.02024-11-13

v8.1.3 → v9.0.02025-02-19

PHP version history (11 changes)v1.0.0PHP ^7.4.0

v2.4.0PHP &gt;=7.4.0

v3.1.0PHP &gt;=7.4 &lt;8.1

v3.5.0PHP &gt;=7.4 &lt;8.2

v3.9.0PHP &gt;=8.1 &lt;8.2

v4.0.0PHP &gt;=8.1 &lt;8.3

v5.0.0PHP &gt;=8.2 &lt;8.3

v5.1.1PHP &gt;=8.2 &lt;8.4

v8.1.2PHP &gt;=8.2 &lt;8.5

v9.0.0PHP &gt;=8.4 &lt;8.5

v9.5.1PHP &gt;=8.4 &lt;8.6

### Community

Maintainers

![](https://www.gravatar.com/avatar/605e43ba9b62f4099a39fc882cc25491b7c64267e657271094fe88759631f6f8?d=identicon)[tistre](/maintainers/tistre)

---

Top Contributors

[![tistre](https://avatars.githubusercontent.com/u/3024544?v=4)](https://github.com/tistre "tistre (301 commits)")[![lfepropublish](https://avatars.githubusercontent.com/u/237246136?v=4)](https://github.com/lfepropublish "lfepropublish (1 commits)")

---

Tags

damphp

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/der-spiegel-ww-elvis-client/health.svg)

```
[![Health](https://phpackages.com/badges/der-spiegel-ww-elvis-client/health.svg)](https://phpackages.com/packages/der-spiegel-ww-elvis-client)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k511.3M2.2k](/packages/aws-aws-sdk-php)[google/cloud

Google Cloud Client Library

1.2k16.2M53](/packages/google-cloud)[stechstudio/laravel-zipstream

A fast and simple streaming zip file downloader for Laravel.

4633.7M3](/packages/stechstudio-laravel-zipstream)[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

188171.7k15](/packages/fof-upload)[azure-oss/storage

Azure Blob Storage PHP SDK

37985.0k5](/packages/azure-oss-storage)[dcblogdev/laravel-dropbox

A Laravel Dropbox v2 package

3263.0k](/packages/dcblogdev-laravel-dropbox)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
