Remove illuminate/collections dependency and refactor to native PHP array functions

Add changelog and upgrade guide.

Author: LKaemmerling

CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 3.0.0-alpha.1 (18.03.2026)
+
+### Breaking Changes
+* Minimum PHP version is now 8.2.
+* Removed dependency `illuminate/collections` - Replaced all `collect()` usages with native PHP array functions.
+* Method `delete()` now returns `?APIResponse` instead of `bool` across all models.
+* Changed various method signatures to use native PHP types and improved type hinting.
+
+### Features
+* Improved support for Managed Certificates.
+* Improved support for Firewall label selectors.
+* Improved support for Primary IPs.
+* Improved support for Placement Groups.
+* Improved support for Load Balancers.
+
+### Internal
+* General code cleanup and modernization.
+
 ## 2.5.0 (12.10.2021)
 
 * Upgrade to GitHub-native Dependabot by @dependabot-preview in https://github.com/LKDevelopment/hetzner-cloud-php-sdk/pull/73

README.md

@@ -33,7 +33,11 @@ You can just run `phpunit`. The whole library is based on unit tests and sample
 
 ### Changelog
 
-Please see [CHANGELOG](https://github.com/LKDevelopment/hetzner-cloud-php-sdk/releases) for more information what has changed recently.
+Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
+
+### Upgrade Guide
+
+Please see [Upgrade to v3.0](UPGRADE-3.0.md) for more information how to upgrade from v2.x.
 
 
 ### Security

UPGRADE-3.0.md

@@ -0,0 +1,76 @@
+# Upgrade Guide: v2.x to v3.0
+
+This guide provides instructions for upgrading your application from `hetzner-cloud-php-sdk` version 2.x to 3.0.
+
+## Breaking Changes
+
+### PHP Version Requirement
+- **Requirement:** PHP 8.2 or higher is now required.
+- **Action:** Ensure your server or environment is running PHP 8.2+.
+
+### Removal of `illuminate/collections`
+The dependency on `illuminate/collections` has been removed to reduce the library's footprint and avoid dependency conflicts. All internal usages of `collect()` have been replaced with native PHP array functions.
+
+- **Impact:** If your application relied on the SDK returning Laravel Collections, this will no longer happen.
+- **Action:** Use native PHP array functions like `array_map()`, `array_filter()`, or wrap the returned arrays in a collection yourself if you still need them.
+
+**Before (v2.x):**
+```php
+// Some internal methods or if you were using collect() on SDK results
+$names = collect($hetznerClient->servers()->all())->map(fn($s) => $s->name);
+```
+
+**After (v3.0):**
+```php
+// Results are now always native arrays
+$servers = $hetznerClient->servers()->all();
+$names = array_map(fn($s) => $s->name, $servers);
+
+// If you want to keep using Collections in your project:
+// composer require illuminate/collections
+$names = collect($hetznerClient->servers()->all())->map(fn($s) => $s->name);
+```
+
+### `delete()` Method Return Type Change
+The `delete()` method on all resource models now returns an `APIResponse` object (or `null`) instead of a `boolean`. This provides more information about the API response, such as the `Action` created by the deletion.
+
+- **Impact:** Any code checking for `if ($model->delete())` will still work as `APIResponse` is truthy, but it is better to update your logic if you were relying on the boolean result.
+
+**Before (v2.x):**
+```php
+$success = $server->delete(); // returned bool
+if ($success) {
+    // ...
+}
+```
+
+**After (v3.0):**
+```php
+$response = $server->delete(); // returns ?APIResponse
+if ($response !== null) {
+    $action = $response->action; // You can now access the action
+    // ...
+}
+```
+
+### Native Type Hints
+Many method signatures have been updated to include native PHP 8.1 type hints. This improves IDE support and static analysis.
+
+- **Impact:** If you have extended SDK classes and overridden methods, you may need to update your method signatures to match the new type hints to avoid PHP fatal errors.
+
+---
+
+## New Features
+Version 3.0 also introduces several new features and improvements:
+- Support for **Primary IPs**.
+- Support for **Placement Groups**.
+- Support for **Firewalls** (including label selectors).
+- Improved support for **Load Balancers**.
+- Improved support for **Managed Certificates**.
+
+## Summary for LLMs
+- Minimum PHP: `8.2`
+- Dependency removed: `illuminate/collections`
+- `delete()` returns: `?LKDev\HetznerCloud\APIResponse` (was `bool`)
+- All list methods return: `array`
+- Models use native type hints for parameters and return types.

composer.json

@@ -8,11 +8,10 @@
     "hetzner cloud",
     "cloud php library"
   ],
