Public Member Functions
	__construct ($address= '', $user=0, $by=0, $reason= '', $timestamp=0, $auto=0, $expiry= '', $anonOnly=0, $createAccount=0, $enableAutoblock=0, $hideName=0, $blockEmail=0, $allowUsertalk=0, $byText= '')
	Constructor.
	clear ()
	Clear all member variables in the current object.
	delete ()
	Delete the row from the IP blocks table.
	deleteIfExpired ()
	Check if a block has expired.
	doAutoblock ($autoblockIP)
	Autoblocks the given IP, referring to this Block.
	equals (Block $block)
	Check if two blocks are effectively equal.
	forUpdate ($x=null)
	Get/set the SELECT ...
	fromMaster ($x=null)
	Get/set a flag determining whether the master is used for reads.
	getBlocker ()
	Get the user who implemented this block.
	getBy ()
	Get the user id of the blocking sysop.
	getByName ()
	Get the username of the blocking sysop.
	getExpiry ()
	getId ()
	Get the block ID.
	getRangeEnd ()
	Get the IP address at the start of the range in Hex form.
	getRangeStart ()
	Get the IP address at the start of the range in Hex form.
	getRedactedName ()
	Get the block name, but with autoblocked IPs hidden as per standard privacy policy.
	getTarget ()
	Get the target for this particular Block.
	getTargetAndType ()
	Get the target and target type for this particular Block.
	getType ()
	Get the type of target for this particular block.
	insert ($dbw=null)
	Insert a block into the block table.
	isAutoblocking ($x=null)
	isExpired ()
	Has the block expired?
	isHardblock ($x=null)
	Get/set whether the Block is a hardblock (affects logged-in users on a given IP/range.
	isValid ()
	Is the block address valid (i.e.
	load ($address= '', $user=0)
	Get a block from the DB, with either the given address or the given username.
	prevents ($action, $x=null)
	Get/set whether the Block prevents a given action.
	setBlocker ($user)
	Set the user who implemented (or will implement) this block.
	setTarget ($target)
	Set the target for this block, and update $this->type accordingly.
	update ()
	Update a block in the DB with new parameters.
	updateTimestamp ()
	Update the timestamp on autoblocks.
Static Public Member Functions
static	decodeExpiry ($expiry, $timestampType=TS_MW)
	Decode expiry which has come from the DB.
static	encodeExpiry ($expiry, $db)
	Encode expiry for DB.
static	formatExpiry ($encoded_expiry)
	Convert a DB-encoded expiry into a real string that humans can read.
static	getAutoblockExpiry ($timestamp)
	Get a timestamp of the expiry for autoblocks.
static	getRangeCond ($start, $end=null)
	Get a set of SQL conditions which will select rangeblocks encompasing a given range.
static	infinity ()
	Get a value to insert into expiry field of the database when infinite expiry is desired.
static	isWhitelistedFromAutoblocks ($ip)
	Checks whether a given IP is on the autoblock whitelist.
static	newFromDB ($address, $user=0)
	Load a block from the database, using either the IP address or user ID.
static	newFromID ($id)
	Load a blocked user from their block id.
static	newFromRow ($row)
	Create a new Block object from a database row.
static	newFromTarget ($specificTarget, $vagueTarget=null, $fromMaster=false)
	Given a target and the target's type, get an existing Block object if possible.
static	normaliseRange ($range)
	Gets rid of uneeded numbers in quad-dotted/octet IP strings For example, 127.111.113.151/24 -> 127.111.113.0/24.
static	parseExpiryInput ($expiry)
	Convert a submitted expiry time, which may be relative ("2 weeks", etc) or absolute ("24 May 2034"), into an absolute timestamp we can put into the database.
static	parseTarget ($target)
	From an existing Block, get the target and the type of target.
static	purgeExpired ()
	Purge expired blocks from the ipblocks table.
Public Attributes
	$mAuto
	$mBlockEmail
	$mCreateAccount
	$mDisableUsertalk
	$mExpiry
	$mFromMaster
	$mHideName
	$mReason
	$mTimestamp
const	TYPE_AUTO = 4
const	TYPE_ID = 5
const	TYPE_IP = 2
const	TYPE_RANGE = 3
const	TYPE_USER = 1
Protected Member Functions
	doRetroactiveAutoblock ()
	Retroactively autoblocks the last IP used by the user (if it is a user) blocked by this Block.
	getDatabaseArray ($db=null)
	Get an array suitable for passing to $dbw->insert() or $dbw->update()
	initFromRow ($row)
	Given a database row from the ipblocks table, initialize member variables.
	newLoad ($vagueTarget=null)
	Load a block from the database which affects the already-set $this->target: 1) A block directly on the given user or IP 2) A rangeblock encompasing the given IP (smallest first) 3) An autoblock on the given IP.
Static Protected Member Functions
static	defaultRetroactiveAutoblock (Block $block, array &$blockIds)
	Retroactively autoblocks the last IP used by the user (if it is a user) blocked by this Block.
static	getIpFragment ($hex)
	Get the component of an IP address which is certain to be the same between an IP address and a rangeblock containing that IP address.
Protected Attributes
	$blocker
	$isAutoblocking = true
	$isHardblock = true
	$mId
	$target
	$type

Detailed Description

Definition at line 22 of file Block.php.

Constructor & Destructor Documentation

Block::__construct	(	$	address = `''`,
		$	user = `0`,
		$	by = `0`,
		$	reason = `''`,
		$	timestamp = `0`,
		$	auto = `0`,
		$	expiry = `''`,
		$	anonOnly = `0`,
		$	createAccount = `0`,
		$	enableAutoblock = `0`,
		$	hideName = `0`,
		$	blockEmail = `0`,
		$	allowUsertalk = `0`,
		$	byText = `''`
	)

Constructor.

Todo:: FIXME: Don't know what the best format to have for this constructor is, but fourteen optional parameters certainly isn't it.

Definition at line 60 of file Block.php.

References $user, isAutoblocking(), isHardblock(), prevents(), setBlocker(), setTarget(), wfGetDB(), wfTimestamp(), and wfTimestampNow().

Here is the call graph for this function:

Member Function Documentation

Block::clear ( )

Clear all member variables in the current object.

Does not clear the block from the DB.

Deprecated:: since 1.18

Definition at line 165 of file Block.php.

References wfDeprecated().

Here is the call graph for this function:

static Block::decodeExpiry	(	$	expiry,
		$	timestampType = `TS_MW`
	)		`[static]`

Decode expiry which has come from the DB.

Parameters:

$expiry	String: Database expiry format
$timestampType	Int Requested timestamp format

Returns:: String

Deprecated:: since 1.18; use $wgLang->formatExpiry() instead

Definition at line 916 of file Block.php.

References $wgContLang, and wfDeprecated().

Here is the call graph for this function:

static Block::defaultRetroactiveAutoblock	(	Block $	block,
		array &$	blockIds
	)		`[static, protected]`

Retroactively autoblocks the last IP used by the user (if it is a user) blocked by this Block.

This will use the recentchanges table.

Parameters:

Block	$block
Array	&$blockIds

Returns:: Array: block IDs of retroactive autoblocks made

Definition at line 538 of file Block.php.

References $dbr, $options, $res, doAutoblock(), getTarget(), wfDebug(), and wfGetDB().

Referenced by doRetroactiveAutoblock().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::delete ( )

Delete the row from the IP blocks table.

Returns:: Boolean

Definition at line 401 of file Block.php.

References getId(), wfGetDB(), and wfReadOnly().

Here is the call graph for this function:

Block::deleteIfExpired ( )

Check if a block has expired.

Delete it if it is.

Returns:: Boolean

Definition at line 681 of file Block.php.

References isExpired(), wfDebug(), wfProfileIn(), and wfProfileOut().

Here is the call graph for this function:

Block::doAutoblock ( $ autoblockIP )

Autoblocks the given IP, referring to this Block.

Parameters:

$autoblockIP String: the IP to autoblock.

Returns:: mixed: block ID if an autoblock was inserted, false if not.

Definition at line 613 of file Block.php.

References getAutoblockExpiry(), getBlocker(), getTarget(), isAutoblocking(), newFromTarget(), prevents(), wfDebug(), wfMsgForContent(), wfRunHooks(), and wfTimestampNow().

Referenced by defaultRetroactiveAutoblock().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::doRetroactiveAutoblock ( ) [protected]

Retroactively autoblocks the last IP used by the user (if it is a user) blocked by this Block.

Returns:: Array: block IDs of retroactive autoblocks made

Definition at line 514 of file Block.php.

References defaultRetroactiveAutoblock(), getTarget(), getType(), isAutoblocking(), wfDebug(), and wfRunHooks().

Referenced by insert().

Here is the call graph for this function:

Here is the caller graph for this function:

static Block::encodeExpiry	(	$	expiry,
		$	db
	)		`[static]`

Encode expiry for DB.

Parameters:

$expiry	String: timestamp for expiry, or
$db	Database object

Returns:: String

Deprecated:: since 1.18; use $dbw->encodeExpiry() instead

Definition at line 903 of file Block.php.

References wfDeprecated().

Here is the call graph for this function:

Block::equals ( Block $ block )

Check if two blocks are effectively equal.

Doesn't check irrelevant things like the blocking user or the block timestamp, only things which affect the blocked user *

Parameters:

$block Block

Returns:: bool

Definition at line 144 of file Block.php.

References isAutoblocking(), isHardblock(), and prevents().

Here is the call graph for this function:

static Block::formatExpiry ( $ encoded_expiry ) [static]

Convert a DB-encoded expiry into a real string that humans can read.

Parameters:

$encoded_expiry String: Database encoded expiry time

Returns:: Html-escaped String

Deprecated:: since 1.18; use $wgLang->formatExpiry() instead

Definition at line 973 of file Block.php.

References $keys, $wgContLang, $wgLang, wfDeprecated(), wfGetDB(), wfMsgHtml(), and wfMsgReplaceArgs().

Here is the call graph for this function:

Block::forUpdate ( $ x = null )

Get/set the SELECT ...

FOR UPDATE flag

Deprecated:: since 1.18

Parameters:

$x Bool

Definition at line 814 of file Block.php.

References wfDeprecated().

Here is the call graph for this function:

Block::fromMaster ( $ x = null )

Get/set a flag determining whether the master is used for reads.

Parameters:

$x Bool

Returns:: Bool

Definition at line 825 of file Block.php.

References wfSetVar().

Here is the call graph for this function:

static Block::getAutoblockExpiry ( $ timestamp ) [static]

Get a timestamp of the expiry for autoblocks.

Parameters:

$timestamp String|Int

Returns:: String

Definition at line 928 of file Block.php.

References $wgAutoblockExpiry, and wfTimestamp().

Referenced by doAutoblock(), and updateTimestamp().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::getBlocker ( )

Get the user who implemented this block.

Returns:: User|string Local User object or string for a foreign user

Definition at line 1172 of file Block.php.

Referenced by UserBlockedError\__construct(), doAutoblock(), getBy(), and getByName().

Here is the caller graph for this function:

Block::getBy ( )

Get the user id of the blocking sysop.

Returns:: Integer (0 for foreign users)

Definition at line 781 of file Block.php.

References $blocker, and getBlocker().

Referenced by getDatabaseArray().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::getByName ( )

Get the username of the blocking sysop.

Returns:: String

Definition at line 793 of file Block.php.

References $blocker, and getBlocker().

Referenced by UserBlockedError\__construct(), getDatabaseArray(), and LoginForm\userBlockedMessage().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::getDatabaseArray ( $ db = null ) [protected]

Get an array suitable for passing to $dbw->insert() or $dbw->update()

Parameters:

