PHP108

PHP Arrays

What is an array?

So far, we have seen how to store a piece of data as a variable. If we wanted to store the name of a student we might use a variable called $student_name. If we had to store the names of three students we might use variables $student_name1, $student_name2 and $student_name3. It is easy to see how this could become inefficient, if not confusing. The structure we can use to simplify his is an array of variables, just called an 'array'. The following two diagrams contrast storing data in separate variables, compared to using an array.

• Seperate Variables

$student1="Jasmin";
$student2="Pardeep";
$student3="Simon";

• Array

$student[1]="Jasmin";
$student[2]="Pardeep";
$student[3]="Simon";

Arrays in PHP

PHP uses arrays in a more sophisticated manner than most high-level programming languages. It is also quite flexible in what you can do with them. The individual elements of an array may be accessed by a numeric index (as above), which is known as numbered, or by means of a text string, associative.

The array can hold scalar values:

• Integers
• Booleans
• Strings
• Floats

It can also hold compound values

• Objects
• Other Arrays

Creating an Array

The following example code shows how to create an array, how to 'populate' it and how to access individual elements within the array.

<?
   $primes = array(1,2,3,5,7,11,13);
   $words = ("Wolverhampton", "Computing", "University", "PHP");
   
   // Print the third element from the array of primes
   
   echo $primes[2];
   
   // Print the second element in the array of words
   
   echo $words[1];
 ?>

Note: - since, by default, the first element of the array is zero, the second element is stored in [1], the fifth element is in [4] etc. Also note the use of square parentheses.

Assigning Values to Elements of the Array

We can easily assign values to individual elements of the array, as is shown

<?
   $rainbow[0] = "Red";
   $rainbow[1] = "Orange";
   $rainbow[2] = "Blue";
   $rainbow[3] = "Green";
   // error to be corrected at element 2
   $rainbow[2] = "Yellow";
 ?>

Since some people find counting from zero confusing, or it does not 'map' readily to the real world example being modelled, it is possible to start the array at element one (rather than zero). For example:

<?
   $counting_numbers = array(1=>"one", "two", "three");
 ?>

The Empty Array

It is possible to declare an empty array, and indeed such a structure can be useful. A good example is if we want to log error messages which have been generated and store them in an array, the code might be similar to:

<?
   // declare an empty array
   $phones = array();
   
   // at some point an error is generated, and is to be stored
   
   $phones[] = "Matarola Raiser";
   
   // later still
   
   $phones[] = "Nuukeya 0001";
   
   // to test if there have been any inputs in the array
   
   if (empty($phones))
   {
     echo "No phones added";
   }
   else
   {
     echo "There are phones in the array.";
   }
 ?>

Note: - in the example the phones are added to the elements 0 and 1

Associative Arrays

Associative arrays give you the ability to name your array's keys. So, instead of having $array[0] and $array[1] you can have $array['aName'] and $array['anotherName'].

A Simple Array

Why would I want to use arrays rather than just regular variables? Imagine this: You are working with customer's names. You have 9 of them that you continually need to echo out. With regular variables, you would do it like this:

<?
  echo "$customer1<BR>\n";
  echo "$customer2<BR>\n";
  echo "$customer3<BR>\n";
  echo "$customer4<BR>\n";
  echo "$customer5<BR>\n";
  echo "$customer6<BR>\n";
  echo "$customer7<BR>\n";
  echo "$customer8<BR>\n";
  echo "$customer9<BR>\n";
 ?>

Even with only nine customers this is proving to be long winded. Imagine doing that with 100 customers. Or 1000. With arrays, you can use a 'foreach' loop. What a foreach loop does is loop as many times as you have elements in an array.

Suppose you had an array called $customer that contained your customer names.

<?
   foreach ($customer as $value)
   {
     echo "$value<BR>";
   }
 ?>

This is clearly an easier and more efficient way to access the array than to do so by accessing each element separately (as in the example of five customers). That code will not change if you have 100 or 1000 customers. That's the power of arrays.

Multidimensional Arrays

What about multi-dimensional arrays? What are they? Let's take a look at a two-dimensional array as an example. Say you are dealing with selling books. You want to place the names and prices of these books into an array. What you would want to do is create an array where each element is an array. Sound confusing? It really isn't. Take a look at this example:

<?
   $books = array
   (
     0=>array('name'='A Book','price'=>9.99),
     1=>array('name'='Another Book','price'=>17.99)
   );
 ?>

Now, here are a couple ways to access that data in our two-dimensional array:

<?
   echo $books[0]['name'];
   echo $books[1]['price'];
   $books[0]['price'] = 12.99;

   foreach ($books as $thisBook)
   {
     echo $thisBook['name'] . " sells for $". $thisBook['price'] . "<BR>";
   }
 ?>

So, as we have seen - it may be necessary to model data which can not be easily stored in a simple array. The classic example is the chessboard. In a game of chess we need to know which pieces are stored on which squares. Since the chess board has eight rows of eight squares, we need two parameters to determine which square on the chessboard we are referring to, ie the row and column. The other classic example is a theatre seating plan, which stores the row and the seat number in the row.

The latter can easily be extended from two dimensions (row, seat number) to three dimensions. The third dimension would be the date. We now have an array capable of storing the details of any seat in the theatre, for any performance by means of these three dimensions (row, seat number, date).

The following example is taken from Web Database Applications with PHP & MySQL By David Lane, Hugh E. Williams.

<html>
   <head>
     <title>Multi-dimensional arrays</title>
   </head>
   <body bgcolor="#ffffff">
     <h2>A two dimensional array</h2>
     <?
       // A two dimensional array using integer indexes
       $planets = array
       (
         array("Mercury", 0.39, 0.38),
         array("Venus", 0.72, 0.95),
         array("Earth", 1.0, 1.0),
         array("Mars", 1.52, 0.53)
       );
       // prints "Earth"
       print $planets[2][0];
     ?>

     <h2>More sophisticated multi-dimensional array</h2>
     <?
       // More sophisticated multi-dimensional array
       $planets2 = array
       (
         "Mercury"=> array("dist"=>0.39, "dia"=>0.38),
         "Venus"  => array("dist"=>0.39, "dia"=>0.95),
         "Earth"  => array("dist"=>1.0,  "dia"=>1.0, "moons"=>array("Moon")),
         "Mars"   => array("dist"=>0.39, "dia"=>0.53, "moons"=>array("Phobos", "Deimos"))
       );
       // prints "Moon"
       print $planets2["Earth"]["moons"][0];
     ?>
   </body>
 </html>  

The first array in the example above is a two-dimensional array, which is accessed using an integer index. The array of planets contains elements which themselves hold an array containing three values the name of the planet, its distance from the sun and the planet diameter (relative to the diameter of earth).

The second array in this example is more sophisticated in so far as it uses associative keys.

Ready to move on?

PHP109 - File Handling