gustavobarbosa/libphonenumber-for-php7

PHP Port of Google's libphonenumber

8.13.56 2025-05-27 19:24 UTC

Requires

• php: ^7.4|^8.0
• giggsey/locale: ^2.0
• symfony/polyfill-mbstring: ^1.17

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.64
• pear/pear-core-minimal: ^1.10
• pear/pear_exception: ^1.0
• pear/versioncontrol_git: ^0.7
• phing/phing: ^3.0
• php-coveralls/php-coveralls: ^2.0
• phpunit/phpunit: ^9.6
• symfony/console: ^v5.2
• symfony/var-exporter: ^5.2

Replaces

• giggsey/libphonenumber-for-php-lite: 8.13.56

Apache-2.0

• Joshua Gigg
• Gustavo Barbosa

• geocoding
• geolocation
• validation
• mobile
• phonenumber
• libphonenumber

README

Correto. Isso precisa estar muito claro no README. Segue o README ajustado com essa informação:

libphonenumber-for-php (BR Fork)

Sobre

Este projeto é um fork da biblioteca giggsey/libphonenumber-for-php, baseado na versão 8.13.55.

O objetivo deste fork é:

• Manter compatibilidade com PHP 7.
• Focar em atualizações, correções e melhorias específicas para números do Brasil (BR).
• Realizar manutenção e pequenos ajustes necessários para uso em sistemas legados que ainda utilizam PHP 7.

Drop-in Replacement

Este projeto é um drop-in replacement para o pacote giggsey/libphonenumber-for-php.

• Usa o mesmo namespace (libphonenumber).
• Código, classes e interfaces permanecem iguais.
• Para utilizá-lo, é necessário remover o pacote original do seu composer.json e instalar este fork no lugar.

Exemplo:

composer remove giggsey/libphonenumber-for-php
composer require seuvendor/libphonenumber

Após isso, não é necessário alterar nenhum use, namespace ou código da sua aplicação.

Aviso

Este projeto não é afiliado, endossado ou mantido pelos autores originais do projeto giggsey/libphonenumber-for-php nem pelo projeto oficial libphonenumber do Google. Trata-se de uma iniciativa independente para manutenção em contexto específico.

Instalação

Via Composer:

composer require gustavohmbarbosa/libphonenumber7

Requisitos

• PHP >=7.0
• Extensões padrão do PHP (mbstring, intl recomendada)

Uso básico

<?php

use libphonenumber\PhoneNumberUtil;
use libphonenumber\PhoneNumberFormat;

require 'vendor/autoload.php';

$phoneUtil = PhoneNumberUtil::getInstance();

try {
    $numberProto = $phoneUtil->parse("(11) 91234-5678", "BR");
    if ($phoneUtil->isValidNumber($numberProto)) {
        echo $phoneUtil->format($numberProto, PhoneNumberFormat::E164);
    } else {
        echo "Número inválido";
    }
} catch (\libphonenumber\NumberParseException $e) {
    echo "Erro ao processar número: " . $e->getMessage();
}

Foco deste fork

• Correções e ajustes específicos para numeração brasileira.
• Atualização contínua dos dados de prefixos, operadoras e validações do Brasil.
• Manutenção da compatibilidade com projetos legados rodando PHP 7.

Contribuição

Contribuições são bem-vindas, especialmente em relação a:

• Dados e regras atualizadas para telefonia no Brasil.
• Correções de bugs.
• Melhorias de performance.

Abra uma issue ou envie um pull request.

Licença

Licenciado sob a Licença Apache 2.0. Consulte o arquivo para mais informações.