php nchan client

php-nchan-klien

Daftar isi

• Ringkasan
• Instalasi dan persyaratan
• Penggunaan
  • Publikasikan pesan
  • Dapatkan informasi saluran
  • Hapus saluran
  • Informasi status Nchan
  • Otorisasi permintaan
• Kompatibilitas PSR-18

Ringkasan

Ini adalah klien PHP untuk https://nchan.io.

Instalasi dan persyaratan

 composer require marein/php-nchan-client

Jika Anda ingin menggunakan adaptor PSR-18, instal perpustakaan yang mengimplementasikan klien http PSR-18 (lihat di sini) dan perpustakaan yang mengimplementasikan pabrik http PSR-17 (lihat di sini).

Jika Anda ingin menggunakan klien http bawaan (default jika Anda tidak mengatur apa pun), aktifkan konfigurasi php izinkan_url_fopen.

Penggunaan

Contoh kode berikut menggunakan klien http bawaan.

Publikasikan pesan

Tampilkan kode

 <?php

namespace {

    use Marein  Nchan  Api  Model  PlainTextMessage ;
    use Marein  Nchan  Nchan ;

    include ' /path/to/autoload.php ' ;

    $ nchan = new Nchan ( ' http://my-nchan-domain ' );
    $ channel = $ nchan -> channel ( ' /path-to-publisher-endpoint ' );
    $ channelInformation = $ channel -> publish (
        new PlainTextMessage (
            ' my-message-name ' ,
            ' my message content '
        )
    );

    // Nchan returns some channel information after publishing a message.
    var_dump ( $ channelInformation );
}

Dapatkan informasi saluran

Tampilkan kode

 <?php

namespace {

    use Marein  Nchan  Nchan ;

    include ' /path/to/autoload.php ' ;

    $ nchan = new Nchan ( ' http://my-nchan-domain ' );
    $ channel = $ nchan -> channel ( ' /path-to-publisher-endpoint ' );
    $ channelInformation = $ channel -> information ();

    var_dump ( $ channelInformation );
}

Hapus saluran

Tampilkan kode

 <?php

namespace {

    use Marein  Nchan  Nchan ;

    include ' /path/to/autoload.php ' ;

    $ nchan = new Nchan ( ' http://my-nchan-domain ' );
    $ channel = $ nchan -> channel ( ' /path-to-publisher-endpoint ' );
    $ channel -> delete ();
}

Informasi status Nchan

Titik akhir dengan direktif nchan_stub_status dapat ditanyakan sebagai berikut.

Tampilkan kode

 <?php

namespace {

    use Marein  Nchan  Nchan ;

    include ' /path/to/autoload.php ' ;

    $ nchan = new Nchan ( ' http://my-nchan-domain ' );
    $ status = $ nchan -> status ( ' /path-to-status-location ' );
    $ statusInformation = $ status -> information ();

    var_dump ( $ statusInformation );
}

Otorisasi permintaan

Titik akhir dengan direktif nchan_authorize_request harus diotorisasi. Konstruktor klien http bawaan mengambil implementasi tipe Kredensial. Pustaka ini dilengkapi dengan 2 implementasi bawaan, BasicAuthenticationCredentials dan BearerAuthenticationCredentials.

Tunjukkan kode

 <?php

namespace {

    use Marein  Nchan  HttpAdapter  BasicAuthenticationCredentials ;
    use Marein  Nchan  HttpAdapter  BearerAuthenticationCredentials ;
    use Marein  Nchan  HttpAdapter  HttpStreamWrapperClient ;
    use Marein  Nchan  Nchan ;

    include ' /path/to/autoload.php ' ;

    // Client with basic authentication
    $ adapter = new HttpStreamWrapperClient (
        new BasicAuthenticationCredentials ( ' nchan ' , ' password ' )
    );

    // Client with bearer authentication
    $ adapter = new HttpStreamWrapperClient (
        new BearerAuthenticationCredentials ( ' my-token ' )
    );

    $ nchan = new Nchan ( ' http://my-nchan-domain ' , $ adapter );
}

Jika Anda menggunakan klien http lain melalui adaptor PSR-18, masing-masing klien http memiliki titik ekstensinya sendiri untuk mengubah permintaan sebelum dikirim.

Kompatibilitas PSR-18

Perpustakaan ini dilengkapi dengan adaptor yang kompatibel dengan PSR-18. Ada alasan bagus untuk tidak menggunakan klien bawaan. Ini didasarkan pada pembungkus aliran http dan file_get_contents . Ini menutup koneksi TCP setelah setiap permintaan. Klien lain, lihat di bawah, dapat menjaga koneksi tetap terbuka.

Contoh berikut menggunakan guzzlehttp/guzzle dan guzzlehttp/psr7.

Tampilkan kode

 <?php

namespace {

    use GuzzleHttp  Client ;
    use GuzzleHttp  Psr7  HttpFactory ;
    use Marein  Nchan  HttpAdapter  Psr18ClientAdapter ;
    use Marein  Nchan  Nchan ;

    include ' /path/to/autoload.php ' ;

    $ nchan = new Nchan (
        ' http://my-nchan-domain ' ,
        new Psr18ClientAdapter (
            new Client (),
            new HttpFactory (),
            new HttpFactory ()
        )
    );
}

Contoh kode berikut menggunakan symfony/http-client dan nyholm/psr7.

Tunjukkan kode

 <?php

namespace {

    use Marein  Nchan  HttpAdapter  Psr18ClientAdapter ;
    use Marein  Nchan  Nchan ;
    use Nyholm  Psr7  Factory  Psr17Factory ;
    use Symfony  Component  HttpClient  HttpClient ;
    use Symfony  Component  HttpClient  Psr18Client ;

    include ' /path/to/autoload.php ' ;

    // Symfony itself needs an adapter to be PSR-18 compliant.
    $ httpClient = new Psr18Client (
        HttpClient:: create (),
        new Psr17Factory (),
        new Psr17Factory ()
    );

    $ nchan = new Nchan (
        ' http://my-nchan-domain ' ,
        new Psr18ClientAdapter (
            $ httpClient ,
            $ httpClient ,
            $ httpClient
        )
    );
}