Add PHP8 compatibility, Add new service:engagement action

Author: miklinux

README.md

@@ -22,6 +22,7 @@ A simple [OVH API](https://api.ovh.com/console/) client for managing OVH infrast
 - Perform IPMI reset
 - Request hardware reboot
 - Manage service renewal
+- Manage service engagement
 
 **vRack**
 - List associated servers
@@ -44,7 +45,7 @@ A simple [OVH API](https://api.ovh.com/console/) client for managing OVH infrast
 
 ## Requirements
 
-* PHP >= 7.3
+* PHP >= 8
 * PHP gmp extension (used by [rlanvin/php-ip](https://github.com/rlanvin/php-ip))
 * [Composer](https://getcomposer.org)
 
@@ -56,11 +57,6 @@ $ cd php-ovh-cli
 $ composer update
 ```
 
-Also works on PHP8, but with some workaround:
-```
-$ composer update --ignore-platform-reqs
-```
-
 If you prefer to have a standalone executable, then create a PHAR package:
 ```
 $ ./create-phar.php

composer.json

@@ -1,9 +1,9 @@
 {
     "require": {
         "ovh/ovh": "^2.0",
-        "rlanvin/php-ip": "^2.0",
-        "ulrichsg/getopt-php": "^3.2",
-        "phpfastcache/phpfastcache": "^7.1"
+        "rlanvin/php-ip": "^3.0",
+        "ulrichsg/getopt-php": "^4.0",
+        "phpfastcache/phpfastcache": "^8.0"
     },
     "autoload": {
         "psr-4": {

src/Command/Service/Engagement.php

@@ -0,0 +1,91 @@
+<?php
+
+namespace OvhCli\Command\Service;
+
+use GetOpt\GetOpt;
+use GetOpt\Operand;
+use GetOpt\Option;
+use OvhCli\Cli;
+
+class Engagement extends \OvhCli\Command
+{
+  public $shortDescription = 'Manages dedicated servers billing engagement';
+
+  public function __construct()
+  {
+    parent::__construct($this->getName(), [$this, 'handle']);
+
+    $this->addOperands([
+      Operand::create('server', Operand::MULTIPLE)
+        ->setDescription('Server name'),
+    ]);
+
+    $this->addOptions([
+      Option::create('a', 'all', GetOpt::NO_ARGUMENT)
+        ->setDescription('Run against all servers'),
+      Option::create(null, 'on', GetOpt::NO_ARGUMENT)
+        ->setDescription('Enable service billing engagement'),
+      Option::create(null, 'off', GetOpt::NO_ARGUMENT)
+        ->setDescription('Disable service billing engagement'),
+      Option::create(null, 'enabled-only', GetOpt::NO_ARGUMENT)
+        ->setDescription('Shows enabled services only'),
+    ]);
+  }
+
+  public function handle(GetOpt $getopt)
+  {
+    $servers = $getopt->getOption('all') ?
+      $this->ovh()->getServers() :
+      $getopt->getOperand('server');
+
+    $on = (bool) $getopt->getOption('on');
+    $off = (bool) $getopt->getOption('off');
+    $show_enabled_only = (bool) $getopt->getOption('enabled-only');
+
+    if ($on && $off) {
+      return $this->missingArgument($getopt, 'ERROR: --on and --off options should be enabled exclusively');
+    }
+
+    if (empty($servers)) {
+      echo $getopt->getHelpText();
+      exit();
+    }
+    
+    $data = [];
+    foreach ($servers as $server) {
+      $server = $this->resolve($server);
+      $details = $this->ovh()->getServerDetails($server);
+      $service = $this->ovh()->getServerServiceInfo($server);
+      $service_id = $service['serviceId'];
+      try {
+        $commitment = $this->ovh()->getServiceBillingEngagement($service_id);
+        $strategy = $commitment['endRule']['strategy'];
+        $engagement_enabled = ($strategy == 'REACTIVATE_ENGAGEMENT');
+      } catch (\Exception $e) {
+        // Server doesn't support billing engagement
+        continue;
+      }
+      
+      if ($engagement_enabled && $off) {
+        Cli::out('Disabling server engagement on %s ...', $details['reverse']);
+        $this->ovh()->setServiceBillingEngagement($service_id, false);
+      } elseif (!$engagement_enabled && $on) {
+        Cli::out('Enabling server engagement on %s ...', $details['reverse']);
+        $this->ovh()->setServiceBillingEngagement($service_id, true);
+      } elseif (!$on && !$off) {
+        if (!$engagement_enabled && $show_enabled_only) {
+          continue;
+        }
+        $data[$server] = [
+          'reverse' => $details['reverse'],
+          'enabled' => $engagement_enabled,
+          'period'  => $commitment['currentPeriod'],
+        ];
+      }
+    }
+
+    if (!empty($data)) {
+      Cli::format($data);
+    }
+  }
+}

src/Command/Service/Info.php

@@ -38,6 +38,7 @@ public function handle(GetOpt $getopt)
     } catch (\Exception $e) {
       Cli::error($e);
     }
+    ksort($service);
     Cli::format($service, [
       'maxSize' => 40,
       'grep'    => (bool) $getopt->getOption('grep'),

src/Ovh.php

@@ -566,6 +566,21 @@ public function replyToSupportTicket($id, $body)
     ]);
   }
 
+  public function getServiceBillingEngagement($id)
+  {
+    return $this->get("/services/{$id}/billing/engagement");
+  }
+
+  public function setServiceBillingEngagement($id, bool $value)
+  {
+    $res = $this->put("/services/{$id}/billing/engagement/endRule", [
+      'strategy' => ($value === true) ?
+        'REACTIVATE_ENGAGEMENT' : 
+        'STOP_ENGAGEMENT_FALLBACK_DEFAULT_PRICE',
+    ]);
+    return $res;
+  }
+
   protected function shouldCache($url)
   {
     if (self::$disableCache) {