SSH Kütüphanesi

---

SSH (Secure Shell) güvenli veri iletimi için kriptografik ağ protokolüdür. Ssh ile ağa bağlı olan iki bilgisayar arasında veri aktarımı güvenlik kanalı üzerinden güvensiz bir ağda yapılır. Bu durumda ağda Ssh ile haberleşen makinelerden biri ssh sunucusu diğeri ssh istemcisi olur. Bu protokol şartları SSH-1 ve SSH-2 olmak üzere iki önemli sürüm üzerinden birbirinden ayrılır.

Ssh kabuk hesabına erişim için Unix ve benzeri işletim sistemlerinde protokolün en iyi uygulaması olarak bilinir, ama aynı zamanda Windows üzerindeki hesaplara erişim için de kullanılabilir. Ssh Telnet ve diğer uzaktan kabuğa erişim yapan güvensiz protokollerin (Berkeley rsh ve rexec protokolü gibi) yerine güvenli veri iletimini sağlaması için tasarlanmıştır.

ZN Framework'te de SSH'ın nasıl kullanılacağına dair anlatıma yer vermeye çalışacağız.

 

 

# Kurulum

---

ZN dağıtımları için kurulum gerekmez.

↓ composer require znframework/package-remote

 

 

# Yapılandırma

---

Aşağıda ssh bağlantı ayarlarını yapılandırmak için kullanılan dizi gösterilmiştir.

SSH
string	$host = ''	Host adı.
string	$user = ''	Kullanıcı adı.
string	$password = ''	Kullanıcı şifresi.
int	$port = 22	Bağlantı portu.
array	$methods = []	Metotlar.
array	$callbacks = []	Geri çağrım işlevleri.

 

 

# Yöntemler

---

this	command(string $command)
mixed	run(string $command = NULL)
string	output(int $length = 4096)
bool	upload(string $localPath, string $remotePath)
bool	download(string $remotePath, string $localPath)
bool	createFolder(string $path, int $mode = 0777, bool $recursive = true)
bool	deleteFolder(string $path)
bool	deleteFile(string $path)
bool	rename(string $oldName, string $newName)
bool	permission(string $path, int $type = 0775)
this	new(array $config)

 

 

# Command (ZN >= 3.0.6)

---

Komut satırı çalıştırmak için kullanılır. Tek satır veya command() yönteminin birden fazla kullanımı ile çoklu komut gönderimi sağlayabilirsiniz.

Parametreler

string	$command	Çalıştırılacak komut.
return	this

Kullanımı

SSH::command('/usr/local/bin/php -i')
   ->command('/usr/bin/ls public_html/images')
   ->run();

 

 

# Run (ZN >= 3.0.6)

---

Gönderilen komutları çalıştırmak için kullanılır. Nihai yöntem olarak kullanılır.

Parametreler

string	$command = NULL	command() işlevinin alternatifidir. Kullanımı zorunlu değildir.
return	this

Kullanımı

SSH::command('/usr/local/bin/php -i')
   ->command('/usr/bin/ls public_html/images')
   ->run();

 

 

# Output (ZN >= 3.0.6)

---

İşlemlerin bitiminde sonucu ekrana bastırmak için kullanılır.

Parametreler

int	$length = 4096	Çıktının byte cinsinden uzunluğu yada kaç karakter uzunlukta olacağı.
return	string

Kullanımı

SSH::output();

 

 

# Upload (ZN >= 3.0.6)

---

Sunucuya dosya yüklemek için kullanılır.

Parametreler

string	$localPath	Yüklenecek dosya.
string	$remotePath	Sunucuda nereye yüklenecek.
return	bool

Kullanımı

SSH::upload('local/example.txt', 'remote/example.txt');

 

 

# Download (ZN >= 3.0.6)

---

Sunucudan dosya indirmek için kullanılır.

Parametreler

string	$remotePath	Sunucuda nereye yüklenecek.
string	$localPath	Yüklenecek dosya.
return	bool

Kullanımı

SSH::upload('remote/example.txt', 'local/example.txt');

 

 

# CreateFolder (ZN >= 3.0.6)

---

Sunucuda dizin oluşturmak için kullanılır.

Parametreler

string	$path	Oluşturulacak dizin.
int	$mode = 0777	Dosya oluşturma izni.
bool	$recursive = true	İç içe dizin oluşturulabilme.
return	bool

Kullanımı

SSH::createFolder('remote/example');

 

 

# DeleteFolder (ZN >= 3.0.6)

---

Sunucudan dizin silmek için kullanılır.

Parametreler

string	$path	Oluşturulacak dizin.
return	bool

Kullanımı

SSH::deleteFolder('remote/example');

 

 

# DeleteFile (ZN >= 3.0.6)

---

Sunucudan dosya silmek için kullanılır.

Parametreler

string	$path	Silinecek dosya.
return	bool

Kullanımı

SSH::deleteFile('remote/example.txt');

 

 

# Rename (ZN >= 3.0.6)

---

Sunucuda yer alan dosya veya dizin adını değiştirmek için kullanılır.

Parametreler

string	$oldName	Dosyanın eski adı.
string	$newName	Dosyanın yeni adı.
return	bool

Kullanımı

SSH::rename('remote/example.txt', 'remote/new-example.txt');

 

 

# Permission (ZN >= 3.0.6)

---

Dosyanın yetki modunu değiştirmek için kullanılır.

Parametreler

string	$path	Dosya adı.
int	$type = 0775	Dosya modu.
return	bool

Kullanımı

SSH::permission('remote/example.txt', 0644);

 

 

# New (ZN >= 5.8.6.3)

---

Sunucuya yapılandırma dosyası bağlantı ayarları dışında yeni bir bağlantı sağlamak için kullanılır.

Parametreler

array	$config	Bağlantı ayarları.
return	this

Kullanımı

$config = 
[
    'host'     => 'localhost',
    'user'     => 'test',
    'password' => '1234'
];

$dssh = SSH::new($config);
$dssh->command('usr/local/bin/php -i')->run();