Integers

An integer is a number of the set ℤ = {..., -2, -1, 0, 1, 2, ...}.

See also:

Syntax

Integers can be specified in decimal (base 10), hexadecimal (base 16), octal (base 8) or binary (base 2) notation, optionally preceded by a sign (- or +).

Binary integer literals are available since PHP 5.4.0.

To use octal notation, precede the number with a 0 (zero). To use hexadecimal notation precede the number with 0x. To use binary notation precede the number with 0b.

Example #1 Integer literals

<?php
$a 
1234// decimal number
$a = -123// a negative number
$a 0123// octal number (equivalent to 83 decimal)
$a 0x1A// hexadecimal number (equivalent to 26 decimal)
$a 0b11111111// binary number (equivalent to 255 decimal)
?>

Formally, the structure for integer literals is:

decimal     : [1-9][0-9]*
            | 0

hexadecimal : 0[xX][0-9a-fA-F]+

octal       : 0[0-7]+

binary      : 0b[01]+

integer     : [+-]?decimal
            | [+-]?hexadecimal
            | [+-]?octal
            | [+-]?binary

The size of an integer is platform-dependent, although a maximum value of about two billion is the usual value (that's 32 bits signed). 64-bit platforms usually have a maximum value of about 9E18, except on Windows prior to PHP 7, where it was always 32 bit. PHP does not support unsigned integers. Integer size can be determined using the constant PHP_INT_SIZE, maximum value using the constant PHP_INT_MAX since PHP 5.0.5, and minimum value using the constant PHP_INT_MIN since PHP 7.0.0.

Warning

Prior to PHP 7, if an invalid digit was given in an octal integer (i.e. 8 or 9), the rest of the number was ignored. Since PHP 7, a parse error is emitted.

Integer overflow

If PHP encounters a number beyond the bounds of the integer type, it will be interpreted as a float instead. Also, an operation which results in a number beyond the bounds of the integer type will return a float instead.

Example #2 Integer overflow on a 32-bit system

<?php
$large_number 
2147483647;
var_dump($large_number);                     // int(2147483647)

$large_number 2147483648;
var_dump($large_number);                     // float(2147483648)

$million 1000000;
$large_number =  50000 $million;
var_dump($large_number);                     // float(50000000000)
?>

Example #3 Integer overflow on a 64-bit system

<?php
$large_number 
9223372036854775807;
var_dump($large_number);                     // int(9223372036854775807)

$large_number 9223372036854775808;
var_dump($large_number);                     // float(9.2233720368548E+18)

$million 1000000;
$large_number =  50000000000000 $million;
var_dump($large_number);                     // float(5.0E+19)
?>

There is no integer division operator in PHP. 1/2 yields the float 0.5. The value can be casted to an integer to round it towards zero, or the round() function provides finer control over rounding.

<?php
var_dump
(25/7);         // float(3.5714285714286)
var_dump((int) (25/7)); // int(3)
var_dump(round(25/7));  // float(4)
?>

Converting to integer

To explicitly convert a value to integer, use either the (int) or (integer) casts. However, in most cases the cast is not needed, since a value will be automatically converted if an operator, function or control structure requires an integer argument. A value can also be converted to integer with the intval() function.

If a resource is converted to an integer, then the result will be the unique resource number assigned to the resource by PHP at runtime.

See also Type Juggling.

From booleans

FALSE will yield 0 (zero), and TRUE will yield 1 (one).

From floating point numbers

When converting from float to integer, the number will be rounded towards zero.

If the float is beyond the boundaries of integer (usually +/- 2.15e+9 = 2^31 on 32-bit platforms and +/- 9.22e+18 = 2^63 on 64-bit platforms other than Windows), the result is undefined, since the float doesn't have enough precision to give an exact integer result. No warning, not even a notice will be issued when this happens!

Note:

As of PHP 7.0.0, instead of being undefined and platform-dependent, NaN and Infinity will always be zero when cast to integer.

Warning

Never cast an unknown fraction to integer, as this can sometimes lead to unexpected results.

<?php
echo (int) ( (0.1+0.7) * 10 ); // echoes 7!
?>

See also the warning about float precision.

From strings

See String conversion to numbers

From other types

Caution

The behaviour of converting to integer is undefined for other types. Do not rely on any observed behaviour, as it can change without notice.

add a note add a note

User Contributed Notes 22 notes

up
36
php at richardneill dot org
4 years ago
A leading zero in a numeric literal means "this is octal". But don't be confused: a leading zero in a string does not. Thus:
$x = 0123;          // 83
$y = "0123" + 0     // 123
up
40
d_n at NOSPAM dot Loryx dot com
10 years ago
Here are some tricks to convert from a "dotted" IP address to a LONG int, and backwards. This is very useful because accessing an IP addy in a database table is very much faster if it's stored as a BIGINT rather than in characters.

IP to BIGINT:
<?php
  $ipArr   
= explode('.',$_SERVER['REMOTE_ADDR']);
 
$ip       = $ipArr[0] * 0x1000000
           
+ $ipArr[1] * 0x10000
           
+ $ipArr[2] * 0x100
           
+ $ipArr[3]
            ;
?>

IP as BIGINT read from db back to dotted form:

Keep in mind, PHP integer operators are INTEGER -- not long. Also, since there is no integer divide in PHP, we save a couple of S-L-O-W floor (<division>)'s by doing bitshifts. We must use floor(/) for $ipArr[0] because though $ipVal is stored as a long value, $ipVal >> 24 will operate on a truncated, integer value of $ipVal! $ipVint is, however, a nice integer, so
we can enjoy the bitshifts.

<?php
        $ipVal
= $row['client_IP'];
       
$ipArr = array(0 =>
                   
floor$ipVal               / 0x1000000) );
       
$ipVint   = $ipVal-($ipArr[0]*0x1000000); // for clarity
       
$ipArr[1] = ($ipVint & 0xFF0000)  >> 16;
       
$ipArr[2] = ($ipVint & 0xFF00  )  >> 8;
       
$ipArr[3] =  $ipVint & 0xFF;
       
$ipDotted = implode('.', $ipArr);
?>
up
15
Anonymous
2 years ago
Converting to an integer works only if the input begins with a number
(int) "5txt" // will output the integer 5
(int) "before5txt" // will output the integer 0
(int) "53txt" // will output the integer 53
(int) "53txt534text" // will output the integer 53
up
18
rustamabd@gmail-you-know-what
11 years ago
Be careful with using the modulo operation on big numbers, it will cast a float argument to an int and may return wrong results. For example:
<?php
    $i
= 6887129852;
    echo
"i=$i\n";
    echo
"i%36=".($i%36)."\n";
    echo
"alternative i%36=".($i-floor($i/36)*36)."\n";
?>
Will output:
i=6.88713E+009
i%36=-24
alternative i%36=20
up
3
Jacek
10 years ago
On 64 bits machines max integer value is 0x7fffffffffffffff (9 223 372 036 854 775 807).
up
0
dhairya lakhera
21 days ago
-------------------------------------------------------------------------
Question :
var_dump((int) 010);  //Output 8

var_dump((int) "010"); //output 10

First one is octal notation so the output is correct. But what about the when converting "010" to integer. it should be also output 8 ?
--------------------------------------------------------------------------
Answer :

Casting to an integer using (int) will always cast to the default base, which is 10.

Casting a string to a number this way does not take into account the many ways of formatting an integer value in PHP (leading zero for base 8, leading "0x" for base 16, leading "0b" for base 2). It will simply look at the first characters in a string and convert them to a base 10 integer. Leading zeroes will be stripped off because they have no meaning in numerical values, so you will end up with the decimal value 10 for (int)"010".

Converting an integer value between bases using (int)010 will take into account the various ways of formatting an integer. A leading zero like in 010 means the number is in octal notation, using (int)010 will convert it to the decimal value 8 in base 10.

This is similar to how you use 0x10 to write in hexadecimal (base 16) notation. Using (int)0x10 will convert that to the base 10 decimal value 16, whereas using (int)"0x10" will end up with the decimal value 0: since the "x" is not a numerical value, anything after that will be ignored.

