PHPackages                             imponeer/smarty-sunrise-http-router - 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. [HTTP & Networking](/categories/http)
4. /
5. imponeer/smarty-sunrise-http-router

ActiveLibrary[HTTP & Networking](/categories/http)

imponeer/smarty-sunrise-http-router
===================================

Smarty extensions to use with amazing router from sunrise-php

v3.0.0(2y ago)117.0k↓80%MITPHPPHP ^8.1CI passing

Since Nov 4Pushed 1w ago2 watchersCompare

[ Source](https://github.com/imponeer/smarty-sunrise-http-router)[ Packagist](https://packagist.org/packages/imponeer/smarty-sunrise-http-router)[ RSS](/packages/imponeer-smarty-sunrise-http-router/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (3)Versions (16)Used By (0)

[![License](https://camo.githubusercontent.com/e0a9276cce704d39fd85e8a7a2b780fad27da7d1696c84f3e1d392f71d9fb10b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f696d706f6e6565722f736d617274792d73756e726973652d687474702d726f757465722e737667)](LICENSE) [![GitHub release](https://camo.githubusercontent.com/f257ac893898d4d13772c544d311be5681c629bd178febb96eec2789893a79d4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f696d706f6e6565722f736d617274792d73756e726973652d687474702d726f757465722e737667)](https://github.com/imponeer/smarty-sunrise-http-router/releases) [![PHP](https://camo.githubusercontent.com/f22b7427f4ddee9079bbe6f6ec995e385629d70031e21f344cf2fbf3784bf89e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f696d706f6e6565722f736d617274792d73756e726973652d687474702d726f757465722e737667)](http://php.net) [![Packagist](https://camo.githubusercontent.com/2cb6b088ffa9aa43ae84e998a8e3464fd0d92ebcb7d98e7556a29bdf9f71eeb8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f696d706f6e6565722f736d617274792d73756e726973652d687474702d726f757465722e737667)](https://packagist.org/packages/imponeer/smarty-sunrise-http-router) [![Smarty version requirement](https://camo.githubusercontent.com/f963adc73591090e71de994d365fb2b06d2d54a0460142292e6cd32da4a4422f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f696d706f6e6565722f736d617274792d73756e726973652d687474702d726f757465722f736d61727479253246736d61727479)](https://smarty-php.github.io)

Smarty Sunrise HTTP Router
==========================

[](#smarty-sunrise-http-router)

This library exposes Sunrise HTTP Router named routes to Smarty through a `{url}` template function, allowing templates to generate links without hardcoding paths. It is designed for applications that keep routing logic in [Sunrise HTTP Router](https://github.com/sunrise-php/http-router) and want those routes available directly inside Smarty views.

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

[](#installation)

To install and use this package, we recommend to use [Composer](https://getcomposer.org):

```
composer require imponeer/smarty-sunrise-http-router
```

Otherwise, you need to include manually files from `src/` directory.

Setup
-----

[](#setup)

### Modern Smarty Extension (Recommended)

[](#modern-smarty-extension-recommended)

Register the extension with your Smarty instance and provide a configured router:

```
use Imponeer\Smarty\Extensions\SunriseHTTPRouter\SunriseHttpRouterExtension;
use Sunrise\Http\Router\RouterInterface;

// $router is a configured Sunrise\Http\Router\RouterInterface instance
$router = $container->get(RouterInterface::class);

$smarty = new \Smarty\Smarty();
$smarty->addExtension(new SunriseHttpRouterExtension($router));
```

### Using with Dependency Injection Containers

[](#using-with-dependency-injection-containers)

#### Symfony Container

[](#symfony-container)

```
# config/services.yaml
services:
    _defaults:
        autowire: true
        autoconfigure: true

    Imponeer\Smarty\Extensions\SunriseHTTPRouter\SunriseHttpRouterExtension:
        arguments:
            - '@Sunrise\Http\Router\RouterInterface'

    \Smarty\Smarty:
        calls:
            - [addExtension, ['@Imponeer\Smarty\Extensions\SunriseHTTPRouter\SunriseHttpRouterExtension']]
```

#### PHP-DI Container

[](#php-di-container)

```
use Imponeer\Smarty\Extensions\SunriseHTTPRouter\SunriseHttpRouterExtension;
use Sunrise\Http\Router\RouterInterface;
use function DI\create;
use function DI\get;

return [
    SunriseHttpRouterExtension::class => create()->constructor(get(RouterInterface::class)),
    \Smarty\Smarty::class => create()->method('addExtension', get(SunriseHttpRouterExtension::class)),
];
```

#### League Container

[](#league-container)

```
use Imponeer\Smarty\Extensions\SunriseHTTPRouter\SunriseHttpRouterExtension;
use Sunrise\Http\Router\RouterInterface;

$container = new \League\Container\Container();

$container->add(RouterInterface::class, function () {
    // Build and return your RouterInterface implementation
});

$container->add(\Smarty\Smarty::class, function () use ($container) {
    $smarty = new \Smarty\Smarty();
    $smarty->addExtension(new SunriseHttpRouterExtension($container->get(RouterInterface::class)));

    return $smarty;
});
```

Usage
-----

[](#usage)

The `{url}` function renders a URL for a named route defined in Sunrise HTTP Router.

### Generate a route URL

[](#generate-a-route-url)

```
{url name="home"}
```

### Passing route attributes

[](#passing-route-attributes)

```
{url name="article" attributes=["slug" => "introduction-to-router"]}
{* or the shorter alias *}
{url name="article" attr=["slug" => "introduction-to-router"]}
```

### Handling missing attributes

[](#handling-missing-attributes)

If required route attributes are not provided or the route name does not exist, the router will throw an exception so you can catch and handle the error in your application.

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

[](#development)

### Code Quality Tools

[](#code-quality-tools)

- **PHPUnit** - For unit testing

    ```
    composer test
    ```
- **PHP CodeSniffer** - For coding standards (PSR-12)

    ```
    composer phpcs    # Check code style
    composer phpcbf   # Fix code style issues automatically
    ```
- **PHPStan** - For static analysis

    ```
    composer phpstan
    ```

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

[](#documentation)

Routes are defined and built using [Sunrise HTTP Router](https://github.com/sunrise-php/http-router), and Smarty extension details are available in the [Smarty documentation](https://www.smarty.net/docs/en/). Review those resources for deeper customization tips.

Contributing
------------

[](#contributing)

Contributions are welcome! Here's how you can contribute:

1. Fork the repository
2. Create a feature branch: `git checkout -b feature-name`
3. Commit your changes: `git commit -am 'Add some feature'`
4. Push to the branch: `git push origin feature-name`
5. Submit a pull request

Please make sure your code follows the PSR-12 coding standard and include tests for any new features or bug fixes.

If you find a bug or have a feature request, please create an issue in the [issue tracker](https://github.com/imponeer/smarty-sunrise-http-router/issues).

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance64

Regular maintenance activity

Popularity25

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 50% 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 ~87 days

Recently: every ~121 days

Total

11

Last Release

770d ago

Major Versions

v1.1.5 → v2.0.02023-01-03

v2.0.2 → v3.0.02024-04-02

PHP version history (3 changes)v1.0PHP >=7.2

v2.0.0PHP ^7.3 || ^8.0

v3.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/dba53e399a507d1f60626164c8b1e340a5cc0dc4f0637f4c6aaff8fc239fdaee?d=identicon)[fiammybe](/maintainers/fiammybe)

![](https://www.gravatar.com/avatar/7255f306e0ca27292c50cdd9644c1c04e0d7b0f54bf35e0cdd79dc55c83b4923?d=identicon)[MekDrop](/maintainers/MekDrop)

![](https://www.gravatar.com/avatar/79009323fafcd4974bb1713b12eea0a610f01c4fb21cc5e85d446c4cb66453d4?d=identicon)[skenow](/maintainers/skenow)

---

Top Contributors

[![MekDrop](https://avatars.githubusercontent.com/u/342641?v=4)](https://github.com/MekDrop "MekDrop (43 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (20 commits)")[![Codex](https://avatars.githubusercontent.com/in/2248422?v=4)](https://github.com/Codex "Codex (15 commits)")[![Claude](https://avatars.githubusercontent.com/in/2246796?v=4)](https://github.com/Claude "Claude (4 commits)")[![fiammybe](https://avatars.githubusercontent.com/u/3736946?v=4)](https://github.com/fiammybe "fiammybe (3 commits)")[![mend-bolt-for-github[bot]](https://avatars.githubusercontent.com/in/16809?v=4)](https://github.com/mend-bolt-for-github[bot] "mend-bolt-for-github[bot] (1 commits)")

---

Tags

hacktoberfestsmartysmarty-plugins

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/imponeer-smarty-sunrise-http-router/health.svg)

```
[![Health](https://phpackages.com/badges/imponeer-smarty-sunrise-http-router/health.svg)](https://phpackages.com/packages/imponeer-smarty-sunrise-http-router)
```

###  Alternatives

[friendsofsymfony/rest-bundle

This Bundle provides various tools to rapidly develop RESTful API's with Symfony

2.8k73.3M319](/packages/friendsofsymfony-rest-bundle)[php-http/discovery

Finds and installs PSR-7, PSR-17, PSR-18 and HTTPlug implementations

1.3k309.5M1.2k](/packages/php-http-discovery)[nyholm/psr7

A fast PHP7 implementation of PSR-7

1.3k235.4M2.4k](/packages/nyholm-psr7)[pusher/pusher-php-server

Library for interacting with the Pusher REST API

1.5k94.8M293](/packages/pusher-pusher-php-server)[spatie/crawler

Crawl all internal links found on a website

2.8k16.3M52](/packages/spatie-crawler)[react/http

Event-driven, streaming HTTP client and server implementation for ReactPHP

78126.4M414](/packages/react-http)

PHPackages © 2026

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