FilesExpand file tree

 patch-1

/

PostcodeFormatter.php

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

80 lines (65 loc) · 2.09 KB

 patch-1

/

PostcodeFormatter.php

Copy path

Top

File metadata and controls

• Code
• Blame

80 lines (65 loc) · 2.09 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

<?php

declare(strict_types=1);

namespace Brick\Postcode;

/**

* Formats and validates postcodes.

*/

class PostcodeFormatter

{

/**

* The country postcode formatters, indexed by country code.

*

* @var CountryPostcodeFormatter[]

*/

private $formatters = [];

/**

* Formats the given postcode.

*

* The country code and postcode are case insensitive.

* The input postcode is allowed to contain space or dash separators, possibly misplaced.

*

* @param string $country The ISO 3166-1 alpha-2 country code.

* @param string $postcode The postcode to format.

*

* @return string

*

* @throws UnknownCountryException

* @throws InvalidPostcodeException

*/

public function format(string $country, string $postcode) : string

{

$postcode = str_replace([' ', '-'], '', $postcode);

$postcode = strtoupper($postcode);

$formatter = $this->getFormatter($country);

if (preg_match('/^[A-Z0-9]+$/', $postcode) !== 1) {

throw new InvalidPostcodeException('Invalid postcode: ' . $postcode);

}

$formatted = $formatter->format($postcode);

if ($formatted === null) {

throw new InvalidPostcodeException('Invalid postcode: ' . $postcode);

}

return $formatted;

}

/**

* @param string $country

*

* @return CountryPostcodeFormatter

*

* @throws UnknownCountryException

*/

private function getFormatter(string $country) : CountryPostcodeFormatter

{

if (isset($this->formatters[$country])) {

return $this->formatters[$country];

}

if (preg_match('/^[a-zA-Z]{2}$/', $country) !== 1) {

throw new UnknownCountryException('Unknown country: ' . $country);

}

$country = strtoupper($country);

$class = __NAMESPACE__ . '\\Formatter\\' . $country . 'Formatter';

if (! class_exists($class)) {

throw new UnknownCountryException('Unknown country: ' . $country);

}

return $this->formatters[$country] = new $class();

}

}