If you want to interpret the string "010" as an octal value, you need to instruct PHP to do so. intval("010", 8) will interpret the number in base 8 instead of the default base 10, and you will end up with the decimal value 8. You could also use octdec("010") to convert the octal string to the decimal value 8. Another option is to use base_convert("010", 8, 10) to explicitly convert the number "010" from base 8 to base 10, however this function will return the string "8" instead of the integer 8.

Casting a string to an integer follows the same the logic used by the intval function:

Returns the integer value of var, using the specified base for the conversion (the default is base 10).
intval allows specifying a different base as the second argument, whereas a straight cast operation does not, so using (int) will always treat a string as being in base 10.

php > var_export((int) "010");
10
php > var_export(intval("010"));
10
php > var_export(intval("010", 8));
8
up
2
darkshire
10 years ago
d_n at NOSPAM dot Loryx dot com
13-Aug-2007 05:33
Here are some tricks to convert from a "dotted" IP address to a LONG int, and backwards. This is very useful because accessing an IP addy in a database table is very much faster if it's stored as a BIGINT rather than in characters.

IP to BIGINT:
<?php
  $ipArr   
= explode('.',$_SERVER['REMOTE_ADDR']);
 
$ip       = $ipArr[0] * 0x1000000
           
+ $ipArr[1] * 0x10000
           
+ $ipArr[2] * 0x100
           
+ $ipArr[3]
            ;
?>

This can be written in a bit more efficient way:
<?php
  $ipArr   
= explode('.',$_SERVER['REMOTE_ADDR']);
 
$ip       = $ipArr[0]<<24
           
+ $ipArr[1]<<16
           
+ $ipArr[2] <<8
           
+ $ipArr[3]
            ;
?>

shift is more cheaper.
up
0
litbai
1 year ago
<?php
$ipArr
= explode('.', $ipString);
$ipVal = ($ipArr[0] << 24)
       + (
$ipArr[1] << 16)
       + (
$ipArr[2] << 8)
       +
$ipArr[3]
        ;
?>
1. the priority of bit op is lower than '+',so there should be brackets.
2. there is no unsighed int in PHP, if you use 32 bit version,the code above will get negative result when the first position of IP string greater than 127.
3. what the code actually do is calculate the integer value of transformed 32 binary bit from IP string.
up
-1
egwayjen at gmail dot com
15 days ago
"There is no integer division operator in PHP". But since PHP 7, there is the intdiv function.
up
1
Anonymous
10 years ago
To force the correct usage of 32-bit unsigned integer in some functions, just add '+0'  just before processing them.

for example
echo(dechex("2724838310"));
will print '7FFFFFFF'
but it should print 'A269BBA6'