$db	DatabaseBase

Returns:: Array

Definition at line 480 of file Block.php.

References getBy(), getByName(), getRangeEnd(), getRangeStart(), isAutoblocking(), isHardblock(), prevents(), and wfGetDB().

Referenced by insert(), and update().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::getExpiry ( )

Since:: 1.19

Returns:: Mixed|string

Definition at line 1156 of file Block.php.

Block::getId ( )

Get the block ID.

Returns:: int

Definition at line 804 of file Block.php.

Referenced by UserBlockedError\__construct(), delete(), and update().

Here is the caller graph for this function:

static Block::getIpFragment ( $ hex ) [static, protected]

Get the component of an IP address which is certain to be the same between an IP address and a rangeblock containing that IP address.

Parameters:

$hex	String Hexadecimal IP representation

Returns:: String

Definition at line 341 of file Block.php.

References $wgBlockCIDRLimit.

Referenced by getRangeCond().

Here is the caller graph for this function:

static Block::getRangeCond	(	$	start,
		$	end = `null`
	)		`[static]`

Get a set of SQL conditions which will select rangeblocks encompasing a given range.

Parameters:

$start	String Hexadecimal IP representation
$end	String Hexadecimal IP represenation, or null to use $start = $end

Returns:: String

Definition at line 308 of file Block.php.

References $dbr, getIpFragment(), and wfGetDB().

Referenced by newLoad(), and SpecialBlockList\showList().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::getRangeEnd ( )

Get the IP address at the start of the range in Hex form.

Returns:: String IP in Hex form

Definition at line 763 of file Block.php.

References IP\parseRange(), and IP\toHex().

Referenced by getDatabaseArray().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::getRangeStart ( )

Get the IP address at the start of the range in Hex form.

Returns:: String IP in Hex form

Definition at line 746 of file Block.php.

References IP\parseRange(), and IP\toHex().

Referenced by getDatabaseArray().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::getRedactedName ( )

Get the block name, but with autoblocked IPs hidden as per standard privacy policy.

Returns:: String, text is escaped

Definition at line 883 of file Block.php.

References getTarget(), Html\rawElement(), and wfMessage().

Here is the call graph for this function:

Block::getTarget ( )

Get the target for this particular Block.

Note that for autoblocks, this returns the unredacted name; frontend functions need to call $block->getRedactedName() in this situation.

Returns:: User|String

Definition at line 1147 of file Block.php.

Referenced by UserBlockedError\__construct(), defaultRetroactiveAutoblock(), doAutoblock(), doRetroactiveAutoblock(), getRedactedName(), getTargetAndType(), isValid(), updateTimestamp(), and LoginForm\userBlockedMessage().

Here is the caller graph for this function:

Block::getTargetAndType ( )

Get the target and target type for this particular Block.

Note that for autoblocks, this returns the unredacted name; frontend functions need to call $block->getRedactedName() in this situation.

Returns:: array( User|String, Block::TYPE_ constant )

Todo:: FIXME: This should be an integral part of the Block member variables

Definition at line 1137 of file Block.php.

References getTarget(), and getType().

Here is the call graph for this function:

Block::getType ( )

Get the type of target for this particular block.

Returns:: Block::TYPE_ constant, will never be TYPE_ID

Definition at line 1124 of file Block.php.

Referenced by doRetroactiveAutoblock(), getTargetAndType(), isAutoblocking(), and isHardblock().

Here is the caller graph for this function:

static Block::infinity ( ) [static]

Get a value to insert into expiry field of the database when infinite expiry is desired.

Deprecated:: since 1.18, call $dbr->getInfinity() directly

Returns:: String

Definition at line 961 of file Block.php.

References wfDeprecated(), and wfGetDB().

Here is the call graph for this function:

Block::initFromRow ( $ row ) [protected]

Given a database row from the ipblocks table, initialize member variables.

Parameters:

$row	ResultWrapper: a row from the ipblocks table

Definition at line 355 of file Block.php.

