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

Collaboration diagram for SquidPurgeClient:

Public Member Functions
	__construct ( $server, $options=[])

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

	doReads ()
	Read some data.

	doWrites ()
	Perform pending writes.

	getReadSocketsForSelect ()
	Get read socket array for select()

	getWriteSocketsForSelect ()
	Get write socket array for select()

	isIdle ()

	queuePurge ( $url)
	Queue a purge operation.

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.

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

	log ( $msg)

	markDown ()
	Close the socket and ignore any future purge requests.

	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.

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.

Could be replaced by curl_multi_exec() or some such.

Definition at line 30 of file SquidPurgeClient.php.

Constructor & Destructor Documentation

◆ __construct()

SquidPurgeClient::__construct	(	$server,
		$options = `[]`
	)

Parameters

string	$server
array	$options

Definition at line 73 of file SquidPurgeClient.php.

References port().

Member Function Documentation

◆ close()

SquidPurgeClient::close ( )

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

Definition at line 179 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 $socket, 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 $flags, $socket, $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 149 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 117 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 85 of file SquidPurgeClient.php.

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

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

◆ getWriteSocketsForSelect()

SquidPurgeClient::getWriteSocketsForSelect ( )

Get write socket array for select()

Returns: array

Definition at line 132 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 171 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, and key.

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, $status, list, log(), and markDown().

Referenced by processReadBuffer().

◆ queuePurge()

SquidPurgeClient::queuePurge ( $url )

Queue a purge operation.

Parameters

string $url

Definition at line 197 of file SquidPurgeClient.php.

References $host, $path, $request, $wgSquidPurgeUseHostHeader, CdnCacheUpdate\expand(), global, nextRequest(), wfAppendQuery(), 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(), and queuePurge().

◆ $ip

string bool SquidPurgeClient::$ip

protected

Definition at line 38 of file SquidPurgeClient.php.

Referenced by getIP(), and getSocket().

◆ $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 doReads(), doWrites(), 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:

includes/clientpool/SquidPurgeClient.php

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ close()

◆ doReads()

◆ doWrites()

◆ getIP()

◆ getReadSocketsForSelect()

◆ getSocket()

◆ getWriteSocketsForSelect()

◆ isIdle()

◆ log()

◆ markDown()

◆ nextRequest()

◆ processHeaderLine()

◆ processReadBuffer()

◆ processStatusLine()

◆ queuePurge()

Member Data Documentation

◆ $bodyRemaining

◆ $currentRequestIndex

◆ $host

◆ $ip

◆ $port

◆ $readBuffer

◆ $readState

◆ $requests

◆ $socket

◆ $writeBuffer

◆ BUFFER_SIZE

◆ EAGAIN

◆ EINPROGRESS

◆ EINTR