How to migrate from misd phone number bundle to the odolbeau fork?

Update your composer.json to require 'odolbeau/phone-number-bundle', then check its documentation for any configuration changes or namespace updates, as the fork might have breaking changes or enhanced features for newer Symfony versions. You may need to adjust your codebase accordingly.

Does PhoneNumberBundle work with Symfony 6?

No, PhoneNumberBundle only supports Symfony up to version 4, as stated in its documentation. For Symfony 5 or 6, use the maintained fork odolbeau/phone-number-bundle or consider alternative bundles that are actively updated for compatibility.

How to validate a phone number in Symfony without this bundle?

You can manually integrate the giggsey/libphonenumber-for-php library by installing it via Composer, then creating custom validators and form types in your Symfony application. This approach requires more code but avoids bundle dependencies and legacy issues.

PhoneNumberBundle vs using libphonenumber-php directly?

PhoneNumberBundle saves time by pre-integrating libphonenumber with Symfony components like forms and Doctrine, but if you need lightweight control or aren't using Symfony's full stack, direct library usage is simpler and avoids bundle overhead. The bundle is best for rapid development in Symfony 2-4 ecosystems.

How to format a phone number in Twig with this bundle?

Use the provided Twig filter 'phone_number_format' with a constant like 'NATIONAL' or 'INTERNATIONAL'. For example: {{ myPhoneNumber|phone_number_format('NATIONAL') }} formats the number in national style. Refer to the bundle's templating section for more options and defaults.

What are the alternatives for Symfony 5+ phone number handling?

The primary alternative is odolbeau/phone-number-bundle, the maintained fork. Other options include manually integrating libphonenumber-php, using community bundles like 'symfony/libphonenumber' if available, or leveraging third-party APIs, but ensure they support your Symfony version and project needs.

Open-Awesome

phone-number-bundle

PHPv1.3.2

A Symfony bundle that integrates Google's libphonenumber for phone number parsing, validation, formatting, and storage.

GitHub

455 stars145 forks0 contributors

What is phone-number-bundle?

PhoneNumberBundle is a Symfony bundle that integrates Google's libphonenumber library into Symfony applications. It solves the problem of handling international phone numbers by providing tools for parsing, validating, formatting, and storing phone numbers directly within the Symfony framework.

Target Audience

Symfony developers (versions 2-4) who need to handle international phone numbers in their applications, particularly those building forms, APIs, or systems requiring validated phone number data.

Value Proposition

Developers choose this bundle because it provides a seamless, native Symfony integration of the industry-standard libphonenumber library, eliminating the need to manually wire services and offering out-of-the-box support for forms, validation, Doctrine, and templating.

Overview

Integrates libphonenumber into your Symfony2-Symfony4 application

Use Cases

Best For

Validating international phone numbers in Symfony form submissions
Storing formatted phone numbers in a database using Doctrine
Displaying phone numbers in different formats (E.164, national, international) in Twig templates
Building forms with country-specific phone number input widgets
Serializing phone number objects in APIs using JMS Serializer
Checking phone number types (e.g., mobile, landline) within application logic

Not Ideal For

Projects using Symfony 5 or higher, as it only supports up to Symfony 4
Teams needing active maintenance and security updates, since the project is abandoned
Applications that avoid additional bundle dependencies like JMS Serializer or Doctrine Bundle for lightweight setups
Developers prioritizing modern PHP features or compatibility with latest library versions

Pros & Cons

Pros

Seamless Symfony Integration

Wraps libphonenumber functionality into native Symfony components like form types (e.g., PhoneNumberType with country choice widgets) and validation constraints, reducing boilerplate code.

Robust Doctrine Support

Provides a custom DBAL type ('phone_number') for persisting phone number objects as E.164 strings, with automatic schema handling and serialization integration for databases.

Extensive Templating Tools

Includes Twig filters (e.g., phone_number_format) and PHP helpers for formatting and type-checking phone numbers in templates, simplifying display logic.

Service Exposure Flexibility

Exposes advanced libphonenumber services (e.g., geocoding, carrier mapping) as Symfony services, allowing direct access to features like timezone lookup without manual wiring.

Cons

Abandoned and Outdated

The README states it's abandoned in favor of a fork (odolbeau/phone-number-bundle), meaning no updates, bug fixes, or support for newer Symfony versions, posing a maintenance risk.

Limited Symfony Version Support

Only compatible with Symfony 2 through 4, making it unsuitable for modern Symfony projects (5+), forcing migration or legacy lock-in.

Dependency-Heavy Features

Full functionality requires optional bundles like JMS Serializer Bundle for serialization and Doctrine Bundle for persistence, adding complexity and potential compatibility issues in minimal setups.

Frequently Asked Questions

Related Projects

LiipImagineBundle

Symfony Bundle to assist in image manipulation using the imagine library

Stars1,706

Forks383

Last commit1 month ago

OneupUploaderBundle

This Symfony bundle provides a server implementation for handling single and multiple file uploads using either FineUploader, jQuery File Uploader, YUI3 Uploader, Uploadify, FancyUpload, MooUpload, Plupload or Dropzone. Features include chunked uploads, orphanages, Gaufrette and Flysystem support.

Stars606

Forks173

Last commit2 months ago

APYDataGridBundle

Symfony Datagrid Bundle

Stars492

Forks339

Last commit1 year ago

EightPointsGuzzleBundle

⛽️ Integrates Guzzle 6.x, a PHP HTTP Client, into Symfony

Stars446

Forks70

Last commit5 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub