ইভেন্ট এক্সটেনশন
ইভেন্ট এক্সটেনশন খুব উপযুক্ত। এটি লিবিভেন্ট লাইব্রেরির একটি বন্দর যা ইভেন্ট চালিত I / O, মূলত নেটওয়ার্কিংয়ের জন্য তৈরি করা হয়েছে।
আমি একটি নমুনা এইচটিটিপি ক্লায়েন্ট লিখেছি যা বেশ কয়েকটি এইচটিটিপি অনুরোধের সময়সূচী তৈরি করতে এবং এগুলিকে অবিচ্ছিন্নভাবে চালানোর অনুমতি দেয়।
এটি ইভেন্ট এক্সটেনশনের ভিত্তিতে একটি নমুনা এইচটিটিপি ক্লায়েন্ট শ্রেণি ।
শ্রেণিটি বেশ কয়েকটি এইচটিটিপি অনুরোধের সময়সূচী তৈরি করতে দেয়, তারপরে এগুলিকে সংবিধানে চালিত করে।
HTTP-client.php
<?php
class MyHttpClient {
/// @var EventBase
protected $base;
/// @var array Instances of EventHttpConnection
protected $connections = [];
public function __construct() {
$this->base = new EventBase();
}
/**
* Dispatches all pending requests (events)
*
* @return void
*/
public function run() {
$this->base->dispatch();
}
public function __destruct() {
// Destroy connection objects explicitly, don't wait for GC.
// Otherwise, EventBase may be free'd earlier.
$this->connections = null;
}
/**
* @brief Adds a pending HTTP request
*
* @param string $address Hostname, or IP
* @param int $port Port number
* @param array $headers Extra HTTP headers
* @param int $cmd A EventHttpRequest::CMD_* constant
* @param string $resource HTTP request resource, e.g. '/page?a=b&c=d'
*
* @return EventHttpRequest|false
*/
public function addRequest($address, $port, array $headers,
$cmd = EventHttpRequest::CMD_GET, $resource = '/')
{
$conn = new EventHttpConnection($this->base, null, $address, $port);
$conn->setTimeout(5);
$req = new EventHttpRequest([$this, '_requestHandler'], $this->base);
foreach ($headers as $k => $v) {
$req->addHeader($k, $v, EventHttpRequest::OUTPUT_HEADER);
}
$req->addHeader('Host', $address, EventHttpRequest::OUTPUT_HEADER);
$req->addHeader('Connection', 'close', EventHttpRequest::OUTPUT_HEADER);
if ($conn->makeRequest($req, $cmd, $resource)) {
$this->connections []= $conn;
return $req;
}
return false;
}
/**
* @brief Handles an HTTP request
*
* @param EventHttpRequest $req
* @param mixed $unused
*
* @return void
*/
public function _requestHandler($req, $unused) {
if (is_null($req)) {
echo "Timed out\n";
} else {
$response_code = $req->getResponseCode();
if ($response_code == 0) {
echo "Connection refused\n";
} elseif ($response_code != 200) {
echo "Unexpected response: $response_code\n";
} else {
echo "Success: $response_code\n";
$buf = $req->getInputBuffer();
echo "Body:\n";
while ($s = $buf->readLine(EventBuffer::EOL_ANY)) {
echo $s, PHP_EOL;
}
}
}
}
}
$address = "my-host.local";
$port = 80;
$headers = [ 'User-Agent' => 'My-User-Agent/1.0', ];
$client = new MyHttpClient();
// Add pending requests
for ($i = 0; $i < 10; $i++) {
$client->addRequest($address, $port, $headers,
EventHttpRequest::CMD_GET, '/test.php?a=' . $i);
}
// Dispatch pending requests
$client->run();
test.php
এটি সার্ভারের পাশের একটি নমুনা স্ক্রিপ্ট।
<?php
echo 'GET: ', var_export($_GET, true), PHP_EOL;
echo 'User-Agent: ', $_SERVER['HTTP_USER_AGENT'] ?? '(none)', PHP_EOL;
ব্যবহার
php http-client.php
নমুনা আউটপুট
Success: 200
Body:
GET: array (
'a' => '1',
)
User-Agent: My-User-Agent/1.0
Success: 200
Body:
GET: array (
'a' => '0',
)
User-Agent: My-User-Agent/1.0
Success: 200
Body:
GET: array (
'a' => '3',
)
...
(ছাঁটা।)
দ্রষ্টব্য, কোডটি সিএলআই এসপিআইতে দীর্ঘমেয়াদী প্রক্রিয়াকরণের জন্য ডিজাইন করা হয়েছে ।
কাস্টম প্রোটোকলগুলির জন্য, নিম্ন-স্তরের API, অর্থাত্ বাফার ইভেন্টগুলি , বাফারগুলি ব্যবহার করে বিবেচনা করুন । এসএসএল / টিএলএস যোগাযোগের জন্য, আমি ইভেন্টের এসএসএল প্রসঙ্গের সাথে একত্রে নিম্ন-স্তরের এপিআই সুপারিশ করব । উদাহরণ:
লিবারেন্টের এইচটিটিপি এপিআই সহজ হলেও এটি বাফারের ইভেন্টগুলির মতো নমনীয় নয়। উদাহরণস্বরূপ, HTTP এপিআই বর্তমানে কাস্টম এইচটিটিপি পদ্ধতিগুলিকে সমর্থন করে না। তবে নিম্ন-স্তরের এপিআই ব্যবহার করে কার্যত কোনও প্রোটোকল প্রয়োগ করা সম্ভব।
ইভ এক্সটেনশন
আমিও ব্যবহার করে অন্য HTTP- র ক্লায়েন্ট একটি নমুনা লিখেছি ইভ সহ এক্সটেনশন সকেট মধ্যে অ ব্লক মোড । ইভেন্টটি ইভেন্টের ভিত্তিতে নমুনার চেয়ে কোডটি কিছুটা ভার্বোজ, কারণ ইভটি সাধারণ উদ্দেশ্য ইভেন্টের লুপ। এটি নেটওয়ার্ক-নির্দিষ্ট ফাংশন সরবরাহ করে না, তবে এর EvIo
প্রহরী বিশেষত সকেট রিসোর্সে অন্তর্ভুক্ত একটি ফাইল বর্ণনাকারী শোনার জন্য সক্ষম।
এটি Ev এক্সটেনশনের ভিত্তিতে একটি নমুনা এইচটিটিপি ক্লায়েন্ট ।
ইভ এক্সটেনশন একটি সাধারণ তবে শক্তিশালী সাধারণ উদ্দেশ্যে ইভেন্ট লুপ প্রয়োগ করে। এটি নেটওয়ার্ক-নির্দিষ্ট পর্যবেক্ষক সরবরাহ করে না, তবে এর আই / হে প্রহরী সকেটের অ্যাসিনক্রোনাস প্রসেসিংয়ের জন্য ব্যবহার করা যেতে পারে ।
নিম্নলিখিত কোডটি দেখায় যে কীভাবে HTTP অনুরোধগুলি সমান্তরাল প্রক্রিয়াকরণের জন্য নির্ধারিত হতে পারে।
HTTP-client.php
<?php
class MyHttpRequest {
/// @var MyHttpClient
private $http_client;
/// @var string
private $address;
/// @var string HTTP resource such as /page?get=param
private $resource;
/// @var string HTTP method such as GET, POST etc.
private $method;
/// @var int
private $service_port;
/// @var resource Socket
private $socket;
/// @var double Connection timeout in seconds.
private $timeout = 10.;
/// @var int Chunk size in bytes for socket_recv()
private $chunk_size = 20;
/// @var EvTimer
private $timeout_watcher;
/// @var EvIo
private $write_watcher;
/// @var EvIo
private $read_watcher;
/// @var EvTimer
private $conn_watcher;
/// @var string buffer for incoming data
private $buffer;
/// @var array errors reported by sockets extension in non-blocking mode.
private static $e_nonblocking = [
11, // EAGAIN or EWOULDBLOCK
115, // EINPROGRESS
];
/**
* @param MyHttpClient $client
* @param string $host Hostname, e.g. google.co.uk
* @param string $resource HTTP resource, e.g. /page?a=b&c=d
* @param string $method HTTP method: GET, HEAD, POST, PUT etc.
* @throws RuntimeException
*/
public function __construct(MyHttpClient $client, $host, $resource, $method) {
$this->http_client = $client;
$this->host = $host;
$this->resource = $resource;
$this->method = $method;
// Get the port for the WWW service
$this->service_port = getservbyname('www', 'tcp');
// Get the IP address for the target host
$this->address = gethostbyname($this->host);
// Create a TCP/IP socket
$this->socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
if (!$this->socket) {
throw new RuntimeException("socket_create() failed: reason: " .
socket_strerror(socket_last_error()));
}
// Set O_NONBLOCK flag
socket_set_nonblock($this->socket);
$this->conn_watcher = $this->http_client->getLoop()
->timer(0, 0., [$this, 'connect']);
}
public function __destruct() {
$this->close();
}
private function freeWatcher(&$w) {
if ($w) {
$w->stop();
$w = null;
}
}
/**
* Deallocates all resources of the request
*/
private function close() {
if ($this->socket) {
socket_close($this->socket);
$this->socket = null;
}
$this->freeWatcher($this->timeout_watcher);
$this->freeWatcher($this->read_watcher);
$this->freeWatcher($this->write_watcher);
$this->freeWatcher($this->conn_watcher);
}
/**
* Initializes a connection on socket
* @return bool
*/
public function connect() {
$loop = $this->http_client->getLoop();
$this->timeout_watcher = $loop->timer($this->timeout, 0., [$this, '_onTimeout']);
$this->write_watcher = $loop->io($this->socket, Ev::WRITE, [$this, '_onWritable']);
return socket_connect($this->socket, $this->address, $this->service_port);
}
/**
* Callback for timeout (EvTimer) watcher
*/
public function _onTimeout(EvTimer $w) {
$w->stop();
$this->close();
}
/**
* Callback which is called when the socket becomes wriable
*/
public function _onWritable(EvIo $w) {
$this->timeout_watcher->stop();
$w->stop();
$in = implode("\r\n", [
"{$this->method} {$this->resource} HTTP/1.1",
"Host: {$this->host}",
'Connection: Close',
]) . "\r\n\r\n";
if (!socket_write($this->socket, $in, strlen($in))) {
trigger_error("Failed writing $in to socket", E_USER_ERROR);
return;
}
$loop = $this->http_client->getLoop();
$this->read_watcher = $loop->io($this->socket,
Ev::READ, [$this, '_onReadable']);
// Continue running the loop
$loop->run();
}
/**
* Callback which is called when the socket becomes readable
*/
public function _onReadable(EvIo $w) {
// recv() 20 bytes in non-blocking mode
$ret = socket_recv($this->socket, $out, 20, MSG_DONTWAIT);
if ($ret) {
// Still have data to read. Append the read chunk to the buffer.
$this->buffer .= $out;
} elseif ($ret === 0) {
// All is read
printf("\n<<<<\n%s\n>>>>", rtrim($this->buffer));
fflush(STDOUT);
$w->stop();
$this->close();
return;
}
// Caught EINPROGRESS, EAGAIN, or EWOULDBLOCK
if (in_array(socket_last_error(), static::$e_nonblocking)) {
return;
}
$w->stop();
$this->close();
}
}
/////////////////////////////////////
class MyHttpClient {
/// @var array Instances of MyHttpRequest
private $requests = [];
/// @var EvLoop
private $loop;
public function __construct() {
// Each HTTP client runs its own event loop
$this->loop = new EvLoop();
}
public function __destruct() {
$this->loop->stop();
}
/**
* @return EvLoop
*/
public function getLoop() {
return $this->loop;
}
/**
* Adds a pending request
*/
public function addRequest(MyHttpRequest $r) {
$this->requests []= $r;
}
/**
* Dispatches all pending requests
*/
public function run() {
$this->loop->run();
}
}
/////////////////////////////////////
// Usage
$client = new MyHttpClient();
foreach (range(1, 10) as $i) {
$client->addRequest(new MyHttpRequest($client, 'my-host.local', '/test.php?a=' . $i, 'GET'));
}
$client->run();
পরীক্ষামূলক
ধরুন http://my-host.local/test.php
স্ক্রিপ্টটি এর ডাম্প মুদ্রণ করছে $_GET
:
<?php
echo 'GET: ', var_export($_GET, true), PHP_EOL;
তাহলে php http-client.php
কমান্ডের আউটপুট নিম্নলিখিতগুলির মতো হবে:
<<<<
HTTP/1.1 200 OK
Server: nginx/1.10.1
Date: Fri, 02 Dec 2016 12:39:54 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: close
X-Powered-By: PHP/7.0.13-pl0-gentoo
1d
GET: array (
'a' => '3',
)
0
>>>>
<<<<
HTTP/1.1 200 OK
Server: nginx/1.10.1
Date: Fri, 02 Dec 2016 12:39:54 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: close
X-Powered-By: PHP/7.0.13-pl0-gentoo
1d
GET: array (
'a' => '2',
)
0
>>>>
...
(ছাঁটা)
উল্লেখ্য, পিএইচপি 5 সকেট এক্সটেনশানটির সতর্কবার্তা লগ ইন করতে পারেন EINPROGRESS
, EAGAIN
এবং EWOULDBLOCK
errno
মান। এর সাহায্যে লগগুলি বন্ধ করা সম্ভব
error_reporting(E_ERROR);
কোডটির "বিশ্রাম" সম্পর্কিত
আমি ঠিক এর মতো কিছু করতে চাই file_get_contents()
, তবে আমার বাকী কোডটি চালিয়ে যাওয়ার আগে অনুরোধটি শেষ হওয়ার অপেক্ষা না করে।
নেটওয়ার্কের অনুরোধগুলির সাথে সমান্তরালভাবে চলার কথা যে কোডটি কোনও ইভেন্ট টাইমার , বা ইভের নিষ্ক্রিয় পর্যবেক্ষকের কলব্যাকের মধ্যে কার্যকর করা যেতে পারে instance উপরে বর্ণিত নমুনাগুলি দেখে আপনি সহজেই এটি বের করতে পারেন। অন্যথায়, আমি অন্য একটি উদাহরণ যুক্ত করব :)