References isAutoblocking(), isHardblock(), prevents(), setBlocker(), setTarget(), wfGetDB(), and wfTimestamp().

Referenced by newFromRow(), and newLoad().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::insert ( $ dbw = null )

Insert a block into the block table.

Will fail if there is a conflicting block (same name and options) already in the database.

Parameters:

$dbw	DatabaseBase if you have one available

Returns:: mixed: false on failure, assoc array on success: ('id' => block ID, 'autoIds' => array of autoblock IDs)

Definition at line 424 of file Block.php.

References doRetroactiveAutoblock(), getDatabaseArray(), purgeExpired(), wfDebug(), and wfGetDB().

Here is the call graph for this function:

Block::isAutoblocking ( $ x = null )

Definition at line 843 of file Block.php.

References getType(), and wfSetVar().

Referenced by __construct(), doAutoblock(), doRetroactiveAutoblock(), equals(), getDatabaseArray(), and initFromRow().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::isExpired ( )

Has the block expired?

Returns:: Boolean

Definition at line 701 of file Block.php.

References wfDebug(), and wfTimestampNow().

Referenced by deleteIfExpired().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::isHardblock ( $ x = null )

Get/set whether the Block is a hardblock (affects logged-in users on a given IP/range.

Parameters:

$x Bool

Returns:: Bool

Definition at line 834 of file Block.php.

References getType(), and wfSetVar().

Referenced by __construct(), equals(), getDatabaseArray(), and initFromRow().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::isValid ( )

Is the block address valid (i.e.

not a null string?)

Returns:: Boolean

Definition at line 716 of file Block.php.

References getTarget().

Here is the call graph for this function:

static Block::isWhitelistedFromAutoblocks ( $ ip ) [static]

Checks whether a given IP is on the autoblock whitelist.

TODO: this probably belongs somewhere else, but not sure where...

Parameters:

$ip	String: The IP to check

Returns:: Boolean

Definition at line 570 of file Block.php.

References $lines, $wgMemc, IP\isInRange(), wfDebug(), wfMemcKey(), and wfMsgForContentNoTrans().

Here is the call graph for this function:

Block::load	(	$	address = `''`,
		$	user = `0`
	)

Get a block from the DB, with either the given address or the given username.

Parameters:

$address	string The IP address of the user, or blank to skip IP blocks
$user	int The user ID, or zero for anonymous users

Returns:: Boolean: the user is blocked from editing

Deprecated:: since 1.18

Definition at line 178 of file Block.php.

References $user, newFromTarget(), wfDeprecated(), and User\whoIs().

Here is the call graph for this function:

static Block::newFromDB	(	$	address,
		$	user = `0`
	)		`[static]`

Load a block from the database, using either the IP address or user ID.

Tries the user ID first, and if that doesn't work, tries the address.

Parameters:

$address	String: IP address of user/anon
$user	Integer: user id of user

Returns:: Block Object

Deprecated:: since 1.18

Definition at line 110 of file Block.php.

References $user, newFromTarget(), wfDeprecated(), and User\whoIs().

Here is the call graph for this function:

static Block::newFromID ( $ id ) [static]

Load a blocked user from their block id.

Parameters:

$id	Integer: Block id to search for

Returns:: Block object or null

Definition at line 121 of file Block.php.

References $dbr, $res, newFromRow(), and wfGetDB().

Referenced by newFromTarget(), and BlockTest\testInitializerFunctionsReturnCorrectBlock().

Here is the call graph for this function:

Here is the caller graph for this function:

static Block::newFromRow ( $ row ) [static]

Create a new Block object from a database row.

Parameters:

$row	ResultWrapper row from the ipblocks table

Returns:: Block

Definition at line 390 of file Block.php.

References initFromRow().

Referenced by newFromID(), and newLoad().

Here is the call graph for this function:

Here is the caller graph for this function:

static Block::newFromTarget	(	$	specificTarget,
		$	vagueTarget = `null`,
		$	fromMaster = `false`
	)		`[static]`

Given a target and the target's type, get an existing Block object if possible.

Parameters:

$specificTarget	String\|User\|Int a block target, which may be one of several types: * A user to block, in which case $target will be a User * An IP to block, in which case $target will be a User generated by using User::newFromName( $ip, false ) to turn off name validation * An IP range, in which case $target will be a String "123.123.123.123/18" etc * The ID of an existing block, in the format "#12345" (since pure numbers are valid usernames Calling this with a user, IP address or range will not select autoblocks, and will only select a block where the targets match exactly (so looking for blocks on 1.2.3.4 will not select 1.2.0.0/16 or even 1.2.3.4/32)
$vagueTarget	String\|User\|Int as above, but we will search for any block which affects that target (so for an IP address, get ranges containing that IP; and also get any relevant autoblocks). Leave empty or blank to skip IP-based lookups.
$fromMaster	Bool whether to use the DB_MASTER database

Returns:: Block|null (null if no relevant block could be found). The target and type of the returned Block will refer to the actual block which was found, which might not be the same as the target you gave if you used $vagueTarget!

Definition at line 1033 of file Block.php.

References $target, $type, newFromID(), parseTarget(), TYPE_AUTO, TYPE_ID, TYPE_IP, TYPE_RANGE, and TYPE_USER.

Referenced by BlockTest\addDBData(), doAutoblock(), SpecialUnblock\execute(), ApiUnblock\execute(), ApiBlock\execute(), User\getBlockedStatus(), Article\getRobotPolicy(), User\isBlockedFromCreateAccount(), load(), SpecialBlock\maybeAlterFormDefaults(), newFromDB(), SpecialBlock\processForm(), SpecialUnblock\processUnblock(), User\spreadBlock(), BlockTest\testBug29116NewFromTargetWithEmptyIp(), BlockTest\testInitializerFunctionsReturnCorrectBlock(), and ApiBlockTest\testMakeNormalBlock().

Here is the call graph for this function:

Here is the caller graph for this function:

Block::newLoad ( $ vagueTarget = null ) [protected]

Load a block from the database which affects the already-set $this->target: 1) A block directly on the given user or IP 2) A rangeblock encompasing the given IP (smallest first) 3) An autoblock on the given IP.

