Sunucu Kütüphanesi

Soketler aynı veya farklı makineler arasında veri iletişimi sağlamak için kullanılan bir haberleşme yoludur. Bu işlem bir makineden diğerine veri yazma ve o makineden veri okuma üzerine kuruludur. Böylece gelen istekler basit bir dosya okuma veya yazma isteği gibi gönderilip alınabilmektedir. ZN Framework'te PHP'de bulunan soket fonksiyonlarını ele alarak daha basit şekilde farklı bağlantı türleri arasında standartizasyon sağlarayak kullanım kolaylığı sağlamıştır.

# Kurulum

ZN dağıtımları içinde dahili gelmemektedir. Ayrıca kurulmalıdır.

↓ composer require znframework/package-socket

# Desteklenen Türler

● TCP
● UDP
● TLS
● SSL

# Yöntemler

# Run

Soket sunucu bağlantısını çalıştırmak için kullanılır.

Parametreler

float $timeout = NULL

Aşağıda bağlantı türüne göre kullanımı gösterilmiştir. 

TCP ve UDP kullaımları benzerdir.

TCP için Opsiyonel Yöntemler

Kullanımlar

$socket = ZN\Socket\Server::run('tcp', '127.0.0.1', 8080);

$socket->live(function($socket)
{
    switch( $socket->read() )
    {
        case 'exit' : $socket->write('Goodbye!');           return;
        case 'write': $socket->write('Run write command.'); break;
        case 'read' : $socket->write('Run read command.');  break;

        default     : return;
    }

    $socket->wait(2); # Waiting 2 seconds.
});

Backlog

İşlem için kuyruğa alınacak azami gelen bağlantı sayısı. Dolmuş bir kuyruğa gelen bir bağlantı ya ECONNREFUSED belirten bir hata alır ya da ilgili protokol yeniden bağlanmayı destekliyorsa yineleme başarılı olacağından istek yok sayılır. Bu parametreye atanacak değer çalışılan platforma büyük oranda bağımlıdır. Linux üzerinde kendiliğinden SOMAXCONN'a düşürülür. Win32 üzerinde SOMAXCONN atanırsa makul bir azami değer kullanımından ilgili hizmet sağlayıcı sorumludur. Windows üzerinde bu değer için standart bir yaklaşım yoktur. Server::run() yönteminden önce kullanılır.

$socket = ZN\Socket\Server::backlog(2)::run('tcp', '127.0.0.1', 8080);

SSL ve TLS kullanımları benzerdir.

Opsiyonel Yöntemler

Kullanımlar

SSL veya TLS bağlantısı için ek ayarlara ihtiyaç duyulması halinde doğru bağlantı için option() yöntemini kullanabilirsiniz.

$socket = ZN\Socket\Server::run('tls', '127.0.0.1', 8080); 

$socket->live(function($socket)
{
    switch( $socket->read() )
    {
        case 'exit' : $socket->write('Goodbye!');           return;
        case 'write': $socket->write('Run write command.'); break;
        case 'read' : $socket->write('Run read command.');  break;

        default     : return;
    }
});

Crypto

Bağlı bir soket üzerinde şifrelemeyi açıp kapatır. Bu yöntem $socket örneği ile beraber kullanılır.

$socket = ZN\Socket\Server::run('tls', '127.0.0.1', 8080); 

$socket->crypto('tls');

Blocking

Akımın engelleme kipini ayarlar. Bu yöntem $socket örneği beraber kullanılır.

$socket = ZN\Socket\Server::run('tls', '127.0.0.1', 8080);

$socket->blocking('tls');

Timeout

Akımın saniye cinsinden zaman aşımı süresini ayarlar.

$socket = ZN\Socket\Server::run('tls', '127.0.0.1', 8080); 

$socket->timeout(5);

Option

SSL ve TLS bağlantı seneçeklerini yapılandırmak için kullanılır. Bu yöntem diğerlerinin aksine Server::run() yönteminin devreye sokulmasından önce çalıştırılmalıdır.

String | Array

$socket = ZN\Socket\Server::option('verifyPeer', false)::run('tls', '127.0.0.1', 8080); 

Birden fazla seçenek yapılandırması gereken durumlarda option() yöntemini zincirleme kullanabilirsiniz.

$socket = ZN\Socket\Server::option('verifyPeer', false)
                          ::option('verifyPeerName', false)
                          ::run('tls', '127.0.0.1', 8080);