Merge pull request #4 from open-source-contributions/issue_#1

Resolves issue #1

Author: DivineOmega

src/SSHConnection.php

@@ -62,6 +62,28 @@ private function sanityCheck()
         }
     }
 
+    public function upload(string $localPath, string $remotePath): bool
+    {
+        if (!is_resource($this->resource)) {
+            throw new InvalidArgumentException('The session resource is invalid.');
+        }
+
+        if (!file_exists($localPath)) {
+            throw new InvalidArgumentException('The localPath is invalid.');
+        }
+
+        return ssh2_scp_send($this->resource, $localPath, $remotePath);
+    }
+
+    public function download(string $remotePath, string $localPath): bool
+    {
+        if (!is_resource($this->resource)) {
+            throw new InvalidArgumentException('The session resource is invalid.');
+        }
+
+        return ssh2_scp_recv($this->resource, $remotePath, $localPath);
+    }
+
     public function connect(): self
     {
         $this->sanityCheck();
@@ -104,4 +126,4 @@ public function run(string $command)
 
         return new SSHCommand($this->resource, $command);
     }
-}
+}

tests/Integration/SSHConnectionTest.php

@@ -5,6 +5,38 @@
 
 final class SSHConnectionTest extends TestCase
 {
+    public function testUpload()
+    {
+        $connection = (new SSHConnection())
+            ->to('localhost')
+            ->onPort(22)
+            ->as('travis')
+            ->withKeyPair('/home/travis/.ssh/id_rsa.pub', '/home/travis/.ssh/id_rsa')
+            ->connect();
+
+        $remotePath =  __DIR__ . '/../fixtures/upload.txt';
+        $localPath = __DIR__ . '/../fixtures/file.txt';
+
+        $this->assertTrue($connection->upload($localPath, $remotePath));
+        $this->assertFileExists($remotePath);
+    }
+
+    public function testDownload()
+    {
+        $connection = (new SSHConnection())
+            ->to('localhost')
+            ->onPort(22)
+            ->as('travis')
+            ->withKeyPair('/home/travis/.ssh/id_rsa.pub', '/home/travis/.ssh/id_rsa')
+            ->connect();
+
+        $remotePath =  __DIR__ . '/../fixtures/file.txt';
+        $localPath = __DIR__ . '/../fixtures/download.txt';
+
+        $this->assertTrue($connection->download($remotePath, $localPath));
+        $this->assertFileExists($localPath);
+    }
+
     public function testSSHConnectionWithKeyPair()
     {
         $connection = (new SSHConnection())

tests/fixtures/file.txt

@@ -0,0 +1 @@
+test.upload.download