Release v3.0.0 PHP SDK

Author: MudassarTariq

.github/workflows/php.yml

@@ -0,0 +1,37 @@
+name: PHP
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        php-version: ['8.1', '8.2', '8.3']
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php-version }}
+          extensions: curl
+          coverage: none
+
+      - name: Validate Composer
+        run: composer validate
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-interaction
+
+      - name: Run unit tests
+        run: ./vendor/bin/phpunit --exclude-group live

.gitignore

@@ -5,12 +5,14 @@ composer.phar
 
 # Commit your application's lock file https://getcomposer.org/doc/01-basic-usage.md#commit-your-composer-lock-file-to-version-control
 # You may choose to ignore a library lock file http://getcomposer.org/doc/02-libraries.md#lock-file
-# composer.lock
+/composer.lock
 
 # php-cs-fixer cache
 .php_cs.cache
 .php-cs-fixer.cache
 
 # PHPUnit cache
 .phpunit.result.cache
+.phpunit.cache/
+/coverage/
 /.idea/

.php-cs-fixer.dist.php

@@ -1,14 +1,11 @@
 <?php
 
-/**
- * @generated
- * @link https://github.com/FriendsOfPHP/PHP-CS-Fixer/blob/HEAD/doc/config.rst
- */
 $finder = PhpCsFixer\Finder::create()
-    ->in(__DIR__)
+    ->in([
+        __DIR__ . '/lib',
+        __DIR__ . '/tests',
+    ])
     ->exclude('vendor')
-    ->exclude('test')
-    ->exclude('tests')
 ;
 
 $config = new PhpCsFixer\Config();

.travis.yml

@@ -0,0 +1,8 @@
+# Changelog
+
+## 3.0.0
+
+- Replaced the old multi-API SDK with the new PHP SDK for the IPGeolocation.io IP Location API.
+- Added typed and raw single lookup methods for `/v3/ipgeo`.
+- Added typed and raw bulk lookup methods for `/v3/ipgeo-bulk`.
+- Added request validation, metadata parsing, and explicit error mapping.

CHANGELOG.md

@@ -1,39 +1,67 @@
 {
     "name": "ipgeolocation/ipgeolocation-php-sdk",
-    "description": "Ipgeolocation provides a set of APIs to make ip based decisions.",
+    "description": "Official PHP SDK for the IPGeolocation.io IP Location API with single and bulk lookup support.",
     "keywords": [
         "ipgeolocation",
-        "ip-tools",
         "geolocation",
+        "ip",
+        "ip-location",
+        "ip-geolocation",
+        "ip-lookup",
         "php",
         "sdk",
-        "rest",
-        "api"
+        "api",
+        "ipv4",
+        "ipv6",
+        "domain-lookup",
+        "hostname",
+        "security",
+        "abuse",
+        "asn",
+        "timezone",
+        "user-agent",
+        "bulk-lookup"
     ],
     "homepage": "https://ipgeolocation.io",
+    "support": {
+        "docs": "https://ipgeolocation.io/documentation/ip-location-api.html",
+        "issues": "https://github.com/IPGeolocation/ip-geolocation-api-php/issues",
+        "source": "https://github.com/IPGeolocation/ip-geolocation-api-php"
+    },
     "license": "Apache-2.0",
     "authors": [
         {
-            "name": "Ipgeolocation",
+            "name": "IPGeolocation.io",
             "homepage": "https://ipgeolocation.io"
         }
     ],
     "require": {
         "php": "^8.1",
         "ext-curl": "*",
         "ext-json": "*",
-        "ext-mbstring": "*",
-        "guzzlehttp/guzzle": "^7.3",
-        "guzzlehttp/psr7": "^1.7 || ^2.0"
+        "guzzlehttp/guzzle": "^7.8"
     },
     "require-dev": {
-        "phpunit/phpunit": "^12.2",
-        "friendsofphp/php-cs-fixer": "^3.5"
+        "friendsofphp/php-cs-fixer": "^3.64",
+        "phpunit/phpunit": "^10.5"
     },
     "autoload": {
-        "psr-4": { "Ipgeolocation\\Sdk\\" : "lib/" }
+        "psr-4": {
+            "Ipgeolocation\\Sdk\\": "lib/"
+        },
+        "files": [
+            "lib/Exceptions.php",
+            "lib/Models.php"
+        ]
     },
     "autoload-dev": {
-        "psr-4": { "Ipgeolocation\\Sdk\\Test\\" : "test/" }
+        "psr-4": {
+            "Ipgeolocation\\Sdk\\Test\\": "tests/ip_location/"
+        }
+    },
+    "scripts": {
+        "test": "vendor/bin/phpunit",
+        "test:unit": "vendor/bin/phpunit --exclude-group live",
+        "test:live": "vendor/bin/phpunit --group live"
     }
 }