Parameters:

$vagueTarget User|String also search for blocks affecting this target. Doesn't make any sense to use TYPE_AUTO / TYPE_ID here. Leave blank to skip IP lookups.

Returns:: Bool whether a relevant block was found

Definition at line 207 of file Block.php.

References $res, $size, $target, $type, getRangeCond(), initFromRow(), newFromRow(), IP\parseRange(), parseTarget(), prevents(), IP\toHex(), TYPE_RANGE, and wfGetDB().

Here is the call graph for this function:

static Block::normaliseRange ( $ range ) [static]

Gets rid of uneeded numbers in quad-dotted/octet IP strings For example, 127.111.113.151/24 -> 127.111.113.0/24.

Parameters:

$range String: IP address to normalize

Returns:: string

Deprecated:: since 1.18, call IP::sanitizeRange() directly

Definition at line 941 of file Block.php.

References IP\sanitizeRange(), and wfDeprecated().

Here is the call graph for this function:

static Block::parseExpiryInput ( $ expiry ) [static]

Convert a submitted expiry time, which may be relative ("2 weeks", etc) or absolute ("24 May 2034"), into an absolute timestamp we can put into the database.

Parameters:

$expiry String: whatever was typed into the form

Returns:: String: timestamp or "infinity" string for th DB implementation

Deprecated:: since 1.18 moved to SpecialBlock::parseExpiryInput()

Definition at line 1008 of file Block.php.

References wfDeprecated().

Here is the call graph for this function:

static Block::parseTarget ( $ target ) [static]

From an existing Block, get the target and the type of target.

Note that it is always safe to treat the target as a string; for User objects this will return User::__toString() which in turn gives User::getName().

Parameters:

$target String|Int|User