rebib/phonenumbersplitter

ハイフン無しの電話番号をハイフン付の形式に変換する

3.0.0 2026-07-04 10:12 UTC

Requires

• php: ^8.4.1
• symfony/yaml: ^8.1

Requires (Dev)

• phpunit/phpunit: ^12.5

mit

• Zhao

• 電話番号
• ハイフン無し
• ハイフン付

Published on Packagist.org on 2026-07-04 10:13 UTC

README

日本の電話番号を、ハイフン区切りの表記へ整形するためのライブラリです。

• 電話番号を「市外局番-市内局番-識別番号」に分割
• ハイフン無しの電話番号をハイフン付の形式に変換
• ハイフン付の電話番号をハイフン無しの形式に変換
• 緊急通報番号や携帯電話番号も含めて整形

Installation

You can install this plugin with Composer. Requires PHP 8.4.1+.

composer require rebib/phonenumbersplitter

Usage

基本的な使い方

use Rebib\Phonenumber\Splitter;

$provider = (new Splitter())->parse('0312345678');

ハイフン付きで取得する

echo $provider->getNumberWithHyphen();

03-1234-5678

ハイフン無しで取得する

echo $provider->getNumberWithoutHyphen();

0312345678

配列で取得する

print_r($provider->toArray());

Array
(
    [0] => 03
    [1] => 1234
    [2] => 5678
)

Usage examples

use Rebib\Phonenumber\Splitter;

$splitter = new Splitter();

echo $splitter->parse('110')->getNumberWithHyphen();
// 110

echo $splitter->parse('157')->getNumberWithHyphen();
// 157

echo $splitter->parse('05078273831')->getNumberWithHyphen();
// 050-7827-3831

echo $splitter->parse('08012345678')->getNumberWithHyphen();
// 080-1234-5678

echo $splitter->parse('031-234-5678')->getNumberWithHyphen();
// 03-1234-5678

Inspired by kennyj's article on splitting Japanese phone numbers.

Reference

• 総務省 電気通信番号指定状況