When adding '+0' php will handle the 32bit unsigned integer
correctly
echo(dechex("2724838310"+0));
will print 'A269BBA6'
up
0
Anonymous
13 years ago
"iF-iv cCi/stecho5age=4 <0s="usegerii- "5t"Hcohref="#38478" class="name">
&of (nalp >(ode><)2147/>W647/span>we canal- m(ode><)"4294967296" & 8, 10)ot, s$x
029/st1lass="tally" id="V121917" title="0% like pode"
029/str class="user">egwayjen at gmail do1Jacek5/em>59strong> ¶
13 years ago /i; t("01em> o xpis lowes 32-bion wili)'s by d.

0x5468792130ABCDEF

">10&ndiv.

6.08224448022an c18 (--------ode><)

Ono5agenegarong>10&ndiv.

608224448022an02255t the code actually do is calculate the integer value of transfo1r / class="default">?>
=dr / c1lass="tally" id="V121917" title="0% like dewi 0" dewimorgan
1r / claname"> Anonymo5us4strong>
13 years agowomne c.h4> nabr / willan cse 32 to th;
$s
las (the$im, $a />13-$chpcod a basg>13-d" If="lantrong>in so. ivbr t negaran/spae ivbONGg a strin2-bither $0 wilim, "010"no rteop ig t-/dipr /ss t a bas.h4> LCGd a basg8" int, wyithed()iv clystemse downBorl>13-Delphi, Vir t n Pascal, MS Vi]wom, Newlib, MMXlas * ne*e a1 re isexpor[0]="typnion ofwo rtasde"><>13-e">
- Iing topes.i v> 13- ne1
op;v> <64, bug to the decibsp; &ntonbt;)'ssed by t53-nbsp;vr issa />13-bspdroplefi 13 yasgh $pross leadbewpcodh $re isexpoument,functima10",oorityclass=" lystemiilar eger s="tpriority div>eger seld:lang1mlddy i$a = L Loryt ve2^22r(g tolimi 8 in )cana-1 class=ss tstetp willss="acan>d:l1+(4*(se, illss=Arr<= 1048573)urns the$ch= ">d:lse, illss=Arr<= 2362232ro iml"> "There is no integer division operator in PHP". But since PH189" // will output the integer 53
=d89" 1lass="tally" id="V121917" title="0% like pi. -1
H189" //ass="user">rustamabd@gmail-you-know-wha21em><50strong>
11 years ago?>
<?php
$ipArr
?&E_ALLspan>'.'
t;
$ipString<?php
$ipArr
$ipString<?php
$ipArr
?&tbd@gspan>'.'< .lt; )*36)tbd@g class="default">$ipString = ("i=t; <?php
$ipArr
?&tbd@gspan>'.'<;

t;
).<?php
$ipArr
$ipString<?php
$ipArr
?&tfo="default"><?php
$ipAr< .lt;
)*36)tfo="keyword">). = (<?php"i=t; <?php
$ipArr
?&tfo="default"><?php
$ipAr<;

;?phplt;
). = (l.">rd">%36
d="V73 <?php
$ipArr< {er, a nice integer, so
we cat;
%3636<}n class="default">3]
&nbsAnt)"0x1eyt,functi See eis ba.typesfboth tfo=">13-$bd@g vert"a bate ver0 class="Hlong val11523"> ways div>asd.

tbd@g isethis starcemh $Daup"br />
Notice: Objpesfh $;?phplDaupnumber waysbean class="typehe prio/h">tbd@g isenowl1ns the in(1)
tfo="isethis starcemh $fo="br />
Notice: Objpesfh $;?phplfo="umber waysbean class="typehe prio/h">tfo="isenowl1ns the in(1)
/>  &nis characters objpes
g zero class="typebooing."To forcrgumenn class="typehe ml"> "There is no integer division operator in PHP". But since P861836=-24
alternative i%36=20
<861836=ger&vote=up" title="Vote up!" class86183d="71709">
8618361lass="tally" id="V121917" title="0% like wbcars
861836=-ass="user">rustamabd@gmail-you-kno8n1n-06em> ¶
13 years ago

