MediaWiki  master
SquidPurgeClient Class Reference

An HTTP 1.0 client built for the purposes of purging Squid and Varnish. More...

Public Member Functions

 __construct ( $server)
 
 close ()
 Close the socket but allow it to be reopened for future purge requests. More...
 
 doReads ()
 Read some data. More...
 
 doWrites ()
 Perform pending writes. More...
 
 getReadSocketsForSelect ()
 Get read socket array for select() More...
 
 getWriteSocketsForSelect ()
 Get write socket array for select() More...
 
 isIdle ()
 
 queuePurge ( $url)
 Queue a purge operation. More...
 

Public Attributes

const BUFFER_SIZE = 8192
 
const EAGAIN = 11
 
const EINPROGRESS = 115
 
const EINTR = 4
 

Protected Member Functions

 getIP ()
 Get the host's IP address. More...
 
 getSocket ()
 Open a socket if there isn't one open already, return it. More...
 
 log ( $msg)
 
 markDown ()
 Close the socket and ignore any future purge requests. More...
 
 nextRequest ()
 
 processHeaderLine ( $line)
 
 processReadBuffer ()
 
 processStatusLine ( $line)
 

Protected Attributes

int $bodyRemaining
 
mixed $currentRequestIndex
 
string $host
 
string bool $ip
 
int $port
 
string $readBuffer
 
string $readState = 'idle'
 
array $requests = []
 
resource null $socket
 The socket resource, or null for unconnected, or false for disabled due to error. More...
 
string $writeBuffer = ''
 

Detailed Description

An HTTP 1.0 client built for the purposes of purging Squid and Varnish.

Uses asynchronous I/O, allowing purges to be done in a highly parallel manner.

Todo:
Consider using MultiHttpClient.

Definition at line 30 of file SquidPurgeClient.php.

Constructor & Destructor Documentation

◆ __construct()

SquidPurgeClient::__construct (   $server)
Parameters
string$server

Definition at line 72 of file SquidPurgeClient.php.

Member Function Documentation

◆ close()

SquidPurgeClient::close ( )

Close the socket but allow it to be reopened for future purge requests.

Definition at line 178 of file SquidPurgeClient.php.

Referenced by doReads(), and markDown().

◆ doReads()

SquidPurgeClient::doReads ( )

Read some data.

Call this when socket_select() indicates that the read buffer is non-empty.

Definition at line 274 of file SquidPurgeClient.php.

References close(), getSocket(), log(), markDown(), and processReadBuffer().

◆ doWrites()

SquidPurgeClient::doWrites ( )

Perform pending writes.

Call this when socket_select() indicates that writing will not block.

Definition at line 239 of file SquidPurgeClient.php.

References $writeBuffer, getSocket(), log(), and markDown().

◆ getIP()

SquidPurgeClient::getIP ( )
protected

Get the host's IP address.

Does not support IPv6 at present due to the lack of a convenient interface in PHP.

Exceptions
MWException
Returns
string

Definition at line 148 of file SquidPurgeClient.php.

References $host, $ip, IP\isIPv4(), and IP\isIPv6().

Referenced by getSocket().

◆ getReadSocketsForSelect()

SquidPurgeClient::getReadSocketsForSelect ( )

Get read socket array for select()

Returns
array

Definition at line 116 of file SquidPurgeClient.php.

References $socket, and getSocket().

◆ getSocket()

SquidPurgeClient::getSocket ( )
protected

Open a socket if there isn't one open already, return it.

Returns false on error.

Returns
bool|resource

Definition at line 84 of file SquidPurgeClient.php.

References $socket, getIP(), log(), and markDown().

Referenced by doReads(), doWrites(), getReadSocketsForSelect(), and getWriteSocketsForSelect().

◆ getWriteSocketsForSelect()

SquidPurgeClient::getWriteSocketsForSelect ( )

Get write socket array for select()

Returns
array

Definition at line 131 of file SquidPurgeClient.php.

References $socket, and getSocket().

◆ isIdle()

SquidPurgeClient::isIdle ( )
Returns
bool

Definition at line 232 of file SquidPurgeClient.php.

◆ log()

SquidPurgeClient::log (   $msg)
protected
Parameters
string$msg

Definition at line 393 of file SquidPurgeClient.php.

References wfDebugLog().

Referenced by doReads(), doWrites(), getSocket(), and processStatusLine().

◆ markDown()

SquidPurgeClient::markDown ( )
protected

Close the socket and ignore any future purge requests.

This is called if there is a protocol error.

Definition at line 170 of file SquidPurgeClient.php.

References close().

Referenced by doReads(), doWrites(), getSocket(), and processStatusLine().

◆ nextRequest()

SquidPurgeClient::nextRequest ( )
protected

Definition at line 374 of file SquidPurgeClient.php.

References $currentRequestIndex.

Referenced by processReadBuffer(), and queuePurge().

◆ processHeaderLine()

SquidPurgeClient::processHeaderLine (   $line)
protected
Parameters
string$line

Definition at line 366 of file SquidPurgeClient.php.

References $line.

Referenced by processReadBuffer().

◆ processReadBuffer()

SquidPurgeClient::processReadBuffer ( )
protected
Exceptions
MWException
Returns
string

Definition at line 305 of file SquidPurgeClient.php.

References $lines, nextRequest(), processHeaderLine(), and processStatusLine().

Referenced by doReads().

◆ processStatusLine()

SquidPurgeClient::processStatusLine (   $line)
protected
Parameters
string$line

Definition at line 347 of file SquidPurgeClient.php.

References $line, log(), and markDown().

Referenced by processReadBuffer().

◆ queuePurge()

SquidPurgeClient::queuePurge (   $url)

Queue a purge operation.

Parameters
string$urlFully expanded URL (with host and protocol)

Definition at line 196 of file SquidPurgeClient.php.

References $path, $wgSquidPurgeUseHostHeader, nextRequest(), Http\userAgent(), wfAppendQuery(), wfDeprecated(), and wfParseUrl().

Member Data Documentation

◆ $bodyRemaining

int SquidPurgeClient::$bodyRemaining
protected

Definition at line 67 of file SquidPurgeClient.php.

◆ $currentRequestIndex

mixed SquidPurgeClient::$currentRequestIndex
protected

Definition at line 50 of file SquidPurgeClient.php.

Referenced by nextRequest().

◆ $host

string SquidPurgeClient::$host
protected

Definition at line 32 of file SquidPurgeClient.php.

Referenced by getIP().

◆ $ip

string bool SquidPurgeClient::$ip
protected

Definition at line 38 of file SquidPurgeClient.php.

Referenced by getIP().

◆ $port

int SquidPurgeClient::$port
protected

Definition at line 35 of file SquidPurgeClient.php.

◆ $readBuffer

string SquidPurgeClient::$readBuffer
protected

Definition at line 64 of file SquidPurgeClient.php.

◆ $readState

string SquidPurgeClient::$readState = 'idle'
protected

Definition at line 41 of file SquidPurgeClient.php.

◆ $requests

array SquidPurgeClient::$requests = []
protected

Definition at line 47 of file SquidPurgeClient.php.

◆ $socket

resource null SquidPurgeClient::$socket
protected

The socket resource, or null for unconnected, or false for disabled due to error.

Definition at line 61 of file SquidPurgeClient.php.

Referenced by getReadSocketsForSelect(), getSocket(), and getWriteSocketsForSelect().

◆ $writeBuffer

string SquidPurgeClient::$writeBuffer = ''
protected

Definition at line 44 of file SquidPurgeClient.php.

Referenced by doWrites().

◆ BUFFER_SIZE

const SquidPurgeClient::BUFFER_SIZE = 8192

Definition at line 55 of file SquidPurgeClient.php.

◆ EAGAIN

const SquidPurgeClient::EAGAIN = 11

Definition at line 53 of file SquidPurgeClient.php.

◆ EINPROGRESS

const SquidPurgeClient::EINPROGRESS = 115

Definition at line 54 of file SquidPurgeClient.php.

◆ EINTR

const SquidPurgeClient::EINTR = 4

Definition at line 52 of file SquidPurgeClient.php.


The documentation for this class was generated from the following file: