PHPackages                             nowo-tech/phone-input-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. [Utility &amp; Helpers](/categories/utility)
4. /
5. nowo-tech/phone-input-bundle

ActiveSymfony-bundle[Utility &amp; Helpers](/categories/utility)

nowo-tech/phone-input-bundle
============================

Symfony bundle providing a phone form type with optional country prefix selector and flexible value formats

v1.1.4(2w ago)010MITPHP &gt;=8.2 &lt;8.6

Since Jun 21Compare

[ Source](https://github.com/nowo-tech/PhoneInputBundle)[ Packagist](https://packagist.org/packages/nowo-tech/phone-input-bundle)[ Docs](https://github.com/nowo-tech/PhoneInputBundle)[ GitHub Sponsors](https://github.com/HecFranco)[ RSS](/packages/nowo-tech-phone-input-bundle/feed)WikiDiscussions Synced 2w ago

READMEChangelog (8)Dependencies (26)Versions (9)Used By (0)

Phone Input Bundle
==================

[](#phone-input-bundle)

[![CI](https://github.com/nowo-tech/PhoneInputBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/PhoneInputBundle/actions/workflows/ci.yml) [![Packagist Version](https://camo.githubusercontent.com/c13e4a778acd70c52026dadbdaf534719a5187bb43aa1d108cbc87b888e02944/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f70686f6e652d696e7075742d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/phone-input-bundle) [![Packagist Downloads](https://camo.githubusercontent.com/84359f75e73469305836967ae50e2dc9f6ba58571c2d0dfdb50911004d5fb021/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f70686f6e652d696e7075742d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/phone-input-bundle) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/b43d1688d52c63d771fe5f9f56c9120e3a4e9601779936d3dc0a436df1f874c3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d362e30253242253230253743253230372e34253242253230253743253230382e30253230253743253230382e312532422d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) [![GitHub stars](https://camo.githubusercontent.com/a1abc4285f31fafe3116db0361cbe7c0f1e9b4110bfb21528b03f95458c5b0e4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f50686f6e65496e70757442756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/PhoneInputBundle) [![Coverage](https://camo.githubusercontent.com/08f9e2cc3cc2ac54c1a3318cd1fc74d87e564fe653e479f69ca8a42ee4821c98/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f7665726167652d39352532352d627269676874677265656e)](#tests-and-coverage)

Symfony bundle providing a phone form type with optional country prefix selector and flexible value formats (E.164 string, separated array, or `PhoneNumber` value object).

> ⭐ **Found this useful?** Give it a **star** on [GitHub](https://github.com/nowo-tech/PhoneInputBundle) so more developers can find it.

Features
--------

[](#features)

- Extends Symfony `TelType` with an optional country prefix selector (flags, dial codes, autocomplete search)
- Three model formats: **CONCATENATED** (E.164), **SEPARATED** (array), **OBJECT** (`PhoneNumber` VO)
- Validation by country ISO, dial prefix, or disabled (`phone_validation`)
- Configurable prefix/flag display modes and CSS classes (Bootstrap, Tailwind, Foundation, custom)
- Bundled country catalog and CSS flag icons; optional UX Icons for SVG flags

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

[](#documentation)

- [GitHub Actions CI requirements](docs/GITHUB_CI.md)
- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Changelog](docs/CHANGELOG.md)
- [Upgrading](docs/UPGRADING.md)
- [Release](docs/RELEASE.md)
- [Security](docs/SECURITY.md)
- [Engram](docs/ENGRAM.md)
- [Spec-driven development](docs/SPEC-DRIVEN-DEVELOPMENT.md)
- [GitHub Spec Kit](docs/SPEC-KIT.md)

### Additional documentation

[](#additional-documentation)

- [Demo with FrankenPHP (development and production)](docs/DEMO-FRANKENPHP.md)
- [Overriding bundle templates](docs/USAGE.md#overriding-bundle-templates)
- [Branching](docs/BRANCHING.md)

Quick start
-----------

[](#quick-start)

```
composer require nowo-tech/phone-input-bundle
```

```
use Nowo\PhoneInputBundle\Form\Type\PhoneType;

$builder->add('mobile', PhoneType::class);
```

See [docs/INSTALLATION.md](docs/INSTALLATION.md) for form theme, CSS assets, and optional dependencies.

Demo
----

[](#demo)

Demos for Symfony 7.0 and 8.0 live under `demo/`. From the bundle root:

```
make -C demo up-symfony8
# http://localhost:8003 (see demo/symfony8/.env.example)
```

The demo page shows **20 field examples** and a **CSS framework selector** (`?framework=bootstrap5|tailwind2|foundation6|symfony-default`). See [demo/README.md](demo/README.md).

Demos use **FrankenPHP** without worker mode in development (changes visible on refresh). For production worker setup, see [docs/DEMO-FRANKENPHP.md](docs/DEMO-FRANKENPHP.md).

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

[](#requirements)

- PHP &gt;= 8.2, &lt; 8.6
- Symfony ^6.0 || ^7.0 || ^8.0

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

[](#development)

```
make up && make install && make test
make test-coverage   # PHP coverage report
make release-check   # cs-fix, phpstan, coverage, demo healthchecks
```

Tests and coverage
------------------

[](#tests-and-coverage)

- Tests: PHPUnit (unit + integration)
- PHP: **95.75%**
- TS/JS: N/A
- Python: N/A

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

Author
------

[](#author)

Created by [Nowo.tech](https://nowo.tech)

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance96

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

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 ~3 days

Total

8

Last Release

20d ago

PHP version history (2 changes)v1.0.0PHP &gt;=8.1 &lt;8.6

v1.1.0PHP &gt;=8.2 &lt;8.6

### Community

Maintainers

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

---

Tags

symfonybundlephoneprefixformcountrytelE164

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nowo-tech-phone-input-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nowo-tech-phone-input-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-phone-input-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M414](/packages/easycorp-easyadmin-bundle)[kimai/kimai

Kimai - Time Tracking

4.8k9.4k1](/packages/kimai-kimai)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k6.0M764](/packages/sylius-sylius)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1617.3k14](/packages/2lenet-crudit-bundle)[contao/core-bundle

Contao Open Source CMS

1301.7M2.9k](/packages/contao-core-bundle)[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

12017.1k](/packages/rcsofttech-audit-trail-bundle)

PHPackages © 2026

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