PHPackages                             subdomainto/symfony-bundle - 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. subdomainto/symfony-bundle

ActiveSymfony-bundle

subdomainto/symfony-bundle
==========================

Symfony bundle for the subdomain.to custom domains API with an autowired client, configuration, and signed webhook attributes.

v1.0.1(1mo ago)00MITPHPPHP ^8.1

Since Jul 15Pushed 1mo agoCompare

[ Source](https://github.com/subdomain-to/symfony-bundle)[ Packagist](https://packagist.org/packages/subdomainto/symfony-bundle)[ Docs](https://docs.subdomain.to/sdks/symfony)[ RSS](/packages/subdomainto-symfony-bundle/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (18)Versions (3)Used By (0)

subdomain.to Symfony Bundle
===========================

[](#subdomainto-symfony-bundle)

`subdomainto/symfony-bundle` integrates the subdomain.to custom domains API with Symfony. It configures the typed PHP client, enables autowiring, supports environment-based credentials, and verifies signed webhooks through a controller attribute.

The bundle supports Symfony 6.4, 7.4, and 8.x on PHP 8.1 or later.

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

[](#installation)

```
composer require subdomainto/symfony-bundle
```

Symfony Flex normally registers the bundle. Configure the API client and webhook verifier:

```
# config/packages/subdomain_to.yaml
subdomain_to:
    api_key: '%env(SUBDOMAINTO_API_KEY)%'
    webhook_secret: '%env(SUBDOMAINTO_WEBHOOK_SECRET)%'
    webhook_tolerance: 300
```

Autowire the custom domains client
----------------------------------

[](#autowire-the-custom-domains-client)

```
use SubdomainTo\Client;
use SubdomainTo\Model\Domain;

final class ConnectCustomerDomain
{
    public function __construct(private Client $subdomainTo) {}

    public function __invoke(string $customerId, string $hostname): Domain
    {
        return $this->subdomainTo->domains()->create(
            $hostname,
            $customerId.'-domain',
        );
    }
}
```

The client exposes typed resources for destinations, domains, DNS and TLS lifecycle status, webhooks, widget sessions, usage, and billing.

Verify a webhook controller
---------------------------

[](#verify-a-webhook-controller)

```
use SubdomainTo\Symfony\Attribute\VerifySubdomainToWebhook;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;

#[VerifySubdomainToWebhook]
public function webhook(Request $request): Response
{
    $event = $request->attributes->get('subdomainto_event');

    return new Response(status: 204);
}
```

The attribute triggers verification of the untouched request body, `SubdomainTo-Signature`, HMAC signature, and timestamp before the controller runs.

Documentation
-------------

[](#documentation)

Read the [Symfony SDK guide](https://docs.subdomain.to/sdks/symfony), browse the [custom domains API documentation](https://docs.subdomain.to), or report an issue in the [GitHub repository](https://github.com/subdomain-to/symfony-bundle/issues).

License
-------

[](#license)

MIT

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance94

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.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 ~13 days

Total

2

Last Release

32d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9df02645cfbf7549cd8fd20348744cefcfad5b7f15edfc1b3212839b0db5e066?d=identicon)[subdomainto](/maintainers/subdomainto)

---

Top Contributors

[![subdomainto](https://avatars.githubusercontent.com/u/263146959?v=4)](https://github.com/subdomainto "subdomainto (2 commits)")[![laurentdav](https://avatars.githubusercontent.com/u/45101601?v=4)](https://github.com/laurentdav "laurentdav (1 commits)")

---

Tags

custom-domainsdnsphpsaassdksymfonysymfony-bundletlswebhookssymfonydnstlssslwebhooksSymfony Bundlesaascustom-domainsdomain-management

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/subdomainto-symfony-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/subdomainto-symfony-bundle/health.svg)](https://phpackages.com/packages/subdomainto-symfony-bundle)
```

###  Alternatives

[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

605.9M711](/packages/shopware-core)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.7M442](/packages/easycorp-easyadmin-bundle)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.4k1.4M241](/packages/sulu-sulu)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[contao/core-bundle

Contao Open Source CMS

1231.7M3.1k](/packages/contao-core-bundle)

PHPackages © 2026

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