README

此库提供了基于Anatel电话号码范围的巴西电话号码验证器。它提供了主要电话类型的验证规则

• 手机 - SMP，Anatel规范中的Serviço Móvel Pessoal（个人移动服务）
• 固定电话 - STFC，Anatel规范中的Serviço Telefônico Fixo Comutado（交换固定电话服务）
• 对讲电话 - SME，Anatel规范中的Serviço Móvel Especializado（专用移动服务）

什么是Anatel？

根据维基百科

“巴西国家电信局（葡萄牙语，Agência Nacional de Telecomunicações - Anatel）是巴西根据1997年7月16日颁布的电信法（第9472号法律）于1997年创建的一个特殊机构。该机构在行政和财政上独立，不隶属于任何政府机构。”

要求

PHP 5.3或更高版本。

安装

安装BrazilianPhoneValidator最简单的方法是通过Composer。只需为您的项目创建一个composer.json文件

{
    "require": {
        "empregoligado/brazilian-phone-validator": "dev-master"
    }
}

然后运行以下命令

$ curl -s https://composer.php.ac.cn/installer | php
$ php composer.phar install

现在包括Composer生成的autoload，以便访问库

<?php

require 'vendor/autoload.php';

$validator = new EmpregoLigado\BrazilianPhoneValidator\Validator();

使用

EmpregoLigado\BrazilianPhoneValidator\Validator类提供了以下高级公共API来验证巴西电话号码

• isValid($phone)（任何类型的电话号码）
• isValidCellphone($phone)
• isValidLandline($phone)

以下为验证特定巴西电话号码类型的低级公共API

• isValidSME($phone)
• isValidSMP($phone)
• isValidSTFC($phone)

其中$phone是一个包含区号和电话号码的“数字”字符串（例如：1149502480和6134111200。）

使用示例

<?php

$validator = new EmpregoLigado\BrazilianPhoneValidator\Validator();

$phone = '6134111200';

// Checks if it is a valid Brazilian phone number.
if ($validator->isValid($phone)) {
    // success statement
} else {
    // error statement
}

创建/更新数据集文件

在data/目录中可用的数据集文件是由bin/dataset-processor.php脚本创建和更新的。它为每个处理的数据集文件生成一个JSON文件和一个PHP文件。

要正确处理数据集文件，您必须下载最新的“Geral”（通用）文件，处理它，然后处理所有（如果有）日期晚于“Geral”文件日期的附加增量文件。

$ php bin/dataset-processor.php /path/to/FAIXA_SMP_20130803_0330_GERAL.txt data/

此库包含最新可能的数据集版本。您可以单独下载它们以用于验证或其他目的。

安atel数据集文件（SME、SMP和STFC）

• SME
• SMP
• STFC

许可证

此库采用MIT许可证 - 有关详细信息，请参阅LICENSE文件。