libphonenumber-for-php v9 changes

 - PHP 8.1 min
 - PHPStan level 7
 - Strong types throughout

Author: giggsey

.gitattributes

@@ -4,14 +4,11 @@ tests/ export-ignore
 .editorconfig export-ignore
 .gitattributes export-ignore
 .gitignore export-ignore
-.styleci.yml export-ignore
-.travis.yml export-ignore
+.php-cs-fixer.dist.php export-ignore
 build.xml export-ignore
-libphonenumber-for-php.spec export-ignore
 phpunit.xml.dist export-ignore
-phpunit export-ignore
 .github/ export-ignore
 src/CountryCodeToRegionCodeMapForTesting.php export-ignore
-
+phpstan.neon.dist export-ignore
 
 * text=auto

.github/workflows/sast.yml

@@ -0,0 +1,31 @@
+name: "SAST"
+
+on:
+  push:
+    branches:
+      - 'master'
+    paths-ignore:
+      - 'docs/**'
+  pull_request:
+    paths-ignore:
+      - 'docs/**'
+
+jobs:
+  phpstan:
+    name: "PHPStan"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup PHP, with composer and extensions
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.3
+
+      - uses: "ramsey/composer-install@v3"
+        with:
+          dependency-versions: highest
+
+      - name: Run PHPStan
+        run: "composer run-script phpstan"

.php-cs-fixer.dist.php

@@ -9,7 +9,7 @@
 return $config->setRules(
     [
         '@PER-CS2.0' => true,
-        '@PHP74Migration' => true,
+        '@PHP81Migration' => true,
         'single_quote' => true,
         'no_unused_imports' => true,
         'no_superfluous_phpdoc_tags' => [
@@ -18,7 +18,19 @@
             'remove_inheritdoc' => true,
         ],
         'phpdoc_trim' => true,
+        'declare_strict_types' => true,
+        'php_unit_attributes' => true,
+        '@PHPUnit100Migration:risky' => true,
+        'global_namespace_import' => [
+            'import_classes' => true,
+            'import_constants' => true,
+            'import_functions' => true,
+        ],
+        'no_empty_phpdoc' => true,
+        'phpdoc_align' => ['align' => 'left'],
+        'phpdoc_types' => true,
     ]
 )
-->setParallelConfig(PhpCsFixer\Runner\Parallel\ParallelConfigFactory::detect())
-->setFinder($finder);
+    ->setRiskyAllowed(true)
+    ->setParallelConfig(PhpCsFixer\Runner\Parallel\ParallelConfigFactory::detect())
+    ->setFinder($finder);

README.md

@@ -26,7 +26,7 @@ A PHP library for parsing, formatting, storing and validating international phon
 
 ## Installation
 
-PHP versions 7.4 to PHP 8.4 are currently supported.
+PHP versions 8.1 to 8.4 are currently supported.
 
 The PECL [mbstring](http://php.net/mbstring) extension is required.
 
@@ -44,6 +44,10 @@ If you do not use composer, ensure that you also load any dependencies that this
 
 If you only want to make use of the core PhoneNumber Util functionality, you can use [giggsey/libphonenumber-for-php-lite](https://github.com/giggsey/libphonenumber-for-php-lite), which offers a much smaller package size.
 
+### PHP Version Policy
+
+This library will be updated to use [supported versions of PHP](https://www.php.net/supported-versions.php) without major version bumps.
+
 ## Documentation
 
  - [PhoneNumber Util](docs/PhoneNumberUtil.md)

build/BuildApplication.php

@@ -1,12 +1,17 @@
 <?php
 
+declare(strict_types=1);
+
 namespace libphonenumber\buildtools;
 
 use libphonenumber\buildtools\Commands\BuildMetadataPHPFromXMLCommand;
 use libphonenumber\buildtools\Commands\GeneratePhonePrefixDataCommand;
 use libphonenumber\buildtools\Commands\GenerateTimeZonesMapDataCommand;
 use Symfony\Component\Console\Application;
 
+/**
+ * @internal
+ */
 class BuildApplication extends Application
 {
     public const VERSION = '5';