PHPackages                             zegnat/webmention-endpoint-discovery - 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. zegnat/webmention-endpoint-discovery

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

zegnat/webmention-endpoint-discovery
====================================

A straight forward implementation of webmention endpoint discovery.

v1.0(7y ago)2110BSDPHPPHP ^7.0CI failing

Since Aug 18Pushed 1w ago1 watchersCompare

[ Source](https://github.com/Zegnat/php-webmention-endpoint-discovery)[ Packagist](https://packagist.org/packages/zegnat/webmention-endpoint-discovery)[ Docs](https://github.com/Zegnat/php-webmention-endpoint-discovery)[ RSS](/packages/zegnat-webmention-endpoint-discovery/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (1)Dependencies (11)Versions (3)Used By (0)

Webmention Endpoint Discovery
=============================

[](#webmention-endpoint-discovery)

Mostly a thought experiment to see what exactly is required to do [Webmention endpoints discovery](https://webmention.net/draft/#sender-discovers-receiver-webmention-endpoint). You can use this implementation on its own, though it will probably net you better results to tightly integrate the code within the rest of your application.

Under the licence of this project you should feel free to copy any parts of it that you want to take for inspiration! Not even attribution is required – even when appreciated.

Install
-------

[](#install)

Via Composer

```
$ composer require zegnat/webmention-endpoint-discovery
```

Usage
-----

[](#usage)

```
$discoverer = new Zegnat\Webmention\EndpointDiscovery($httpClient, $requestFactory);
echo $discoverer->discover('https://webmention.rocks/test/1');
// https://webmention.rocks/test/1/webmention?head=true
```

- `$httpClient` must be an HTTP client implementing `ClientInterface` as defined by [PSR-18](https://www.php-fig.org/psr/psr-18/). Clients implementing `HttpClient` as defined by [HTTPlug](http://httplug.io/)1.x are also still accepted.
- `$requestFactory` must be an implementation of `RequestFactoryInterface`as defined by [PHP-FIG](https://www.php-fig.org/) as [PSR-17](https://www.php-fig.org/psr/psr-17/).

### Secure Endpoints

[](#secure-endpoints)

***NOTE:*** This feature is very much experimental. Please consult the code before deciding to use it.

There might be some weird issues triggered by having Webmention senders post mentions to things on their local machines. The Webmention specification calls on senders to [avoid sending Webmentions to localhost](https://webmention.net/draft/#avoid-sending-webmentions-to-localhost). This library enables that.

`EndpointDiscovery::secureDiscover` will return `null` not only when no endpoint could be found, but also when the found endpoint’s host’s DNS resolves to an IP address in the private or reserved range. When all the IP addresses found are deemed to be OK, the method will return an array as follows:

```
$discoverer = new Zegnat\Webmention\EndpointDiscovery($httpClient, $requestFactory);
var_export($discoverer->secureDiscover('https://webmention.rocks/test/1'));
// array (
//   'url' => 'https://webmention.rocks/test/1/webmention?head=true',
//   'host' => 'webmention.rocks',
//   'ips' =>
//   array (
//     0 => '173.230.155.197',
//   ),
// )
```

It is recommended that the Webmention sender uses this information for posting the mention. Use one of the checked IP addresses to post to (instead of the domain, which might redo the DNS lookup) with the host in a `Host` HTTP header.

Supported PHP versions
----------------------

[](#supported-php-versions)

This library requires PHP 7.0 or newer and is tested against PHP 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 and 8.5.

Testing
-------

[](#testing)

Tests run on every supported PHP version through Docker, orchestrated by [Castor](https://castor.jolicode.com/). Each PHP version and its dependencies live entirely in their container, so only Docker and Castor are needed on the host:

```
$ castor matrix     # run the whole matrix
$ castor test 8.4   # run a single version
$ castor coverage   # run with code coverage and enforce the minimum
```

The tests that make live calls to [Webmention Rocks!](https://webmention.rocks/)are marked with `@group internet`. Pass `--offline` to `castor test` or `castor matrix` to exclude them:

```
$ castor test 8.4 --offline
```

The hash-named test fixtures under `tests/responses` are verbatim captures of Webmention Rocks! responses under its license; see [CREDITS.md](CREDITS.md)for their source and the `LICENSES` directory ([REUSE](https://reuse.software/)).

License
-------

[](#license)

The BSD Zero Clause License (0BSD). Please see the LICENSE file for more information.

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance64

Regular maintenance activity

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

2918d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/490579?v=4)[Martijn van der Ven](/maintainers/Zegnat)[@Zegnat](https://github.com/Zegnat)

---

Top Contributors

[![Zegnat](https://avatars.githubusercontent.com/u/490579?v=4)](https://github.com/Zegnat "Zegnat (22 commits)")

---

Tags

indiewebwebmentionindiewebwebmention

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/zegnat-webmention-endpoint-discovery/health.svg)

```
[![Health](https://phpackages.com/badges/zegnat-webmention-endpoint-discovery/health.svg)](https://phpackages.com/packages/zegnat-webmention-endpoint-discovery)
```

###  Alternatives

[guzzlehttp/psr7

PSR-7 message implementation that also provides common utility methods

7.9k1.1B4.4k](/packages/guzzlehttp-psr7)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k20](/packages/tempest-framework)[typo3/cms-core

TYPO3 CMS Core

3313.6M5.6k](/packages/typo3-cms-core)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

86337.5k](/packages/flow-php-flow)[mcp/sdk

Model Context Protocol SDK for Client and Server applications in PHP

1.6k2.2M140](/packages/mcp-sdk)

PHPackages © 2026

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