-  "require": {
-    "php": "^8.1",
+    "require": {
+    "php": "^8.2",
     "ext-json": "*",
-    "guzzlehttp/guzzle": "^6.3|^7.0",
-    "illuminate/collections": "^5.5|^v6.18|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0|^13.0"
+    "guzzlehttp/guzzle": "^6.3|^7.0"
   },
   "require-dev": {
     "phpunit/phpunit": "^7.0|^8.5.5|^9.0",

src/HetznerAPIClient.php

@@ -32,7 +32,7 @@ class HetznerAPIClient
     /**
      * Version of the API Client.
      */
-    const VERSION = '3.0.0-alpha.1';
+    const VERSION = '3.0.0';
 
     const MAX_ENTITIES_PER_PAGE = 50;
 

src/Models/Actions/Actions.php

@@ -80,9 +80,9 @@ public function getByName(string $name)
      */
     public function setAdditionalData($input)
     {
-        $this->actions = collect($input)->map(function ($action, $key) {
+        $this->actions = array_map(function ($action) {
             return Action::parse($action);
-        })->toArray();
+        }, $input);
 
         return $this;
     }

src/Models/Certificates/Certificates.php

@@ -122,9 +122,9 @@ public function list(?RequestOpts $requestOpts = null): ?APIResponse
      */
     public function setAdditionalData($input)
     {
-        $this->certificates = collect($input)->map(function ($certificate, $key) {
+        $this->certificates = array_map(function ($certificate) {
             return Certificate::parse($certificate);
-        })->toArray();
+        }, $input);
 
         return $this;
     }

src/Models/Datacenters/Datacenters.php

@@ -120,9 +120,9 @@ public function getByName(string $name): ?Datacenter
      */
     public function setAdditionalData($input)
     {
-        $this->datacenters = collect($input)->map(function ($datacenter, $key) {
+        $this->datacenters = array_map(function ($datacenter) {
             return Datacenter::parse($datacenter);
-        })->toArray();
+        }, $input);
 
         return $this;
     }

src/Models/Firewalls/Firewall.php

@@ -147,18 +147,18 @@ public function setRules(array $rules): ?ApiResponse
     {
         $response = $this->httpClient->post('firewalls/'.$this->id.'/actions/set_rules', [
             'json' => [
-                'rules' => collect($rules)->map(function ($r) {
+                'rules' => array_map(function ($r) {
                     return $r->toRequestSchema();
-                }),
+                }, $rules),
             ],
         ]);
         if (! HetznerAPIClient::hasError($response)) {
             $payload = json_decode((string) $response->getBody());
 
             return APIResponse::create([
-                'actions' => collect($payload->actions)->map(function ($action) {
+                'actions' => array_map(function ($action) {
                     return Action::parse($action);
-                })->toArray(),
+                }, $payload->actions),
             ], $response->getHeaders());
         }
 
@@ -198,18 +198,18 @@ public function applyToResources(array $resources): ?APIResponse
     {
         $response = $this->httpClient->post('firewalls/'.$this->id.'/actions/apply_to_resources', [
             'json' => [
-                'apply_to' => collect($resources)->map(function ($r) {
+                'apply_to' => array_map(function ($r) {
                     return $r->toRequestSchema();
-                }),
+                }, $resources),
             ],
         ]);
         if (! HetznerAPIClient::hasError($response)) {
             $payload = json_decode((string) $response->getBody());
 
             return APIResponse::create([
-                'actions' => collect($payload->actions)->map(function ($action) {
+                'actions' => array_map(function ($action) {
                     return Action::parse($action);
-                })->toArray(),
+                }, $payload->actions),
             ], $response->getHeaders());
         }
 
@@ -230,18 +230,18 @@ public function removeFromResources(array $resources): ?APIResponse
     {
         $response = $this->httpClient->post('firewalls/'.$this->id.'/actions/remove_from_resources', [
             'json' => [
-                'remove_from' => collect($resources)->map(function ($r) {
+                'remove_from' => array_map(function ($r) {
                     return $r->toRequestSchema();
-                }),
+                }, $resources),
             ],
         ]);
         if (! HetznerAPIClient::hasError($response)) {
             $payload = json_decode((string) $response->getBody());
 
             return APIResponse::create([
-                'actions' => collect($payload->actions)->map(function ($action) {
+                'actions' => array_map(function ($action) {
                     return Action::parse($action);
-                })->toArray(),
+                }, $payload->actions),
             ], $response->getHeaders());
         }
 

src/Models/Firewalls/Firewalls.php

@@ -134,9 +134,9 @@ public static function parse($input)
      */
     public function setAdditionalData($input)
     {
-        $this->firewalls = collect($input)->map(function ($firewall, $key) {
+        $this->firewalls = array_map(function ($firewall) {
             return Firewall::parse($firewall);
-        })->toArray();
+        }, $input);
 
         return $this;
     }
@@ -163,15 +163,15 @@ public function create(
             'name' => $name,
         ];
         if (! empty($rules)) {
-            $parameters['rules'] = collect($rules)->map(function ($r) {
+            $parameters['rules'] = array_map(function ($r) {
                 return $r->toRequestSchema();
-            });
+            }, $rules);
         }
 
         if (! empty($applyTo)) {
-            $parameters['apply_to'] = collect($applyTo)->map(function ($r) {
+            $parameters['apply_to'] = array_map(function ($r) {
                 return $r->toRequestSchema();
-            });
+            }, $applyTo);
         }
         if (! empty($labels)) {
             $parameters['labels'] = $labels;
@@ -184,9 +184,9 @@ public function create(
 
             return APIResponse::create([
                 'firewall' => Firewall::parse($payload->{$this->_getKeys()['one']}),
-                'actions' => collect($payload->actions)->map(function ($action) {
+                'actions' => array_map(function ($action) {
                     return Action::parse($action);
-                })->toArray(),
+                }, $payload->actions),
             ], $response->getHeaders());
         }