├── psalm-baseline.xml
├── src
    ├── Contract
    │   ├── Entity
    │   │   └── Document.php
    │   └── Service
    │   │   ├── ProofValidatorInterface.php
    │   │   ├── Configuration
    │   │       └── ConfigurationInterface.php
    │   │   ├── Clock
    │   │       └── ClockInterface.php
    │   │   ├── Utils
    │   │       └── DotNetTimeConverterInterface.php
    │   │   ├── DocumentLockManagerInterface.php
    │   │   ├── Discovery
    │   │       └── DiscoveryInterface.php
    │   │   ├── DocumentManagerInterface.php
    │   │   └── WopiInterface.php
    └── Service
    │   ├── Clock
    │       └── SystemClock.php
    │   ├── Utils
    │       └── DotNetTimeConverter.php
    │   ├── Configuration
    │       └── Configuration.php
    │   ├── DocumentLockManager.php
    │   ├── ProofValidator.php
    │   └── Discovery
    │       └── Discovery.php
├── LICENSE
├── composer.json
├── README.md
└── CHANGELOG.md


/psalm-baseline.xml:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <files psalm-version="4.9.2@00c062267d6e3229d91a1939992987e2d46f2393"/>
3 | 


--------------------------------------------------------------------------------
/src/Contract/Entity/Document.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Contract\Entity;
11 | 
12 | interface Document
13 | {
14 |     public function getWopiDocId(): string;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Contract/Service/ProofValidatorInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Contract\Service;
11 | 
12 | use Psr\Http\Message\RequestInterface;
13 | 
14 | interface ProofValidatorInterface
15 | {
16 |     public function isValid(RequestInterface $request): bool;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Contract/Service/Configuration/ConfigurationInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Contract\Service\Configuration;
11 | 
12 | use ArrayAccess;
13 | use JsonSerializable;
14 | 
15 | interface ConfigurationInterface extends ArrayAccess, JsonSerializable
16 | {
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Contract/Service/Clock/ClockInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Contract\Service\Clock;
11 | 
12 | use DateTimeImmutable;
13 | 
14 | interface ClockInterface
15 | {
16 |     /**
17 |      * Returns the current time as a DateTimeImmutable Object.
18 |      */
19 |     public function now(): DateTimeImmutable;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Contract/Service/Utils/DotNetTimeConverterInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Contract\Service\Utils;
11 | 
12 | use DateTimeInterface;
13 | 
14 | interface DotNetTimeConverterInterface
15 | {
16 |     public function toDatetime(string $ticks): DateTimeInterface;
17 | 
18 |     public function toTicks(DateTimeInterface $datetime): string;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Service/Clock/SystemClock.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Service\Clock;
11 | 
12 | use ChampsLibres\WopiLib\Contract\Service\Clock\ClockInterface;
13 | use DateTimeImmutable;
14 | 
15 | final class SystemClock implements ClockInterface
16 | {
17 |     public function now(): DateTimeImmutable
18 |     {
19 |         return new DateTimeImmutable();
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Contract/Service/DocumentLockManagerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Contract\Service;
11 | 
12 | use ChampsLibres\WopiLib\Contract\Entity\Document;
13 | use Psr\Http\Message\RequestInterface;
14 | 
15 | interface DocumentLockManagerInterface
16 | {
17 |     public function deleteLock(Document $document, RequestInterface $request): bool;
18 | 
19 |     public function getLock(Document $document, RequestInterface $request): string;
20 | 
21 |     public function hasLock(Document $document, RequestInterface $request): bool;
22 | 
23 |     public function setLock(Document $document, string $lockId, RequestInterface $request): bool;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Service/Utils/DotNetTimeConverter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Service\Utils;
11 | 
12 | use ChampsLibres\WopiLib\Contract\Service\Utils\DotNetTimeConverterInterface;
13 | use DateTimeImmutable;
14 | use DateTimeInterface;
15 | 
16 | final class DotNetTimeConverter implements DotNetTimeConverterInterface
17 | {
18 |     private const MULTIPLIER = 1e7;
19 | 
20 |     private const OFFSET = 621355968e9;
21 | 
22 |     public function toDatetime(string $ticks): DateTimeInterface
23 |     {
24 |         return DateTimeImmutable::createFromFormat(
25 |             'U',
26 |             (string) ((int) (((float) $ticks - self::OFFSET) / self::MULTIPLIER))
27 |         );
28 |     }
29 | 
30 |     public function toTicks(DateTimeInterface $datetime): string
31 |     {
32 |         return (string) (int) (($datetime->getTimestamp() * self::MULTIPLIER) + self::OFFSET);
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | 
 3 | Copyright (c) 2021-2022 Champs-Libres
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy of
 6 | this software and associated documentation files (the "Software"), to deal in
 7 | the Software without restriction, including without limitation the rights to
 8 | use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 9 | the Software, and to permit persons to whom the Software is furnished to do so,
10 | subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
17 | FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
18 | COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
19 | IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
20 | CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21 | 


--------------------------------------------------------------------------------
/src/Service/Configuration/Configuration.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Service\Configuration;
11 | 
12 | use ChampsLibres\WopiLib\Contract\Service\Configuration\ConfigurationInterface;
13 | 
14 | use function array_key_exists;
15 | 
16 | final class Configuration implements ConfigurationInterface
17 | {
18 |     private array $properties;
19 | 
20 |     public function __construct(array $properties)
21 |     {
22 |         $this->properties = $properties;
23 |     }
24 | 
25 |     public function jsonSerialize(): array
26 |     {
27 |         return $this->properties;
28 |     }
29 | 
30 |     public function offsetExists($offset): bool
31 |     {
32 |         return array_key_exists($offset, $this->properties);
33 |     }
34 | 
35 |     public function offsetGet($offset): mixed
36 |     {
37 |         return $this->properties[$offset];
38 |     }
39 | 
40 |     public function offsetSet($offset, $value): void
41 |     {
42 |         $this->properties[$offset] = $value;
43 |     }
44 | 
45 |     public function offsetUnset($offset): void
46 |     {
47 |         unset($this->properties[$offset]);
48 |     }
49 | }
50 | 


--------------------------------------------------------------------------------
/src/Contract/Service/Discovery/DiscoveryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Contract\Service\Discovery;
11 | 
12 | interface DiscoveryInterface
13 | {
14 |     /**
15 |      * @return array<string, string>
16 |      */
17 |     public function discoverAction(string $extension, string $name = 'view'): ?array;
18 | 
19 |     /**
20 |      * @return list<array<string, string>>
21 |      */
22 |     public function discoverExtension(string $extension): array;
23 | 
24 |     /**
25 |      * @return list<array<string, string>>
26 |      */
27 |     public function discoverMimeType(string $mimeType): array;
28 | 
29 |     /**
30 |      * @return array<string, mixed>
31 |      */
32 |     public function getCapabilities(): array;
33 | 
34 |     /**
35 |      * @return string The MSBLOB key is the "value" attribute in the proof-key tag in the hosting/capabilities xml
36 |      */
37 |     public function getPublicKey(): string;
38 | 
39 |     /**
40 |      * @return string The MSBLOB oldkey is the "oldvalue" attribute in the proof-key tag in the hosting/capabilities xml
41 |      */
42 |     public function getPublicKeyOld(): string;
43 | }
44 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "champs-libres/wopi-lib",
 3 |     "description": "A standard and framework agnostic PHP library to facilitate the implementation of the WOPI protocol.",
 4 |     "license": "MIT",
 5 |     "keywords": [
 6 |         "wopi"
 7 |     ],
 8 |     "homepage": "http://github.com/champs-libres/wopi-lib",
 9 |     "support": {
10 |         "issues": "https://github.com/champs-libres/wopi-lib/issues",
11 |         "source": "https://github.com/champs-libres/wopi-lib",
12 |         "docs": "https://github.com/champs-libres/wopi-lib"
13 |     },
14 |     "minimum-stability": "stable",
15 |     "prefer-stable": true,
16 |     "require": {
17 |         "php": ">= 7.4",
18 |         "ext-SimpleXML": "*",
19 |         "ext-json": "*",
20 |         "ext-openssl": "*",
21 |         "loophp/psr17": "^1.0",
22 |         "phpseclib/phpseclib": "^3.0",
23 |         "psr/cache": "^1.0 || ^2.0 || ^3.0",
24 |         "psr/http-client": "^1.0",
25 |         "psr/http-client-implementation": "^1",
26 |         "psr/http-factory": "^1.0.1",
27 |         "psr/http-factory-implementation": "^1",
28 |         "psr/http-message": "^1.0 || ^2.0",
29 |         "psr/http-message-implementation": "^1"
30 |     },
31 |     "require-dev": {
32 |         "drupol/php-conventions": "^5.0",
33 |         "friends-of-phpspec/phpspec-code-coverage": "^6.1",
34 |         "nyholm/psr7": "^1.4",
35 |         "phpspec/phpspec": "^7.1",
36 |         "symfony/http-client": "^5.3"
37 |     },
38 |     "autoload": {
39 |         "psr-4": {
40 |             "ChampsLibres\\WopiLib\\": "src/"
41 |         }
42 |     },
43 |     "config": {
44 |         "allow-plugins": {
45 |             "phpstan/extension-installer": true,
46 |             "phpro/grumphp": true,
47 |             "ergebnis/composer-normalize": true
48 |         }
49 |     },
50 |     "scripts": {
51 |         "changelog-unreleased": "docker-compose run auto_changelog -c .auto-changelog -u",
52 |         "changelog-version": "docker-compose run auto_changelog -c .auto-changelog -v",
53 |         "grumphp": "./vendor/bin/grumphp run",
54 |         "infection": "vendor/bin/infection run -j 2",
55 |         "phpspec": "vendor/bin/phpspec run -vvv --stop-on-failure"
56 |     }
57 | }
58 | 


--------------------------------------------------------------------------------
/src/Service/DocumentLockManager.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Service;
11 | 
12 | use ChampsLibres\WopiLib\Contract\Entity\Document;
13 | use ChampsLibres\WopiLib\Contract\Service\DocumentLockManagerInterface;
14 | use DateInterval;
15 | use Psr\Cache\CacheItemPoolInterface;
16 | use Psr\Http\Message\RequestInterface;
17 | 
18 | final class DocumentLockManager implements DocumentLockManagerInterface
19 | {
20 |     private CacheItemPoolInterface $cache;
21 | 
22 |     public function __construct(CacheItemPoolInterface $cache)
23 |     {
24 |         $this->cache = $cache;
25 |     }
26 | 
27 |     public function deleteLock(Document $document, RequestInterface $request): bool
28 |     {
29 |         // instead of deleting the lock, set a short expiration time
30 |         // it gives a chance for concurrent request which put the file content
31 |         // to meet an existing lock, and avoid them to be banned
32 |         $item = $this->cache->getItem($this->getCacheId($document->getWopiDocId()));
33 | 
34 |         $item->expiresAfter(new DateInterval('PT10S'));
35 | 
36 |         return $this->cache->save($item);
37 |     }
38 | 
39 |     public function getLock(Document $document, RequestInterface $request): string
40 |     {
41 |         return $this->cache->getItem($this->getCacheId($document->getWopiDocId()))->get();
42 |     }
43 | 
44 |     public function hasLock(Document $document, RequestInterface $request): bool
45 |     {
46 |         $item = $this->cache->getItem($this->getCacheId($document->getWopiDocId()));
47 | 
48 |         return $item->isHit();
49 |     }
50 | 
51 |     public function setLock(Document $document, string $lockId, RequestInterface $request): bool
52 |     {
53 |         $item = $this->cache->getItem($this->getCacheId($document->getWopiDocId()));
54 | 
55 |         $item->set($lockId);
56 |         // according to the specs, lock should last 30M
57 |         $item->expiresAfter(new DateInterval('PT31M'));
58 | 
59 |         return $this->cache->save($item);
60 |     }
61 | 
62 |     private function getCacheId(string $documentId): string
63 |     {
64 |         return sprintf('wopi_lib_lock_%s', $documentId);
65 |     }
66 | }
67 | 


--------------------------------------------------------------------------------
/src/Service/ProofValidator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Service;
11 | 
12 | use ChampsLibres\WopiLib\Contract\Service\Clock\ClockInterface;
13 | use ChampsLibres\WopiLib\Contract\Service\Discovery\DiscoveryInterface;
14 | use ChampsLibres\WopiLib\Contract\Service\ProofValidatorInterface;
15 | use ChampsLibres\WopiLib\Contract\Service\Utils\DotNetTimeConverterInterface;
16 | use ChampsLibres\WopiLib\Contract\Service\WopiInterface;
17 | use phpseclib3\Crypt\PublicKeyLoader;
18 | use phpseclib3\Crypt\RSA;
19 | use Psr\Http\Message\RequestInterface;
20 | use Throwable;
21 | 
22 | use function strlen;
23 | 
24 | final class ProofValidator implements ProofValidatorInterface
25 | {
26 |     private ClockInterface $clock;
27 | 
28 |     private DiscoveryInterface $discovery;
29 | 
30 |     private DotNetTimeConverterInterface $dotNetTimeConverter;
31 | 
32 |     public function __construct(
33 |         DiscoveryInterface $discovery,
34 |         ClockInterface $clock,
35 |         DotNetTimeConverterInterface $dotNetTimeConverter
36 |     ) {
37 |         $this->clock = $clock;
38 |         $this->discovery = $discovery;
39 |         $this->dotNetTimeConverter = $dotNetTimeConverter;
40 |     }
41 | 
42 |     public function isValid(RequestInterface $request): bool
43 |     {
44 |         $timestamp = $request->getHeaderLine(WopiInterface::HEADER_TIMESTAMP);
45 |         $date = $this->dotNetTimeConverter->toDatetime($timestamp);
46 | 
47 |         if (20 * 60 < ($this->clock->now()->getTimestamp() - $date->getTimestamp())) {
48 |             return false;
49 |         }
50 | 
51 |         $params = [];
52 |         parse_str($request->getUri()->getQuery(), $params);
53 |         $url = (string) $request->getUri();
54 | 
55 |         $expected = sprintf(
56 |             '%s%s%s%s%s%s',
57 |             pack('N', strlen($params['access_token'])),
58 |             $params['access_token'],
59 |             pack('N', strlen($url)),
60 |             strtoupper($url),
61 |             pack('N', 8),
62 |             pack('J', $timestamp)
63 |         );
64 | 
65 |         $key = $this->discovery->getPublicKey();
66 |         $keyOld = $this->discovery->getPublicKeyOld();
67 |         $xWopiProof = $request->getHeaderLine(WopiInterface::HEADER_PROOF);
68 |         $xWopiProofOld = $request->getHeaderLine(WopiInterface::HEADER_PROOF_OLD);
69 | 
70 |         return $this->verify($expected, $xWopiProof, $key)
71 |             || $this->verify($expected, $xWopiProofOld, $key)
72 |             || $this->verify($expected, $xWopiProof, $keyOld);
73 |     }
74 | 
75 |     /**
76 |      * @param string $key The key in MSBLOB format
77 |      */
78 |     private function verify(string $expected, string $proof, string $key): bool
79 |     {
80 |         try {
81 |             /** @var RSA $key */
82 |             $key = PublicKeyLoader::loadPublicKey($key);
83 |         } catch (Throwable $e) {
84 |             return false;
85 |         }
86 | 
87 |         return $key
88 |             ->withHash('sha256')
89 |             ->withPadding(RSA::SIGNATURE_RELAXED_PKCS1)
90 |             ->verify($expected, (string) base64_decode($proof, true));
91 |     }
92 | }
93 | 


--------------------------------------------------------------------------------
/src/Contract/Service/DocumentManagerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Contract\Service;
11 | 
12 | use ChampsLibres\WopiLib\Contract\Entity\Document;
13 | use DateTimeInterface;
14 | use Psr\Http\Message\StreamInterface;
15 | 
16 | interface DocumentManagerInterface
17 | {
18 |     /**
19 |      * Create a document
20 |      *
21 |      * @param array{basename: string, name: string, extension: string, content: string, size: numeric-string} $data
22 |      */
23 |     public function create(array $data): Document;
24 | 
25 |     /**
26 |      * Delete an existing lock attached to the document.
27 |      */
28 |     public function deleteLock(Document $document): void;
29 | 
30 |     public function findByDocumentFilename(string $documentFilename): ?Document;
31 | 
32 |     public function findByDocumentId(string $documentId): ?Document;
33 | 
34 |     public function getBasename(Document $document): string;
35 | 
36 |     public function getCreationDate(Document $document): DateTimeInterface;
37 | 
38 |     public function getDocumentId(Document $document): string;
39 | 
40 |     public function getLastModifiedDate(Document $document): DateTimeInterface;
41 | 
42 |     public function getLock(Document $document): string;
43 | 
44 |     /**
45 |      * Get a sha256 from the document's content.
46 |      *
47 |      * This is used for caching purpose in the client (see https://learn.microsoft.com/en-us/microsoft-365/cloud-storage-partner-program/rest/files/checkfileinfo/checkfileinfo-other#sha256)
48 |      *
49 |      * @param Document $document
50 |      * @return string
51 |      */
52 |     public function getSha256(Document $document): string;
53 | 
54 |     public function getSize(Document $document): int;
55 | 
56 |     /**
57 |      * Get version for this document.
58 |      *
59 |      * Note that CollaboraOnline does not rely on this document's version for detect change, but on
60 |      * @link{DocumentManagerInterface::getLastModifiedTime}
61 |      * @param Document $document
62 |      * @return string
63 |      */
64 |     public function getVersion(Document $document): string;
65 | 
66 |     public function hasLock(Document $document): bool;
67 | 
68 |     /**
69 |      * Write a lock on the document.
70 |      *
71 |      * The lock should last 30 minutes. It will be renewed by Wopi client if needed.
72 |      *
73 |      * @param Document $document
74 |      * @param string $lock
75 |      * @return void
76 |      */
77 |     public function lock(Document $document, string $lock): void;
78 | 
79 |     public function read(Document $document): StreamInterface;
80 | 
81 |     public function remove(Document $document): void;
82 | 
83 |     /**
84 |      * Write the content into the document.
85 |      *
86 |      * **Important**: any implementation should also ensure to update the version and timestamp
87 |      * of the Document, after writing data.
88 |      *
89 |      * @param Document $document
90 |      * @param array{content: string, size: int} $properties
91 |      * @return void
92 |      */
93 |     public function write(Document $document, array $properties = []): void;
94 | 
95 |     public function rename(Document $document, string $requestedName): void;
96 | }
97 | 


--------------------------------------------------------------------------------
/src/Contract/Service/WopiInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * For the full copyright and license information, please view
 5 |  * the LICENSE file that was distributed with this source code.
 6 |  */
 7 | 
 8 | declare(strict_types=1);
 9 | 
10 | namespace ChampsLibres\WopiLib\Contract\Service;
11 | 
12 | use Psr\Http\Message\RequestInterface;
13 | use Psr\Http\Message\ResponseInterface;
14 | 
15 | /**
16 |  * Interface WopiInterface.
17 |  *
18 |  * phpcs:disable Generic.Files.LineLength.TooLong
19 |  */
20 | interface WopiInterface
21 | {
22 |     public const HEADER_EDITORS = 'X-WOPI-Editors';
23 | 
24 |     public const HEADER_ITEM_VERSION = 'X-WOPI-ItemVersion';
25 | 
26 |     public const HEADER_LOCK = 'X-WOPI-Lock';
27 | 
28 |     public const HEADER_OLD_LOCK = 'X-WOPI-OldLock';
29 | 
30 |     public const HEADER_OVERRIDE = 'X-WOPI-Override';
31 | 
32 |     public const HEADER_OVERWRITE_RELATIVE_TARGET = 'X-WOPI-OverwriteRelativeTarget';
33 | 
34 |     public const HEADER_PROOF = 'X-WOPI-Proof';
35 | 
36 |     public const HEADER_PROOF_OLD = 'X-WOPI-ProofOld';
37 | 
38 |     public const HEADER_RELATIVE_TARGET = 'X-WOPI-RelativeTarget';
39 | 
40 |     public const HEADER_REQUESTED_NAME = 'X-WOPI-RequestedName';
41 | 
42 |     public const HEADER_SIZE = 'X-WOPI-Size';
43 | 
44 |     public const HEADER_SUGGESTED_TARGET = 'X-WOPI-SuggestedTarget';
45 | 
46 |     public const HEADER_TIMESTAMP = 'X-WOPI-Timestamp';
47 | 
48 |     public const HEADER_URL_TYPE = 'X-WOPI-UrlType';
49 | 
50 |     public const HEADER_VALID_RELATIVE_TARGET = 'X-WOPI-ValidRelativeTarget';
51 | 
52 |     public function checkFileInfo(string $fileId, string $accessToken, RequestInterface $request): ResponseInterface;
53 | 
54 |     public function deleteFile(string $fileId, string $accessToken, RequestInterface $request): ResponseInterface;
55 | 
56 |     public function enumerateAncestors(string $fileId, string $accessToken, RequestInterface $request): ResponseInterface;
57 | 
58 |     public function getFile(string $fileId, string $accessToken, RequestInterface $request): ResponseInterface;
59 | 
60 |     public function getLock(string $fileId, string $accessToken, RequestInterface $request): ResponseInterface;
61 | 
62 |     public function getShareUrl(string $fileId, string $accessToken, RequestInterface $request): ResponseInterface;
63 | 
64 |     public function lock(string $fileId, string $accessToken, string $xWopiLock, RequestInterface $request): ResponseInterface;
65 | 
66 |     public function putFile(string $fileId, string $accessToken, string $xWopiLock, string $xWopiEditors, RequestInterface $request): ResponseInterface;
67 | 
68 |     public function putRelativeFile(string $fileId, string $accessToken, ?string $suggestedTarget, ?string $relativeTarget, bool $overwriteRelativeTarget, int $size, RequestInterface $request): ResponseInterface;
69 | 
70 |     public function putUserInfo(string $fileId, string $accessToken, RequestInterface $request): ResponseInterface;
71 | 
72 |     public function refreshLock(string $fileId, string $accessToken, string $xWopiLock, RequestInterface $request): ResponseInterface;
73 | 
74 |     public function renameFile(string $fileId, string $accessToken, string $xWopiLock, string $xWopiRequestedName, RequestInterface $request): ResponseInterface;
75 | 
76 |     public function unlock(string $fileId, string $accessToken, string $xWopiLock, RequestInterface $request): ResponseInterface;
77 | 
78 |     public function unlockAndRelock(string $fileId, string $accessToken, string $xWopiLock, string $xWopiOldLock, RequestInterface $request): ResponseInterface;
79 | }
80 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | [![Latest Stable Version][latest stable version]][1]
  2 |  [![GitHub stars][github stars]][1]
  3 |  [![Total Downloads][total downloads]][1]
  4 |  [![GitHub Workflow Status][github workflow status]][2]
  5 |  [![Scrutinizer code quality][code quality]][3]
  6 |  [![Type Coverage][type coverage]][4]
  7 |  [![Code Coverage][code coverage]][3]
  8 |  [![License][license]][1]
  9 | 
 10 | # WOPI Lib
 11 | 
 12 | A standard and framework agnostic PHP library to facilitate the implementation
 13 | of the WOPI protocol.
 14 | 
 15 | ## Description
 16 | 
 17 | The **W**eb Application **O**pen **P**latform **I**nterface (WOPI) protocol let you
 18 | integrate Office for the web with your application. The WOPI protocol enables Office for
 19 | the web to access and change files that are stored in your service.
 20 | 
 21 | Office for the web platforms:
 22 | 
 23 | * [Collabora Office][46]
 24 | * [OnlyOffice][55]
 25 | * [Office 365][47]
 26 | 
 27 | ## Installation
 28 | 
 29 | ```composer require champs-libres/wopi-lib```
 30 | 
 31 | ## Usage
 32 | 
 33 | There are many different ways to store documents in an application. Therefore, this
 34 | library does not provide a specific implementation of the WOPI protocol described
 35 | through [the WOPI interface][49].
 36 | 
 37 | Thus, this library mostly provides abstractions and few service implementations.
 38 | 
 39 | It provides:
 40 | 
 41 | * A [Wopi interface][49] describing the WOPI protocol
 42 | * A [Discovery interface][52] and its implementation
 43 | * A [DocumentManager interface][56] describing a document manager
 44 | * A [DocumentLockManager interface][57] describing a document lock manager
 45 | * A [ProofValidator interface][58] its implementation
 46 | * A [DotNetTimeConverter interface][59] and its implementation
 47 | 
 48 | In order to be foster interoperability and be used across many different frameworks,
 49 | this library uses PSR7, PSR17, PSR18 and PSR12 conventions from the [PHP-FIG][53].
 50 | 
 51 | ### Symfony integration
 52 | 
 53 | There is already an implementation of the library in Symfony through the [champs-libres/wopi-bundle][54]
 54 | package.
 55 | 
 56 | ## Documentation
 57 | 
 58 | * [https://wopi.readthedocs.io/en/latest/](https://wopi.readthedocs.io/en/latest/)
 59 | 
 60 | ## Code quality, tests, benchmarks
 61 | 
 62 | Every time changes are introduced into the library, [Github][2] runs the
 63 | tests.
 64 | 
 65 | The library has tests written with [PHPSpec][35].
 66 | Feel free to check them out in the `spec` directory. Run `composer phpspec` to
 67 | trigger the tests.
 68 | 
 69 | Before each commit, some inspections are executed with [GrumPHP][36]; run
 70 | `composer grumphp` to check manually.
 71 | 
 72 | The quality of the tests is tested with [Infection][37] a PHP Mutation testing
 73 | framework, run `composer infection` to try it.
 74 | 
 75 | Static analyzers are also controlling the code. [PHPStan][38] and
 76 | [PSalm][39] are enabled to their maximum level.
 77 | 
 78 | ## Contributing
 79 | 
 80 | Feel free to contribute to this project by submitting pull requests on Github.
 81 | 
 82 | ## Changelog
 83 | 
 84 | See [CHANGELOG.md][43] for a changelog based on [git commits][44].
 85 | 
 86 | For more detailed changelogs, please check [the release changelogs][45].
 87 | 
 88 | [1]: https://packagist.org/packages/champs-libres/wopi-lib
 89 | [latest stable version]: https://img.shields.io/packagist/v/champs-libres/wopi-lib.svg?style=flat-square
 90 | [github stars]: https://img.shields.io/github/stars/champs-libres/wopi-lib.svg?style=flat-square
 91 | [total downloads]: https://img.shields.io/packagist/dt/champs-libres/wopi-lib.svg?style=flat-square
 92 | [github workflow status]: https://img.shields.io/github/workflow/status/champs-libres/wopi-lib/Unit%20tests?style=flat-square
 93 | [code quality]: https://img.shields.io/scrutinizer/quality/g/champs-libres/wopi-lib/master.svg?style=flat-square
 94 | [3]: https://scrutinizer-ci.com/g/champs-libres/wopi-lib/?branch=master
 95 | [type coverage]: https://img.shields.io/badge/dynamic/json?style=flat-square&color=color&label=Type%20coverage&query=message&url=https%3A%2F%2Fshepherd.dev%2Fgithub%2Fchamps-libres%2Fwopi-lib%2Fcoverage
 96 | [4]: https://shepherd.dev/github/champs-libres/wopi-lib
 97 | [code coverage]: https://img.shields.io/scrutinizer/coverage/g/champs-libres/wopi-lib/master.svg?style=flat-square
 98 | [license]: https://img.shields.io/packagist/l/champs-libres/wopi-lib.svg?style=flat-square
 99 | [34]: https://github.com/champs-libres/wopi-lib/issues
100 | [2]: https://github.com/champs-libres/wopi-lib/actions
101 | [35]: http://www.phpspec.net/
102 | [36]: https://github.com/phpro/grumphp
103 | [37]: https://github.com/infection/infection
104 | [38]: https://github.com/phpstan/phpstan
105 | [39]: https://github.com/vimeo/psalm
106 | [43]: https://github.com/champs-libres/wopi-lib/blob/master/CHANGELOG.md
107 | [44]: https://github.com/champs-libres/wopi-lib/commits/master
108 | [45]: https://github.com/champs-libres/wopi-lib/releases
109 | [46]: https://www.collaboraoffice.com/
110 | [47]: https://www.office.com/
111 | [49]: https://github.com/Champs-Libres/wopi-lib/blob/master/src/Contract/Service/WopiInterface.php
112 | [52]: https://github.com/Champs-Libres/wopi-lib/blob/master/src/Contract/Service/Discovery/DiscoveryInterface.php
113 | [53]: https://www.php-fig.org/
114 | [54]: https://github.com/champs-libres/wopi-lib
115 | [55]: https://www.onlyoffice.com/
116 | [56]: https://github.com/Champs-Libres/wopi-lib/blob/master/src/Contract/Service/DocumentManagerInterface.php
117 | [57]: https://github.com/Champs-Libres/wopi-lib/blob/master/src/Contract/Service/DocumentLockManagerInterface.php
118 | [58]: https://github.com/Champs-Libres/wopi-lib/blob/master/src/Contract/Service/ProofValidatorInterface.php
119 | [59]: https://github.com/Champs-Libres/wopi-lib/blob/master/src/Contract/Service/Utils/DotNetTimeConverterInterface.php
120 | 


--------------------------------------------------------------------------------
/src/Service/Discovery/Discovery.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /**
  4 |  * For the full copyright and license information, please view
  5 |  * the LICENSE file that was distributed with this source code.
  6 |  */
  7 | 
  8 | declare(strict_types=1);
  9 | 
 10 | namespace ChampsLibres\WopiLib\Service\Discovery;
 11 | 
 12 | use ChampsLibres\WopiLib\Contract\Service\Configuration\ConfigurationInterface;
 13 | use ChampsLibres\WopiLib\Contract\Service\Discovery\DiscoveryInterface;
 14 | use Exception;
 15 | use loophp\psr17\Psr17Interface;
 16 | use Psr\Http\Client\ClientInterface;
 17 | use Psr\Http\Message\ResponseInterface;
 18 | use SimpleXMLElement;
 19 | 
 20 | use const JSON_THROW_ON_ERROR;
 21 | 
 22 | final class Discovery implements DiscoveryInterface
 23 | {
 24 |     private ClientInterface $client;
 25 | 
 26 |     private ConfigurationInterface $configuration;
 27 | 
 28 |     private Psr17Interface $psr17;
 29 | 
 30 |     public function __construct(
 31 |         ConfigurationInterface $configuration,
 32 |         ClientInterface $client,
 33 |         Psr17Interface $psr17
 34 |     ) {
 35 |         $this->configuration = $configuration;
 36 |         $this->client = $client;
 37 |         $this->psr17 = $psr17;
 38 |     }
 39 | 
 40 |     public function discoverAction(string $extension, string $name = 'view'): ?array
 41 |     {
 42 |         /** @var false|SimpleXMLElement[]|null $apps */
 43 |         $apps = $this->discover()->xpath('//net-zone/app');
 44 | 
 45 |         if (false === $apps || null === $apps) {
 46 |             throw new Exception();
 47 |         }
 48 | 
 49 |         $return = [];
 50 | 
 51 |         foreach ($apps as $app) {
 52 |             /** @var false|SimpleXMLElement[]|null $actions */
 53 |             $actions = $app->xpath(sprintf('action[@ext="%s" and @name="%s"]', $extension, $name));
 54 | 
 55 |             if (false === $actions || null === $actions) {
 56 |                 continue;
 57 |             }
 58 | 
 59 |             foreach ($actions as $action) {
 60 |                 $actionAttributes = $action->attributes() ?: [];
 61 | 
 62 |                 $return[] = array_merge(
 63 |                     (array) reset($actionAttributes),
 64 |                     ['app' => (string) $app['name']],
 65 |                     ['favIconUrl' => (string) $app['favIconUrl']]
 66 |                 );
 67 |             }
 68 |         }
 69 | 
 70 |         return (false === $action = current($return)) ? null : $action;
 71 |     }
 72 | 
 73 |     public function discoverExtension(string $extension): array
 74 |     {
 75 |         $extensions = [];
 76 | 
 77 |         /** @var false|SimpleXMLElement[]|null $apps */
 78 |         $apps = $this->discover()->xpath('//net-zone/app');
 79 | 
 80 |         if (false === $apps || null === $apps) {
 81 |             throw new Exception();
 82 |         }
 83 | 
 84 |         foreach ($apps as $app) {
 85 |             /** @var false|SimpleXMLElement[]|null $actions */
 86 |             $actions = $app->xpath(sprintf("action[@ext='%s']", $extension));
 87 | 
 88 |             if (false === $actions || null === $actions) {
 89 |                 continue;
 90 |             }
 91 | 
 92 |             foreach ($actions as $action) {
 93 |                 $actionAttributes = $action->attributes() ?: [];
 94 | 
 95 |                 $extensions[] = array_merge(
 96 |                     (array) reset($actionAttributes),
 97 |                     ['name' => (string) $app['name']],
 98 |                     ['favIconUrl' => (string) $app['favIconUrl']]
 99 |                 );
100 |             }
101 |         }
102 | 
103 |         return $extensions;
104 |     }
105 | 
106 |     public function discoverMimeType(string $mimeType): array
107 |     {
108 |         $mimeTypes = [];
109 | 
110 |         /** @var false|SimpleXMLElement[]|null $apps */
111 |         $apps = $this->discover()->xpath(sprintf("//net-zone/app[@name='%s']", $mimeType));
112 | 
113 |         if (false === $apps || null === $apps) {
114 |             throw new Exception();
115 |         }
116 | 
117 |         foreach ($apps as $app) {
118 |             /** @var false|SimpleXMLElement[]|null $actions */
119 |             $actions = $app->xpath('action');
120 | 
121 |             if (false === $actions || null === $actions) {
122 |                 continue;
123 |             }
124 | 
125 |             foreach ($actions as $action) {
126 |                 $actionAttributes = $action->attributes() ?: [];
127 | 
128 |                 $mimeTypes[] = array_merge(
129 |                     (array) reset($actionAttributes),
130 |                     ['name' => (string) $app['name']],
131 |                 );
132 |             }
133 |         }
134 | 
135 |         return $mimeTypes;
136 |     }
137 | 
138 |     public function getCapabilities(): array
139 |     {
140 |         $capabilities = $this->discover()->xpath("//net-zone/app[@name='Capabilities']");
141 | 
142 |         if (false === $capabilities = reset($capabilities)) {
143 |             return [];
144 |         }
145 | 
146 |         return json_decode(
147 |             (string) $this->request((string) $capabilities->action['urlsrc'])->getBody(),
148 |             true,
149 |             512,
150 |             JSON_THROW_ON_ERROR
151 |         );
152 |     }
153 | 
154 |     public function getPublicKey(): string
155 |     {
156 |         return (string) $this->discover()->xpath('//proof-key/@value')[0];
157 |     }
158 | 
159 |     public function getPublicKeyOld(): string
160 |     {
161 |         return (string) $this->discover()->xpath('//proof-key/@oldvalue')[0];
162 |     }
163 | 
164 |     private function discover(): SimpleXMLElement
165 |     {
166 |         $simpleXmlElement = simplexml_load_string(
167 |             (string) $this
168 |                 ->request(
169 |                     sprintf('%s/%s', $this->configuration['server'], 'hosting/discovery')
170 |                 )
171 |                 ->getBody()
172 |         );
173 | 
174 |         if (false === $simpleXmlElement) {
175 |             // TODO
176 |             throw new Exception('Unable to parse XML.');
177 |         }
178 | 
179 |         return $simpleXmlElement;
180 |     }
181 | 
182 |     private function request(string $url): ResponseInterface
183 |     {
184 |         $response = $this
185 |             ->client
186 |             ->sendRequest($this->psr17->createRequest('GET', $url));
187 | 
188 |         if (200 !== $response->getStatusCode()) {
189 |             // TODO
190 |             throw new Exception('Invalid status code');
191 |         }
192 | 
193 |         return $response;
194 |     }
195 | }
196 | 


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | # Changelog
 2 | 
 3 | All notable changes to this project will be documented in this file.
 4 | 
 5 | The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 6 | and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 7 | 
 8 | ## [Unreleased](https://github.com/Champs-Libres/wopi-lib/compare/0.0.1...HEAD)
 9 | 
10 | ### Merged
11 | 
12 | - chore(deps): Bump shivammathur/setup-php from 2.13.0 to 2.14.0 [`#2`](https://github.com/Champs-Libres/wopi-lib/pull/2)
13 | - chore(deps): Bump shivammathur/setup-php from 2.12.0 to 2.13.0 [`#1`](https://github.com/Champs-Libres/wopi-lib/pull/1)
14 | 
15 | ### Commits
16 | 
17 | - refactor: Add a `DotNetTimeConverter` and tests. [`2dea8ae`](https://github.com/Champs-Libres/wopi-lib/commit/2dea8aeede580fbba1e7e1af3384ba03220a0fe5)
18 | - refactor: Update/add new interfaces to provide more abstractions. [`709652f`](https://github.com/Champs-Libres/wopi-lib/commit/709652f208eb6483150e5dba93380819c2ffeea4)
19 | - refactor: Move things around and rename. [`fa75b24`](https://github.com/Champs-Libres/wopi-lib/commit/fa75b24f811ebfeae0675cdb53e6855b2c604389)
20 | - Fix parameter name, use camelcase. [`6cf16ee`](https://github.com/Champs-Libres/wopi-lib/commit/6cf16ee488b384ce7d63e2601d571bfb32fa8d28)
21 | - refactor: Update `WOPI::putRelativeFile' interface. [`7d9e6f2`](https://github.com/Champs-Libres/wopi-lib/commit/7d9e6f28cb26d39e597ee036b462be49e41a6470)
22 | - refactor: Use PHPSecLib only for verification. [`d026ffc`](https://github.com/Champs-Libres/wopi-lib/commit/d026ffce5eec607ba9575aae8d0fd7d9af3e0671)
23 | - refactor: Prevent  issue when there are no capabilities. [`99f2340`](https://github.com/Champs-Libres/wopi-lib/commit/99f23406ef20f46c0f397d3d35f12b68516b1a89)
24 | - refactor: `WopiProofValidator` - Make sure timestamp is properly checked. [`f4e8b78`](https://github.com/Champs-Libres/wopi-lib/commit/f4e8b78bd3e9262ab0daf746a3310d5a5c69ebad)
25 | - refactor: Remove obsolete method. [`06d808b`](https://github.com/Champs-Libres/wopi-lib/commit/06d808b60d21b54b36aa3715a6c494140b856612)
26 | - Autofix code style. [`10440f8`](https://github.com/Champs-Libres/wopi-lib/commit/10440f8fad4a8c63e923516fb68af9d4eea236a6)
27 | - feat: Add `WopiProofValidator` service. [`8362e52`](https://github.com/Champs-Libres/wopi-lib/commit/8362e52260ff492458101c9a2badd054dcd2d0fe)
28 | - refactor: Update `WopiDiscovery::getPublicKey()` and add `WopiDiscovery::getPublicKeyOld()`. [`e993987`](https://github.com/Champs-Libres/wopi-lib/commit/e99398793d7f6671507ab30b75c5ccf5a469c099)
29 | - feat: Add `WopiDiscovery::getPublicKey()` - Update `WopiDiscoveryInterface`. [`52d862b`](https://github.com/Champs-Libres/wopi-lib/commit/52d862b46ff5605efafbb0e8865778365f9470c2)
30 | - fix: Make Grumphp happy. [`3afb336`](https://github.com/Champs-Libres/wopi-lib/commit/3afb336c5bdb00d56ebd21af2318c52f7db0fd4f)
31 | - feat: Add `WopiDiscovery::getPublicKey()`. [`806fc4e`](https://github.com/Champs-Libres/wopi-lib/commit/806fc4e42e634da4a4414d62b0ff486411d89709)
32 | - chore: Update psr/cache minimum version. [`9447aef`](https://github.com/Champs-Libres/wopi-lib/commit/9447aef99a7a63d4cc942ace89a497e88f09ad15)
33 | - chore: Update psr/cache minimum version. [`160995e`](https://github.com/Champs-Libres/wopi-lib/commit/160995eb49a5b459517456fed838fbd93109cf4b)
34 | - refactor: New interfaces and default implementation of a basic document lock manager. [`5e1887f`](https://github.com/Champs-Libres/wopi-lib/commit/5e1887f25d8b73f814a880ff0c263d2b56af6431)
35 | - tests: `WopiDiscovery` spec tests. [`192136a`](https://github.com/Champs-Libres/wopi-lib/commit/192136a9eb1fecdc1feb929d0b01c218ee65c7aa)
36 | - tests: `WopiConfiguration` spec tests. [`fa227cd`](https://github.com/Champs-Libres/wopi-lib/commit/fa227cddb337b9d26810e7ef6bd522d84e41ed5f)
37 | - refactor: Update return types. [`757d4ff`](https://github.com/Champs-Libres/wopi-lib/commit/757d4ff62d11fa59197bf783874b2d76d641a030)
38 | - tests: Disable some tests until phpspec/phpspec#1383 is fixed. [`dfb3266`](https://github.com/Champs-Libres/wopi-lib/commit/dfb3266745644089dc3bb00dd6ee94bf8c50fbd3)
39 | - Add WopiConfiguration class. [`3598fa7`](https://github.com/Champs-Libres/wopi-lib/commit/3598fa7b29406e6d0931d9faa47f489d1c9b5861)
40 | - refactor: Add mimetype discovery. [`d729ec6`](https://github.com/Champs-Libres/wopi-lib/commit/d729ec6169d626bcab19174dae4601c9da10a3ad)
41 | - refactor: Fix bug in WopiDiscovery. [`8d80604`](https://github.com/Champs-Libres/wopi-lib/commit/8d8060477969837ac07672c09b4fb37ff9487bd7)
42 | - refactor: Update Psalm configuration. [`f963bff`](https://github.com/Champs-Libres/wopi-lib/commit/f963bff57e32af6799021b62a01df40230858839)
43 | - refactor: Update static analysis documentation. [`ab455d0`](https://github.com/Champs-Libres/wopi-lib/commit/ab455d0be01c5ecc217b937894cad7713c175fd8)
44 | - chore: Update static files. [`9b0be73`](https://github.com/Champs-Libres/wopi-lib/commit/9b0be738be627ac68abfd56f8459cda234ebeb46)
45 | - docs: Update README. [`fcf7119`](https://github.com/Champs-Libres/wopi-lib/commit/fcf7119d164385c0fbe70604bd4c798e9479fb33)
46 | - refactor: Simplification. [`70d2a1c`](https://github.com/Champs-Libres/wopi-lib/commit/70d2a1c1f368b32acd1ff6f681a1ea6e65ae47a6)
47 | - refactor: Update interface. [`ae4ac85`](https://github.com/Champs-Libres/wopi-lib/commit/ae4ac85c1fb118b3433676d83e7783d952d698d9)
48 | - refactor: Remove cache layer. Should be implemented in the HTTP client. [`3affbf2`](https://github.com/Champs-Libres/wopi-lib/commit/3affbf21148ee294db30bba2323048e603ca52fb)
49 | - refactor: Autofix code style. [`50eaa46`](https://github.com/Champs-Libres/wopi-lib/commit/50eaa466ff6a32682fd7c9bc60436f48431fa93c)
50 | - chore: Normalize composer.json. [`8ff472e`](https://github.com/Champs-Libres/wopi-lib/commit/8ff472e5a88653b62e4fdf59359286c460407bb0)
51 | - refactor: Add favIconUrl. [`28f6935`](https://github.com/Champs-Libres/wopi-lib/commit/28f69354fecace721f1b8f3f9064b08b6c776ceb)
52 | - refactor: Autofix code style. [`a0a2275`](https://github.com/Champs-Libres/wopi-lib/commit/a0a227525d923009f4fba08e16f4b8d3c3dbac26)
53 | - refactor: Do not try to convert the XML into an array. [`666aa37`](https://github.com/Champs-Libres/wopi-lib/commit/666aa37149b1e2d45d9f074771995d2a4c3030ce)
54 | - refactor: Use XML2Array. [`577146c`](https://github.com/Champs-Libres/wopi-lib/commit/577146c81f8ffc309e3404358d620a0c9bad5ece)
55 | - refactor: Update class name. [`59c3d93`](https://github.com/Champs-Libres/wopi-lib/commit/59c3d93e28ec7c8fb772ccb69c4171306efbf390)
56 | - refactor: Update namespaces. [`bcd94e2`](https://github.com/Champs-Libres/wopi-lib/commit/bcd94e2886f61b325f5ba43664c07e7c44a082cc)
57 | - chore: Update composer.json. [`bad05c1`](https://github.com/Champs-Libres/wopi-lib/commit/bad05c16265b5e2765c72bdf4848d829618480a2)
58 | 
59 | ## 0.0.1 - 2021-08-05
60 | 
61 | ### Commits
62 | 
63 | - Initial set of files. [`22333c1`](https://github.com/Champs-Libres/wopi-lib/commit/22333c18447bed681766a2b7f85da070ab5577cb)
64 | 


--------------------------------------------------------------------------------