19098923587

Committed 05 Nov 2025 10:27AM UTC coverage: 81.782% (-17.6%) from 99.396%

Build # 19098923587

Build Type

Pull #19

github

Committed by

web-flow

Commit Message

Merge 79bf98178 into 8ef37e5aa

Pull Request Pull Request #19: Add hint to formatter, so a hint can be provided if postcode is invalid

Run Details

5 of 184 new or added lines in 183 files covered. (2.72%)

2 existing lines in 1 file now uncovered.

826 of 1010 relevant lines covered (81.78%)

15.02 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

85.71

/src/Formatter/AFFormatter.php

<?php

declare(strict_types=1);

namespace Brick\Postcode\Formatter;

use Brick\Postcode\CountryPostcodeFormatter;

use function preg_match;
use function substr;

/**
 * Validates and formats postcodes in Afghanistan.
 *
 * Postcodes consist of 4 digits, without separator.
 *
 * The first two digits (ranging from 10–43) correspond to the province,
 * while the last two digits correspond either to the city/delivery zone (range 01–50)
 * or to the district/delivery zone (range 51–99).
 *
 * @see https://en.wikipedia.org/wiki/List_of_postal_codes
 * @see https://en.wikipedia.org/wiki/Postal_codes_in_Afghanistan
 */
final class AFFormatter implements CountryPostcodeFormatter
{
    public function hint(): string
    {
        return 'Postcodes consist of 4 digits, without separator.';
    }

    public function format(string $postcode): ?string
    {
        if (preg_match('/^[0-9]{4}$/', $postcode) !== 1) {
            return null;
        }

        $province = substr($postcode, 0, 2);

        if ($province < '10' || $province > '43') {
            return null;
        }

        return $postcode;
    }
}

1	<?php
2
3	declare(strict_types=1);
4
5	namespace Brick\Postcode\Formatter;
6
7	use Brick\Postcode\CountryPostcodeFormatter;
8
9	use function preg_match;
10	use function substr;
11
12	/**
13	* Validates and formats postcodes in Afghanistan.
14	*
15	* Postcodes consist of 4 digits, without separator.
16	*
17	* The first two digits (ranging from 10–43) correspond to the province,
18	* while the last two digits correspond either to the city/delivery zone (range 01–50)
19	* or to the district/delivery zone (range 51–99).
20	*
21	* @see https://en.wikipedia.org/wiki/List_of_postal_codes
22	* @see https://en.wikipedia.org/wiki/Postal_codes_in_Afghanistan
23	*/
24	final class AFFormatter implements CountryPostcodeFormatter
25	{
26	public function hint(): string
27	{
NEW 28	return 'Postcodes consist of 4 digits, without separator.';	×
29	}
30
31	public function format(string $postcode): ?string
32	{
33	if (preg_match('/^[0-9]{4}$/', $postcode) !== 1) {	19✔
34	return null;	12✔
35	}
36
37	$province = substr($postcode, 0, 2);	7✔
38
39	if ($province < '10' \|\| $province > '43') {	7✔
40	return null;	4✔
41	}
42
43	return $postcode;	3✔
44	}
45	}

brick / postcode / 19098923587

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous