refactor: Modernize PHP SDK with enhanced type safety and new DTO models

New Features:
- Introduced comprehensive DTO models for campaigns, variations, targeting, and troubleshooting
- Added Types trait for centralized type definitions with PHPStan-level type safety
- Implemented ContainerException for better error handling
- Enhanced visitor strategies with context updates and troubleshooting support

Improvements:
- Removed deprecated FlagshipLogManager8 class
- Updated ModificationsDTO value type from mixed to array for consistency
- Refactored ContainerInterface with improved type specifications
- Updated HttpClient with better error handling and type safety
- Enhanced MurmurHash, Curl, and logging interfaces for clarity
- Added utility methods in Helper trait for array operations
- Improved flag activation with flag key inclusion in hits
- Updated return types across DecisionManagerAbstract and various interfaces

Testing:
- Refactored test suite to use BaseTestCase for consistency
- Added comprehensive unit tests for new DTO classes
- Enhanced test coverage for FlagshipLogManager, HttpClient, and strategy classes
- Improved test readability with standardized formatting and assertions

Configuration:
- Updated PHPStan configuration with new rules and future compatibility
- Enhanced composer.json with additional static analysis tools
- Refined phpstan.neon and added phpstan-future.neon

Author: Heihokon

.gitignore

@@ -9,3 +9,5 @@ flagship
 /.phpunit.cache
 demo-test.php
 docker-compose.demo.yml
+sample.php
+sample.php

.vscode/settings.json

@@ -8,4 +8,5 @@
   },
   "php-cs-fixer.executablePath": "./vendor/bin/php-cs-fixer",
   "php-cs-fixer.onsave": true,
+  "intelephense.environment.phpVersion": "8.1.0",
 }

composer.json

@@ -2,7 +2,11 @@
   "name": "flagship-io/flagship-php-sdk",
   "type": "library",
   "description": "Flagship PHP SDK",
-  "keywords": ["flagship", "sdk", "flagship-php"],
+  "keywords": [
+    "flagship",
+    "sdk",
+    "flagship-php"
+  ],
   "homepage": "https://github.com/flagship-io/flagship-php-sdk",
   "authors": [
     {
@@ -18,7 +22,12 @@
   },
   "require-dev": {
     "squizlabs/php_codesniffer": "^3.10",
-    "phpunit/phpunit": "^9.6"
+    "phpunit/phpunit": "^9.6",
+    "phpstan/phpstan": "^2.1",
+    "phpstan/phpstan-deprecation-rules": "^2.0",
+    "phpstan/phpstan-strict-rules": "^2.0",
+    "phpstan/phpstan-phpunit": "^2.0",
+    "php-mock/php-mock-phpunit": "^2.14"
   },
   "autoload": {
     "psr-4": {
@@ -31,8 +40,19 @@
     }
   },
   "scripts": {
+
     "test": "phpunit",
+    "test:all": [
+      "@phpstan:all",
+      "phpunit"
+    ],
     "check-style": "phpcs --standard=PSR12 -n src tests",
-    "fix-style": "phpcbf  --standard=phpcs.xml src tests"
+    "fix-style": "phpcbf  --standard=phpcs.xml src tests",
+    "phpstan": "phpstan analyse --configuration=phpstan.neon --memory-limit=512M",
+    "phpstan:future": "phpstan analyse --configuration=phpstan-future.neon --memory-limit=512M",
+    "phpstan:all": [
+      "@phpstan",
+      "@phpstan:future"
+    ]
   }
 }