<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>class</title> </head> <body><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="oop4.html">Classes and Objects (PHP 4)</a></div> <div class="next" style="text-align: right; float: right;"><a href="keyword.extends.html">extends</a></div> <div class="up"><a href="oop4.html">Classes and Objects (PHP 4)</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div><hr /><div id="keyword.class" class="sect1"> <h2 class="title"><em>class</em></h2> <p class="para"> A class is a collection of variables and functions working with these variables. Variables are defined by <em>var</em> and functions by <em>function</em>. A class is defined using the following syntax: </p> <p class="para"> <div class="informalexample"> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Cart </span><span style="color: #007700">{<br /> var </span><span style="color: #0000BB">$items</span><span style="color: #007700">; </span><span style="color: #FF8000">// Items in our shopping cart<br /><br /> // Add $num articles of $artnr to the cart<br /><br /> </span><span style="color: #007700">function </span><span style="color: #0000BB">add_item</span><span style="color: #007700">(</span><span style="color: #0000BB">$artnr</span><span style="color: #007700">, </span><span style="color: #0000BB">$num</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">items</span><span style="color: #007700">[</span><span style="color: #0000BB">$artnr</span><span style="color: #007700">] += </span><span style="color: #0000BB">$num</span><span style="color: #007700">;<br /> }<br /><br /> </span><span style="color: #FF8000">// Take $num articles of $artnr out of the cart<br /><br /> </span><span style="color: #007700">function </span><span style="color: #0000BB">remove_item</span><span style="color: #007700">(</span><span style="color: #0000BB">$artnr</span><span style="color: #007700">, </span><span style="color: #0000BB">$num</span><span style="color: #007700">) {<br /> if (</span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">items</span><span style="color: #007700">[</span><span style="color: #0000BB">$artnr</span><span style="color: #007700">] > </span><span style="color: #0000BB">$num</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">items</span><span style="color: #007700">[</span><span style="color: #0000BB">$artnr</span><span style="color: #007700">] -= </span><span style="color: #0000BB">$num</span><span style="color: #007700">;<br /> return </span><span style="color: #0000BB">true</span><span style="color: #007700">;<br /> } elseif (</span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">items</span><span style="color: #007700">[</span><span style="color: #0000BB">$artnr</span><span style="color: #007700">] == </span><span style="color: #0000BB">$num</span><span style="color: #007700">) {<br /> unset(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">items</span><span style="color: #007700">[</span><span style="color: #0000BB">$artnr</span><span style="color: #007700">]);<br /> return </span><span style="color: #0000BB">true</span><span style="color: #007700">;<br /> } else {<br /> return </span><span style="color: #0000BB">false</span><span style="color: #007700">;<br /> }<br /> }<br />}<br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> </div> </p> <p class="para"> This defines a class named Cart that consists of an associative array of articles in the cart and two functions to add and remove items from this cart. </p> <div class="warning"><strong class="warning">Warning</strong> <p class="simpara"> You can <em class="emphasis">NOT</em> break up a class definition into multiple files. You also can <em class="emphasis">NOT</em> break a class definition into multiple PHP blocks, unless the break is within a method declaration. The following will not work: </p> <p class="para"> <div class="informalexample"> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">test </span><span style="color: #007700">{<br /></span><span style="color: #0000BB">?><br /><?php<br /> </span><span style="color: #007700">function </span><span style="color: #0000BB">test</span><span style="color: #007700">() {<br /> print </span><span style="color: #DD0000">'OK'</span><span style="color: #007700">;<br /> }<br />}<br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> </div> </p> <p class="simpara"> However, the following is allowed: </p> <p class="para"> <div class="informalexample"> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">test </span><span style="color: #007700">{<br /> function </span><span style="color: #0000BB">test</span><span style="color: #007700">() {<br /> </span><span style="color: #0000BB">?><br /></span> <span style="color: #0000BB"><?php<br /> </span><span style="color: #007700">print </span><span style="color: #DD0000">'OK'</span><span style="color: #007700">;<br /> }<br />}<br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> </div> </p> </div> <p class="simpara"> The following cautionary notes are valid for PHP 4. </p> <div class="caution"><strong class="caution">Caution</strong> <p class="simpara"> The name <em>stdClass</em> is used internally by Zend and is reserved. You cannot have a class named <em>stdClass</em> in PHP. </p> </div> <div class="caution"><strong class="caution">Caution</strong> <p class="simpara"> The function names <em>__sleep</em> and <em>__wakeup</em> are magical in PHP classes. You cannot have functions with these names in any of your classes unless you want the magic functionality associated with them. See below for more information. </p> </div> <div class="caution"><strong class="caution">Caution</strong> <p class="simpara"> PHP reserves all function names starting with <em>__</em> as magical. It is recommended that you do not use function names with <em>__</em> in PHP unless you want some documented magic functionality. </p> </div> <p class="simpara"> In PHP 4, only constant initializers for <em>var</em> variables are allowed. To initialize variables with non-constant values, you need an initialization function which is called automatically when an object is being constructed from the class. Such a function is called a constructor (see below). </p> <div class="informalexample"> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Cart </span><span style="color: #007700">{<br /> </span><span style="color: #FF8000">/* None of these will work in PHP 4. */<br /> </span><span style="color: #007700">var </span><span style="color: #0000BB">$todays_date </span><span style="color: #007700">= </span><span style="color: #0000BB">date</span><span style="color: #007700">(</span><span style="color: #DD0000">"Y-m-d"</span><span style="color: #007700">);<br /> var </span><span style="color: #0000BB">$name </span><span style="color: #007700">= </span><span style="color: #0000BB">$firstname</span><span style="color: #007700">;<br /> var </span><span style="color: #0000BB">$owner </span><span style="color: #007700">= </span><span style="color: #DD0000">'Fred ' </span><span style="color: #007700">. </span><span style="color: #DD0000">'Jones'</span><span style="color: #007700">;<br /> </span><span style="color: #FF8000">/* Arrays containing constant values will, though. */<br /> </span><span style="color: #007700">var </span><span style="color: #0000BB">$items </span><span style="color: #007700">= array(</span><span style="color: #DD0000">"VCR"</span><span style="color: #007700">, </span><span style="color: #DD0000">"TV"</span><span style="color: #007700">);<br />}<br /><br /></span><span style="color: #FF8000">/* This is how it should be done. */<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Cart </span><span style="color: #007700">{<br /> var </span><span style="color: #0000BB">$todays_date</span><span style="color: #007700">;<br /> var </span><span style="color: #0000BB">$name</span><span style="color: #007700">;<br /> var </span><span style="color: #0000BB">$owner</span><span style="color: #007700">;<br /> var </span><span style="color: #0000BB">$items </span><span style="color: #007700">= array(</span><span style="color: #DD0000">"VCR"</span><span style="color: #007700">, </span><span style="color: #DD0000">"TV"</span><span style="color: #007700">);<br /><br /> function </span><span style="color: #0000BB">Cart</span><span style="color: #007700">() {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">todays_date </span><span style="color: #007700">= </span><span style="color: #0000BB">date</span><span style="color: #007700">(</span><span style="color: #DD0000">"Y-m-d"</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">name </span><span style="color: #007700">= </span><span style="color: #0000BB">$GLOBALS</span><span style="color: #007700">[</span><span style="color: #DD0000">'firstname'</span><span style="color: #007700">];<br /> </span><span style="color: #FF8000">/* etc. . . */<br /> </span><span style="color: #007700">}<br />}<br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> </div> <p class="para"> Classes are types, that is, they are blueprints for actual variables. You have to create a variable of the desired type with the <em>new</em> operator. </p> <div class="informalexample"> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br />$cart </span><span style="color: #007700">= new </span><span style="color: #0000BB">Cart</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$cart</span><span style="color: #007700">-></span><span style="color: #0000BB">add_item</span><span style="color: #007700">(</span><span style="color: #DD0000">"10"</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$another_cart </span><span style="color: #007700">= new </span><span style="color: #0000BB">Cart</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$another_cart</span><span style="color: #007700">-></span><span style="color: #0000BB">add_item</span><span style="color: #007700">(</span><span style="color: #DD0000">"0815"</span><span style="color: #007700">, </span><span style="color: #0000BB">3</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> </div> <p class="para"> This creates the objects <var class="varname"><var class="varname">$cart</var></var> and <var class="varname"><var class="varname">$another_cart</var></var>, both of the class Cart. The function <em>add_item()</em> of the <var class="varname"><var class="varname">$cart</var></var> object is being called to add 1 item of article number 10 to the <var class="varname"><var class="varname">$cart</var></var>. 3 items of article number 0815 are being added to <var class="varname"><var class="varname">$another_cart</var></var>. </p> <p class="para"> Both, <var class="varname"><var class="varname">$cart</var></var> and <var class="varname"><var class="varname">$another_cart</var></var>, have functions <em>add_item()</em>, <em>remove_item()</em> and a variable <var class="varname"><var class="varname">items</var></var>. These are distinct functions and variables. You can think of the objects as something similar to directories in a filesystem. In a filesystem you can have two different files <var class="filename">README.TXT</var>, as long as they are in different directories. Just like with directories where you'll have to type the full pathname in order to reach each file from the toplevel directory, you have to specify the complete name of the function you want to call: in PHP terms, the toplevel directory would be the global namespace, and the pathname separator would be <em>-></em>. Thus, the names <var class="varname"><var class="varname">$cart->items</var></var> and <var class="varname"><var class="varname">$another_cart->items</var></var> name two different variables. Note that the variable is named <var class="varname"><var class="varname">$cart->items</var></var>, not <var class="varname"><var class="varname">$cart->$items</var></var>, that is, a variable name in PHP has only a single dollar sign (<em>$</em>). </p> <div class="informalexample"> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">// correct, single $<br /></span><span style="color: #0000BB">$cart</span><span style="color: #007700">-></span><span style="color: #0000BB">items </span><span style="color: #007700">= array(</span><span style="color: #DD0000">"10" </span><span style="color: #007700">=> </span><span style="color: #0000BB">1</span><span style="color: #007700">); <br /><br /></span><span style="color: #FF8000">// invalid, because $cart->$items becomes $cart->""<br /></span><span style="color: #0000BB">$cart</span><span style="color: #007700">-></span><span style="color: #0000BB">$items </span><span style="color: #007700">= array(</span><span style="color: #DD0000">"10" </span><span style="color: #007700">=> </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// correct, but may or may not be what was intended:<br />// $cart->$myvar becomes $cart->items<br /></span><span style="color: #0000BB">$myvar </span><span style="color: #007700">= </span><span style="color: #DD0000">'items'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$cart</span><span style="color: #007700">-></span><span style="color: #0000BB">$myvar </span><span style="color: #007700">= array(</span><span style="color: #DD0000">"10" </span><span style="color: #007700">=> </span><span style="color: #0000BB">1</span><span style="color: #007700">); <br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> </div> <p class="para"> Within a class definition, you do not know under which name the object will be accessible in your program: at the time the Cart class was written, it was unknown whether the object would be named <var class="varname"><var class="varname">$cart</var></var>, <var class="varname"><var class="varname">$another_cart</var></var>, or something else later. Thus, you cannot write <var class="varname"><var class="varname">$cart->items</var></var> within the Cart class itself. Instead, in order to be able to access its own functions and variables from within a class, one can use the pseudo-variable <var class="varname"><var class="varname">$this</var></var> which can be read as 'my own' or 'current object'. Thus, '<var class="varname"><var class="varname">$this->items[$artnr]</var></var> += <var class="varname"><var class="varname">$num</var></var>' can be read as 'add <var class="varname"><var class="varname">$num</var></var> to the <var class="varname"><var class="varname">$artnr</var></var> counter of my own items array' or 'add <var class="varname"><var class="varname">$num</var></var> to the <var class="varname"><var class="varname">$artnr</var></var> counter of the items array within the current object'. </p> <blockquote class="note"><p><strong class="note">Note</strong>: <p class="para"> The <var class="varname"><var class="varname">$this</var></var> pseudo-variable is not usually defined if the method in which it is hosted is called statically. This is not, however, a strict rule: <var class="varname"><var class="varname">$this</var></var> is defined if a method is called statically from within another object. In this case, the value of <var class="varname"><var class="varname">$this</var></var> is that of the calling object. This is illustrated in the following example: <div class="informalexample"> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br /> function </span><span style="color: #0000BB">foo</span><span style="color: #007700">()<br /> {<br /> if (isset(</span><span style="color: #0000BB">$this</span><span style="color: #007700">)) {<br /> echo </span><span style="color: #DD0000">'$this is defined ('</span><span style="color: #007700">;<br /> echo </span><span style="color: #0000BB">get_class</span><span style="color: #007700">(</span><span style="color: #0000BB">$this</span><span style="color: #007700">);<br /> echo </span><span style="color: #DD0000">")\n"</span><span style="color: #007700">;<br /> } else {<br /> echo </span><span style="color: #DD0000">"\$this is not defined.\n"</span><span style="color: #007700">;<br /> }<br /> }<br />}<br /><br />class </span><span style="color: #0000BB">B<br /></span><span style="color: #007700">{<br /> function </span><span style="color: #0000BB">bar</span><span style="color: #007700">()<br /> {<br /> </span><span style="color: #0000BB">A</span><span style="color: #007700">::</span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br /> }<br />}<br /><br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= new </span><span style="color: #0000BB">A</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$a</span><span style="color: #007700">-></span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">A</span><span style="color: #007700">::</span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= new </span><span style="color: #0000BB">B</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$b</span><span style="color: #007700">-></span><span style="color: #0000BB">bar</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">B</span><span style="color: #007700">::</span><span style="color: #0000BB">bar</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> <p class="para">The above example will output:</p> <div class="example-contents screen"> <div class="cdata"><pre> $this is defined (a) $this is not defined. $this is defined (b) $this is not defined. </pre></div> </div> </div> </p> </p></blockquote> <blockquote class="note"><p><strong class="note">Note</strong>: <p class="para"> There are some nice functions to handle classes and objects. You might want to take a look at the <a href="ref.classobj.html" class="link">Class/Object Functions</a>. </p> </p></blockquote> </div><hr /><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="oop4.html">Classes and Objects (PHP 4)</a></div> <div class="next" style="text-align: right; float: right;"><a href="keyword.extends.html">extends</a></div> <div class="up"><a href="oop4.html">Classes and Objects (PHP 4)</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div></body></html>