PHPackages                             qckanemoto/twigged-swiftmessage-builder - 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. [Templating & Views](/categories/templating)
4. /
5. qckanemoto/twigged-swiftmessage-builder

Abandoned → [ttskch/twigged-swiftmessage-builder](/?search=ttskch%2Ftwigged-swiftmessage-builder)Library[Templating & Views](/categories/templating)

qckanemoto/twigged-swiftmessage-builder
=======================================

Twig templated Swift\_Message builder service.

2.0.0(9y ago)2110[1 issues](https://github.com/ttskch/TwiggedSwiftMessageBuilder/issues)MITPHPPHP >=5.3.3

Since Jun 4Pushed 9y ago1 watchersCompare

[ Source](https://github.com/ttskch/TwiggedSwiftMessageBuilder)[ Packagist](https://packagist.org/packages/qckanemoto/twigged-swiftmessage-builder)[ Docs](https://github.com/ttskch/TwiggedSwiftMessageBuilder)[ RSS](/packages/qckanemoto-twigged-swiftmessage-builder/feed)WikiDiscussions master Synced 1mo ago

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

TwiggedSwiftMessageBuilder
==========================

[](#twiggedswiftmessagebuilder)

[![Build Status](https://camo.githubusercontent.com/fd867d11db5cc2d50cdde90e376ce6ceff247aa095e1882fb607e069ff76512e/68747470733a2f2f7472617669732d63692e6f72672f7474736b63682f5477696767656453776966744d6573736167654275696c6465722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/ttskch/TwiggedSwiftMessageBuilder)[![Latest Stable Version](https://camo.githubusercontent.com/50d45fa1e97eeaa3c1b37cd3212a7eecf469643f1b14f5d91e097cff826f5e5f/68747470733a2f2f706f7365722e707567782e6f72672f7474736b63682f747769676765642d73776966746d6573736167652d6275696c6465722f762f737461626c652e737667)](https://packagist.org/packages/ttskch/twigged-swiftmessage-builder)[![Total Downloads](https://camo.githubusercontent.com/a5c2a815ebdd94142e99a6f50f56ade9383a528e15ab7f1f4b6cc15cb7574d58/68747470733a2f2f706f7365722e707567782e6f72672f7474736b63682f747769676765642d73776966746d6573736167652d6275696c6465722f646f776e6c6f6164732e737667)](https://packagist.org/packages/ttskch/twigged-swiftmessage-builder)

`TwiggedSwiftMessageBuilder` class allows you following things:

- to create Twig templated Swift\_Message
- to create inline styled html email from unstyled html and css strings
- to embed some image files into message body

Requirements
------------

[](#requirements)

- PHP 5.3+

Getting started
---------------

[](#getting-started)

First add this dependency into your `composer.json`:

```
{
    "require": {
        "ttskch/twigged-swiftmessage-builder": "~2.0"
    }
}
```

Then you can send Twig templated email as below:

```
{# email.txt.twig #}

{% block from %}no-reply@example.com{% endblock %}
{% block from_name %}[Example]{% endblock %}
{% block subject %}Welcome to [Example]!{% endblock %}

{% block body %}
Hello [Example] World!
{% endblock %}
```

```
// in your application.

$builder = new \Ttskch\TwiggedSwiftMessageBuilder\TwiggedSwiftMessageBuilder($tiwg);  // $twig is an instance of \Twig_Environment class.

$message = $builder->buildMessage('email.txt.twig');
$message->setTo('hoge@example.com');

$mailer->send($message);    // $mailer is an instance of \Swift_Mailer class.
```

In Twig template you can define many things by using `{% block [field-name] %}{% endblock %}`. These fields can be defined.

- from
- from\_name
- to
- cc
- bcc
- reply\_to
- subject
- body

Use variables in Twig template
------------------------------

[](#use-variables-in-twig-template)

Offcourse you can pass variables and use them in Twig template as below:

```
{# email.txt.twig #}

{% block subject %}Welcome to {{ site_title }}!{% endblock %}
```

```
// in your application.

$builder = new \Ttskch\TwiggedSwiftMessageBuilder\TwiggedSwiftMessageBuilder($tiwg);

$message = $builder->buildMessage('email.txt.twig', array(
    'site_title' => 'FooBar Service',
));
$message->setTo('hoge@example.com');

$mailer->send($message);
```

Use inline-styled html email
----------------------------

[](#use-inline-styled-html-email)

You can make inline-styled html from unstyled html and css strings. To allow recipients of your html email to receive it with Gmail, you will have to make inline-styled html body.

```
// in your application.

$builder = new \Ttskch\TwiggedSwiftMessageBuilder\TwiggedSwiftMessageBuilder($tiwg);

$message = $builder->buildMessage('email.html.twig');

$style = file_get_contents('/path/to/style.css');

$message = $builder->setInlineStyle($message, $style);

$mailer->send($message);
```

> **Note**
>
> This functionality is using `mb_convert_encoding()` with `'auto'` internally. So if you use this you **must** set `mbstring.language` in php.ini or call `mb_language('your_language')` on ahead.
>
> **注意**
>
> この機能は内部的に `mb_convert_encoding()` に `'auto'` を渡して実行します。なので、php.ini で `mbstring.language` を設定するか、`mb_language('Japanese')` を事前に実行しておく必要があります。

Embed some image files into message body
----------------------------------------

[](#embed-some-image-files-into-message-body)

You can embed images into message body as below:

```
{# email.html.twig #}

{% block body %}

{% endblock %}
```

```
// in your application.

$builder = new \Ttskch\TwiggedSwiftMessageBuilder\TwiggedSwiftMessageBuilder($tiwg);

$message = $builder->buildMessage('email.html.twig', array(
    'image_path' => '/path/to/image/file',
));

// you can get renderable html with base64 encoded images. (In case you want to print preview.)
$renderableHtml = $builder->renderBody($message);

// you must finalize embedding before send message.
$message = $builder->finalizeEmbedding($message);

$mailer->send($message);
```

Enjoy!
------

[](#enjoy)

See also [functional tests](tests/FunctionalTest.php) to understand basic usages.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity13

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

Every ~110 days

Total

2

Last Release

3525d ago

Major Versions

1.0.0 → 2.0.02016-09-23

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4360663?v=4)[Takashi Kanemoto](/maintainers/ttskch)[@ttskch](https://github.com/ttskch)

---

Top Contributors

[![ttskch](https://avatars.githubusercontent.com/u/4360663?v=4)](https://github.com/ttskch "ttskch (1 commits)")

---

Tags

twigSwift\_MessageSwift\_Mailer

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/qckanemoto-twigged-swiftmessage-builder/health.svg)

```
[![Health](https://phpackages.com/badges/qckanemoto-twigged-swiftmessage-builder/health.svg)](https://phpackages.com/packages/qckanemoto-twigged-swiftmessage-builder)
```

###  Alternatives

[twig/extra-bundle

A Symfony bundle for extra Twig extensions

91492.0M315](/packages/twig-extra-bundle)[twig/cssinliner-extra

A Twig extension to allow inlining CSS

22918.5M55](/packages/twig-cssinliner-extra)[twig/intl-extra

A Twig extension for Intl

36763.2M221](/packages/twig-intl-extra)[rcrowe/twigbridge

Adds the power of Twig to Laravel

9105.9M50](/packages/rcrowe-twigbridge)[twig/string-extra

A Twig extension for Symfony String

22046.0M133](/packages/twig-string-extra)[symfony/ux-twig-component

Twig components for Symfony

21914.8M162](/packages/symfony-ux-twig-component)

PHPackages © 2026

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