Phone Input Bundle

⭐ Found this useful? Give it a star on GitHub so more developers can find it.

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).

This bundle is FrankenPHP worker mode friendly.

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

Quick start

composer require nowo-tech/phone-input-bundle

use Nowo\PhoneInputBundle\Form\Type\PhoneType;

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

See docs/INSTALLATION.md for form theme, CSS assets, and optional dependencies.

Requirements

• PHP >= 8.2, < 8.6
• Symfony ^6.0 || ^7.0 || ^8.0

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.

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

Development

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

Documentation

• GitHub Actions CI requirements
• Installation
• Configuration
• Usage
• Contributing
• Code of Conduct
• Changelog
• Upgrading
• Release
• Security
• Engram
• Spec-driven development
• GitHub Spec Kit

Additional documentation

• Demo with FrankenPHP (development and production)
• Overriding bundle templates
• Branching

Tests and coverage

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

License

MIT — see LICENSE.

Author

Created by Nowo.tech