Add password authentication support for SSH

Introduce optional password support in the Ssh class through the constructor and a new usePassword method. Updated README to document these changes and added relevant test cases.

README.md

@@ -86,6 +86,21 @@ Alternatively you can use the `usePort` function:
 ```php
 Ssh::create('user', 'host')->usePort($port);
 ```
+
+### Using a password
+
+You can use the constructor to specify a password to use.
+
+```php
+Ssh::create('user', 'host', port, 'password');
+```
+
+Alternatively you can use the `usePassword` function:
+
+```php
+Ssh::create('user', 'host')->usePassword('password');
+```
+
 ### Setting a timeout
 
 You can set a timeout for the command.

src/Ssh.php

@@ -22,7 +22,9 @@ class Ssh
 
     private int $timeout = 0;
 
-    public function __construct(?string $user, string $host, int $port = null)
+    protected ?string $password = null;
+
+    public function __construct(?string $user, string $host, int $port = null, ?string $password = null)
     {
         $this->user = $user;
 
@@ -32,6 +34,8 @@ public function __construct(?string $user, string $host, int $port = null)
             $this->usePort($port);
         }
 
+        $this->password = $password;
+
         $this->addBash = true;
 
         $this->processConfigurationClosure = fn (Process $process) => null;
@@ -68,6 +72,13 @@ public function usePort(int $port): self
         return $this;
     }
 
+    public function usePassword(?string $password): self
+    {
+        $this->password = $password;
+
+        return $this;
+    }
+
     public function useMultiplexing(string $controlPath, string $controlPersist = '10m'): self
     {
         $this->extraOptions['control_master'] = '-o ControlMaster=auto -o ControlPath=' . $controlPath . ' -o ControlPersist=' . $controlPersist;
@@ -152,6 +163,14 @@ public function removeBash(): self
         return $this;
     }
 
+    protected function getPasswordCommand(): string
+    {
+        if ($this->password !== null) {
+            return 'sshpass -p \'' . $this->password . '\' ';
+        }
+        return '';
+    }
+
     /**
      * @param string|array $command
      *
@@ -173,11 +192,12 @@ public function getExecuteCommand($command): string
             return $commandString;
         }
 
+        $passwordCommand = $this->getPasswordCommand();
         $bash = $this->addBash ? "'bash -se'" : '';
 
-        return "ssh {$extraOptions} {$target} {$bash} << \\$delimiter".PHP_EOL
-                    .$commandString.PHP_EOL
-                    .$delimiter;
+        return "{$passwordCommand}ssh {$extraOptions} {$target} {$bash} << \\$delimiter".PHP_EOL
+            .$commandString.PHP_EOL
+            .$delimiter;
     }
 
     /**
@@ -206,7 +226,8 @@ public function executeAsync($command): Process
 
     public function getDownloadCommand(string $sourcePath, string $destinationPath): string
     {
-        return "scp {$this->getExtraScpOptions()} {$this->getTargetForScp()}:$sourcePath $destinationPath";
+        $passwordCommand = $this->getPasswordCommand();
+        return "{$passwordCommand}scp {$this->getExtraScpOptions()} {$this->getTargetForScp()}:$sourcePath $destinationPath";
     }
 
     public function download(string $sourcePath, string $destinationPath): Process
@@ -218,7 +239,8 @@ public function download(string $sourcePath, string $destinationPath): Process
 
     public function getUploadCommand(string $sourcePath, string $destinationPath): string
     {
-        return "scp {$this->getExtraScpOptions()} $sourcePath {$this->getTargetForScp()}:$destinationPath";
+        $passwordCommand = $this->getPasswordCommand();
+        return "{$passwordCommand}scp {$this->getExtraScpOptions()} $sourcePath {$this->getTargetForScp()}:$destinationPath";
     }
 
     public function upload(string $sourcePath, string $destinationPath): Process

tests/SshTest.php

@@ -164,3 +164,10 @@
 
     assertMatchesSnapshot($command);
 });
+
+it('can login with a password', function () {
+    $ssh = new Ssh('user', 'example.com', 22, 'password');
+    $command = $ssh->getExecuteCommand('whoami');
+
+    assertMatchesSnapshot($command);
+});

tests/__snapshots__/SshTest__it_can_login_with_a_password__1.txt

@@ -0,0 +1,3 @@
+sshpass -p 'password' ssh -p 22 [email protected] 'bash -se' << \EOF-SPATIE-SSH
+whoami
+EOF-SPATIE-SSH