13-automaticf="la-co base rout bsp;rackthe ty ba
wdi>13- neowlred.
i,c/sing . Iinilar c----->13-e">. To klassoing aalue ---I
Ketp wmy scriptctrinhalf.h4> topnhalf giv13-e strinbsphalf > get n/ willan bea"ruVd7or "execuphp? integer value of $ipVal! $ipVint is, however, a s="default">3word">]* *bsuildyword">ogram'ntropabilita -ion:inc ".13-"phpcode"las
*/span>,
&l"keyword"= we cat; ]*3. whspan>, .>= ('REMOTE_ADDR']*, ]*but it shspan class="keyword">,
<?php
.>= (
'REMOTE_ADDR']*< -i h s r diviesult whe()
/>&nbs= (
<?php
$ipArr<{er, a nice inglobjoy the bitshifts.
,
<?php
$ipAr>explode
<?php
$ipAr>explode
%36, <?php
$ipArr
?&t<?php
$ipAr>explode
[
<?php<?php
$ipArrr
?&t
$ipArr
<?php
$ipAr)>explode
/>&nbstoes.inN*t; ('.'r< {er, a nice inglobjoy the bitshifts.
,
<?php
$ipAr>explode
<?php
$ipAr>explode
<?php
$ipAr>explode
%36< 8, 10)ode>, <?php<?php6887129852<?php%%36<}
/>&nbs= (
]* *bruVyword">ogram -is r d" I,iesu wm */span>,
&l"keyword"Cptheed">)*36)t %36,     $i <?php
$ipArr<;nice integer, so
we caE_ADDR'
]*&nbs= ().(
'.'r<;E_ADDR']*
t;
&l"keyword"Chickerd">)*36)t = ('REMO']*36, 'REMO">'REMO']*36, <?php
$ipArr<;nice integer, so
we caE_ADDR'
]*&nbs= ().(
'.'r<;E_ADDR']*, qtat3.5, totjo=$2.8>]t">36, ]
ogram vertret se, he deci(ode>< ="Hcot) t("otem illcem="Hquvr itytrin2-bituna hr*V73

apabilita V73 ogramn o operation,bckwa c div>ault whenm "There is no integer division operator in PHP". But since P8>i%36=-24
alternative i%36=20 <8s.integer&vote=up" title="Vote up!" class8e" id="73790">
8
8790" class="name"> 50trrong> ¶
10 years ago] stehr*ar troyswanson
-2147/>W648 fer&ctrit0 2-bither ="tex FFFF'
butsa ct310")se asswarfs verode>< class="Hlong val-2147/>W647-1 ><?php
$ipArr i%36="]*<(-2147/>W648/span><?php
$ipArr i%36="
-code> ]*
W648/span>, ]
  &nis prosessyc LONGal notation2-biMS Cbsugi
n base assw-2147/>W648 valueUNSIGNED characteit32-inkswards.) "0the numther ="tapFFFF'
<,f="lanaioughwa c dis unique c-----"-xalto acc numther ="tan r /Cthe number is eibnor cude">W648"="010""0x8">[ it to the dequi a ">] the numrn thhe decCthe number iHopomilar helpsrt thaaccode ds.goi)'s=nthe number iPea c

- Eue / fezl"> "There is no integer division operator in PHP". But since P103442tr binary bit from IP string.
=03442t class="tally" id="V73790" title="51% lik10")ar ke010",yl rill
03442tr class="user">egwayjen at gmail do1Ja4-13 11:08strong> ¶
10 years ago
]shal value a ba)iilar > "> 8, 102dl vaSlue -XMLEs rsidi>13-ways dii positis' n.
<1int,adimax(),>eis ban a the number i"> 13-bsp0 d)use rit_INT_MAX Po do so. ml"> rackrit_INT_MAX (>13-vlcem Seatsed ets.
"lu8. You coul--------(ode><) convertml"> "There is no integer division operator in PHP". But since P69181tr binary bit from IP string.
69181t class="tally" id="V73790" title="51% likjmw254)ar co102l
69181tr ass="user">rustamabd@gmail-you-know-m8-25/em><4strong>1a class="genanchor" href="#116479"> ¶
10 years ago<{er, a nice integer, $ip=ode>
d="V73 363636363636<}<"> "There is no integer division operator in PHP". But since P86580));
will print 'A269BBA6'
<86580))ger&vote=up" title="Vote up!" class86580d="71709">
86580) class="tally" id="V73790" title="51% likHamza Burak Ylmazv>
86580));ass="user">rustamabd@gmail-you-kno8n1n-24 02:36trrong> ¶
1 year ago
]*&nbs />&nbs//toes.inN*to labr />i />&nbs= (<?php
$ipArr
?&the dec+ ( = ( = ('REMOTE_ADDRn>]* <?php
$ipArr
?&the dec+ (<?php
$ipAr++/string">'REMOT span>?&the dec+ (6887129852= (<?php
$ipAr/ span><} />&nbs />&nbs>]*&nbs>?&the     $i &nbs>?&the dec_of_digi,c/ <?php
$ipArr
?&the + (]* esu w:) />&nbs= ().    $i &nbs>]*&nbs>?&ss="ke"> "There> "There is no integer division operator in PHP". But since P494d 32 binary bit from IP string.