Sei sulla pagina 1di 363

PHP 5 Tutorial

❮ HomeNext ❯

PHP is a server scripting language, and a powerful tool for making dynamic
and interactive Web pages.

PHP is a widely-used, free, and efficient alternative to competitors such as


Microsoft's ASP.

Easy Learning with "Show PHP"


Our "Show PHP" tool makes it easy to learn PHP, it shows both the PHP source
code and the HTML output of the code.

Example
<!DOCTYPE html>
<html>
<body>

<?php
echo "My first PHP script!";
?>

</body>
</html>
Run example »
PHP 5 Introduction
❮ PreviousNext ❯

PHP scripts are executed on the server.

What You Should Already Know


Before you continue you should have a basic understanding of the following:

 HTML
 CSS
 JavaScript

If you want to study these subjects first, find the tutorials on ourHome page.

What is PHP?
 PHP is an acronym for "PHP: Hypertext Preprocessor"
 PHP is a widely-used, open source scripting language
 PHP scripts are executed on the server
 PHP is free to download and use

PHP is an amazing and popular language!

It is powerful enough to be at the core of the biggest blogging system on the


web (WordPress)!
It is deep enough to run the largest social network (Facebook)!
It is also easy enough to be a beginner's first server side language!

What is a PHP File?


 PHP files can contain text, HTML, CSS, JavaScript, and PHP code
 PHP code are executed on the server, and the result is returned to the
browser as plain HTML
 PHP files have extension ".php"

What Can PHP Do?


 PHP can generate dynamic page content
 PHP can create, open, read, write, delete, and close files on the server
 PHP can collect form data
 PHP can send and receive cookies
 PHP can add, delete, modify data in your database
 PHP can be used to control user-access
 PHP can encrypt data

With PHP you are not limited to output HTML. You can output images, PDF files,
and even Flash movies. You can also output any text, such as XHTML and XML.

Why PHP?
 PHP runs on various platforms (Windows, Linux, Unix, Mac OS X, etc.)
 PHP is compatible with almost all servers used today (Apache, IIS, etc.)
 PHP supports a wide range of databases
 PHP is free. Download it from the official PHP resource: www.php.net
 PHP is easy to learn and runs efficiently on the server side
PHP 5 Installation
❮ PreviousNext ❯

What Do I Need?
To start using PHP, you can:

 Find a web host with PHP and MySQL support


 Install a web server on your own PC, and then install PHP and MySQL

Use a Web Host With PHP Support


If your server has activated support for PHP you do not need to do anything.

Just create some .php files, place them in your web directory, and the server
will automatically parse them for you.

You do not need to compile anything or install any extra tools.

Because PHP is free, most web hosts offer PHP support.

Set Up PHP on Your Own PC


However, if your server does not support PHP, you must:

 install a web server


 install PHP
 install a database, such as MySQL

The official PHP website (PHP.net) has installation instructions for


PHP: http://php.net/manual/en/install.php
PHP 5 Syntax
❮ PreviousNext ❯

A PHP script is executed on the server, and the plain HTML result is sent
back to the browser.

Basic PHP Syntax


A PHP script can be placed anywhere in the document.

A PHP script starts with <?php and ends with ?>:

<?php
// PHP code goes here
?>

The default file extension for PHP files is ".php".

A PHP file normally contains HTML tags, and some PHP scripting code.

Below, we have an example of a simple PHP file, with a PHP script that uses a
built-in PHP function "echo" to output the text "Hello World!" on a web page:

Example
<!DOCTYPE html>
<html>
<body>

<h1>My first PHP page</h1>

<?php
echo "Hello World!";
?>

</body>
</html>
Run example »
Note: PHP statements end with a semicolon (;).

Comments in PHP
A comment in PHP code is a line that is not read/executed as part of the
program. Its only purpose is to be read by someone who is looking at the code.

Comments can be used to:

 Let others understand what you are doing


 Remind yourself of what you did - Most programmers have experienced
coming back to their own work a year or two later and having to re-figure
out what they did. Comments can remind you of what you were thinking
when you wrote the code

PHP supports several ways of commenting:

Example
<!DOCTYPE html>
<html>
<body>

<?php
// This is a single-line comment

# This is also a single-line comment

/*
This is a multiple-lines comment block
that spans over multiple
lines
*/

// You can also use comments to leave out parts of a code line
$x = 5 /* + 15 */ + 5;
echo $x;
?>
</body>
</html>
Run example »

PHP Case Sensitivity


In PHP, NO keywords (e.g. if, else, while, echo, etc.), classes, functions, and
user-defined functions are case-sensitive.

In the example below, all three echo statements below are legal (and equal):

Example
<!DOCTYPE html>
<html>
<body>

<?php
ECHO "Hello World!<br>";
echo "Hello World!<br>";
EcHo "Hello World!<br>";
?>

</body>
</html>
Run example »

However; all variable names are case-sensitive.

In the example below, only the first statement will display the value of the
$color variable (this is because $color, $COLOR, and $coLOR are treated as
three different variables):

Example
<!DOCTYPE html>
<html>
<body>

<?php
$color = "red";
echo "My car is " . $color . "<br>";
echo "My house is " . $COLOR . "<br>";
echo "My boat is " . $coLOR . "<br>";
?>

</body>
</html>
Run example »

Test Yourself With Exercises


Exercise:
Insert the missing part of the code below to output "Hello World".

"Hello World";
PHP 5 Variables
❮ PreviousNext ❯

Variables are "containers" for storing information.

Creating (Declaring) PHP Variables


In PHP, a variable starts with the $ sign, followed by the name of the variable:

Example
<?php
$txt = "Hello world!";
$x = 5;
$y = 10.5;
?>
Run example »

After the execution of the statements above, the variable $txt will hold the
value Hello world!, the variable $x will hold the value 5, and the
variable $y will hold the value 10.5.

Note: When you assign a text value to a variable, put quotes around the value.

Note: Unlike other programming languages, PHP has no command for declaring
a variable. It is created the moment you first assign a value to it.

Think of variables as containers for storing data.

PHP Variables
A variable can have a short name (like x and y) or a more descriptive name
(age, carname, total_volume).

Rules for PHP variables:


 A variable starts with the $ sign, followed by the name of the variable
 A variable name must start with a letter or the underscore character
 A variable name cannot start with a number
 A variable name can only contain alpha-numeric characters and
underscores (A-z, 0-9, and _ )
 Variable names are case-sensitive ($age and $AGE are two different
variables)

Remember that PHP variable names are case-sensitive!

Output Variables
The PHP echo statement is often used to output data to the screen.

The following example will show how to output text and a variable:

Example
<?php
$txt = "W3Schools.com";
echo "I love $txt!";
?>
Run example »

The following example will produce the same output as the example above:

Example
<?php
$txt = "W3Schools.com";
echo "I love " . $txt . "!";
?>
Run example »

The following example will output the sum of two variables:

Example
<?php
$x = 5;
$y = 4;
echo $x + $y;
?>
Run example »

Note: You will learn more about the echo statement and how to output data to
the screen in the next chapter.

PHP is a Loosely Typed Language


In the example above, notice that we did not have to tell PHP which data type
the variable is.

PHP automatically converts the variable to the correct data type, depending on
its value.

In other languages such as C, C++, and Java, the programmer must declare
the name and type of the variable before using it.

PHP Variables Scope


In PHP, variables can be declared anywhere in the script.

The scope of a variable is the part of the script where the variable can be
referenced/used.

PHP has three different variable scopes:

 local
 global
 static

Global and Local Scope


A variable declared outside a function has a GLOBAL SCOPE and can only be
accessed outside a function:
Example
<?php
$x = 5; // global scope

function myTest() {
// using x inside this function will generate an error
echo "<p>Variable x inside function is: $x</p>";
}
myTest();

echo "<p>Variable x outside function is: $x</p>";


?>
Run example »

A variable declared within a function has a LOCAL SCOPE and can only be
accessed within that function:

Example
<?php
function myTest() {
$x = 5; // local scope
echo "<p>Variable x inside function is: $x</p>";
}
myTest();

// using x outside the function will generate an error


echo "<p>Variable x outside function is: $x</p>";
?>
Run example »

You can have local variables with the same name in different functions, because
local variables are only recognized by the function in which they are declared.

PHP The global Keyword


The global keyword is used to access a global variable from within a function.

To do this, use the global keyword before the variables (inside the function):
Example
<?php
$x = 5;
$y = 10;

function myTest() {
global $x, $y;
$y = $x + $y;
}

myTest();
echo $y; // outputs 15
?>
Run example »

PHP also stores all global variables in an array called $GLOBALS[index].


The index holds the name of the variable. This array is also accessible from
within functions and can be used to update global variables directly.

The example above can be rewritten like this:

Example
<?php
$x = 5;
$y = 10;

function myTest() {
$GLOBALS['y'] = $GLOBALS['x'] + $GLOBALS['y'];
}

myTest();
echo $y; // outputs 15
?>
Run example »

PHP The static Keyword


Normally, when a function is completed/executed, all of its variables are
deleted. However, sometimes we want a local variable NOT to be deleted. We
need it for a further job.
To do this, use the static keyword when you first declare the variable:

Example
<?php
function myTest() {
static $x = 0;
echo $x;
$x++;
}

myTest();
myTest();
myTest();
?>
Run example »

Then, each time the function is called, that variable will still have the
information it contained from the last time the function was called.

Note: The variable is still local to the function.

Test Yourself With Exercises


Exercise:
Create a variable named txt and assign the value "Hello".

= " ";
PHP 5 echo and print Statements
❮ PreviousNext ❯

In PHP there are two basic ways to get output: echo and print.

In this tutorial we use echo (and print) in almost every example. So, this
chapter contains a little more info about those two output statements.

PHP echo and print Statements


echo and print are more or less the same. They are both used to output data
to the screen.

The differences are small: echo has no return value while printhas a return
value of 1 so it can be used in expressions. echo can take multiple parameters
(although such usage is rare) while print can take one argument. echo is
marginally faster than print.

The PHP echo Statement


The echo statement can be used with or without parentheses:echo or echo().

Display Text

The following example shows how to output text with the echocommand (notice
that the text can contain HTML markup):

Example
<?php
echo "<h2>PHP is Fun!</h2>";
echo "Hello world!<br>";
echo "I'm about to learn PHP!<br>";
echo "This ", "string ", "was ", "made ", "with multiple parameters.";
?>
Run example »

Display Variables

The following example shows how to output text and variables with
the echo statement:

Example
<?php
$txt1 = "Learn PHP";
$txt2 = "W3Schools.com";
$x = 5;
$y = 4;

echo "<h2>" . $txt1 . "</h2>";


echo "Study PHP at " . $txt2 . "<br>";
echo $x + $y;
?>
Run example »

The PHP print Statement


The print statement can be used with or without
parentheses:print or print().

Display Text

The following example shows how to output text with the printcommand
(notice that the text can contain HTML markup):

Example
<?php
print "<h2>PHP is Fun!</h2>";
print "Hello world!<br>";
print "I'm about to learn PHP!";
?>
Run example »

Display Variables

The following example shows how to output text and variables with
the print statement:

Example
<?php
$txt1 = "Learn PHP";
$txt2 = "W3Schools.com";
$x = 5;
$y = 4;

print "<h2>" . $txt1 . "</h2>";


print "Study PHP at " . $txt2 . "<br>";
print $x + $y;
?>
PHP 5 Data Types
❮ PreviousNext ❯

PHP Data Types


Variables can store data of different types, and different data types can do
different things.

PHP supports the following data types:

 String
 Integer
 Float (floating point numbers - also called double)
 Boolean
 Array
 Object
 NULL
 Resource

PHP String
A string is a sequence of characters, like "Hello world!".

A string can be any text inside quotes. You can use single or double quotes:

Example
<?php
$x = "Hello world!";
$y = 'Hello world!';

echo $x;
echo "<br>";
echo $y;
?>
Run example »
PHP Integer
An integer data type is a non-decimal number between -2,147,483,648 and
2,147,483,647.

Rules for integers:

 An integer must have at least one digit


 An integer must not have a decimal point
 An integer can be either positive or negative
 Integers can be specified in three formats: decimal (10-based),
hexadecimal (16-based - prefixed with 0x) or octal (8-based - prefixed
with 0)

In the following example $x is an integer. The PHP var_dump() function returns


the data type and value:

Example
<?php
$x = 5985;
var_dump($x);
?>
Run example »

PHP Float
A float (floating point number) is a number with a decimal point or a number in
exponential form.

In the following example $x is a float. The PHP var_dump() function returns the
data type and value:

Example
<?php
$x = 10.365;
var_dump($x);
?>
Run example »

PHP Boolean
A Boolean represents two possible states: TRUE or FALSE.

$x = true;
$y = false;

Booleans are often used in conditional testing. You will learn more about
conditional testing in a later chapter of this tutorial.

PHP Array
An array stores multiple values in one single variable.

In the following example $cars is an array. The PHP var_dump() function


returns the data type and value:

Example
<?php
$cars = array("Volvo","BMW","Toyota");
var_dump($cars);
?>
Run example »

You will learn a lot more about arrays in later chapters of this tutorial.

PHP Object
An object is a data type which stores data and information on how to process
that data.
In PHP, an object must be explicitly declared.

First we must declare a class of object. For this, we use the class keyword. A
class is a structure that can contain properties and methods:

Example
<?php
class Car {
function Car() {
$this->model = "VW";
}
}

// create an object
$herbie = new Car();

// show object properties


echo $herbie->model;
?>
Run example »

PHP NULL Value


Null is a special data type which can have only one value: NULL.

A variable of data type NULL is a variable that has no value assigned to it.

Tip: If a variable is created without a value, it is automatically assigned a value


of NULL.

Variables can also be emptied by setting the value to NULL:

Example
<?php
$x = "Hello world!";
$x = null;
var_dump($x);
?>
Run example »
PHP Resource
The special resource type is not an actual data type. It is the storing of a
reference to functions and resources external to PHP.

A common example of using the resource data type is a database call.

We will not talk about the resource type here, since it is an advanced topic.
PHP 5 Strings
❮ PreviousNext ❯

A string is a sequence of characters, like "Hello world!".

PHP String Functions


In this chapter we will look at some commonly used functions to manipulate
strings.

Get The Length of a String


The PHP strlen() function returns the length of a string.

The example below returns the length of the string "Hello world!":

Example
<?php
echo strlen("Hello world!"); // outputs 12
?>
Run example »

The output of the code above will be: 12.

Count The Number of Words in a String


The PHP str_word_count() function counts the number of words in a string:

Example
<?php
echo str_word_count("Hello world!"); // outputs 2
?>
Run example »

The output of the code above will be: 2.

Reverse a String
The PHP strrev() function reverses a string:

Example
<?php
echo strrev("Hello world!"); // outputs !dlrow olleH
?>
Run example »

The output of the code above will be: !dlrow olleH.

Search For a Specific Text Within a String


The PHP strpos() function searches for a specific text within a string.

If a match is found, the function returns the character position of the first
match. If no match is found, it will return FALSE.

The example below searches for the text "world" in the string "Hello world!":

Example
<?php
echo strpos("Hello world!", "world"); // outputs 6
?>
Run example »

The output of the code above will be: 6.


Tip: The first character position in a string is 0 (not 1).

Replace Text Within a String


The PHP str_replace() function replaces some characters with some other
characters in a string.

The example below replaces the text "world" with "Dolly":

Example
<?php
echo str_replace("world", "Dolly", "Hello world!"); // outputs Hello
Dolly!
?>
Run example »

The output of the code above will be: Hello Dolly!

Complete PHP String Reference


For a complete reference of all string functions, go to our complete PHP String
Reference.

The PHP string reference contains description and example of use, for each
function!

Test Yourself With Exercises


Exercise:
Get the length of the string "Hello World!".

echo ("Hello World!");


PHP 5 Constants
❮ PreviousNext ❯

Constants are like variables except that once they are defined they cannot
be changed or undefined.

PHP Constants
A constant is an identifier (name) for a simple value. The value cannot be
changed during the script.

A valid constant name starts with a letter or underscore (no $ sign before the
constant name).

Note: Unlike variables, constants are automatically global across the entire
script.

Create a PHP Constant


To create a constant, use the define() function.

Syntax
define(name, value, case-insensitive)

Parameters:

 name: Specifies the name of the constant


 value: Specifies the value of the constant
 case-insensitive: Specifies whether the constant name should be case-
insensitive. Default is false

The example below creates a constant with a case-sensitivename:


Example
<?php
define("GREETING", "Welcome to W3Schools.com!");
echo GREETING;
?>
Run example »

The example below creates a constant with a case-insensitivename:

Example
<?php
define("GREETING", "Welcome to W3Schools.com!", true);
echo greeting;
?>
Run example »

Constants are Global


Constants are automatically global and can be used across the entire script.

The example below uses a constant inside a function, even if it is defined


outside the function:

Example
<?php
define("GREETING", "Welcome to W3Schools.com!");

function myTest() {
echo GREETING;
}

myTest();
?>
PHP 5 Operators
❮ PreviousNext ❯

PHP Operators
Operators are used to perform operations on variables and values.

PHP divides the operators in the following groups:

 Arithmetic operators
 Assignment operators
 Comparison operators
 Increment/Decrement operators
 Logical operators
 String operators
 Array operators

PHP Arithmetic Operators


The PHP arithmetic operators are used with numeric values to perform common
arithmetical operations, such as addition, subtraction, multiplication etc.

Operator Name Example Result Show


it

+ Addition $x + $y Sum of $x and $y Show


it »

- Subtraction $x - $y Difference of $x Show


and $y it »
* Multiplication $x * $y Product of $x and Show
$y it »

/ Division $x / $y Quotient of $x and Show


$y it »

% Modulus $x % $y Remainder of $x Show


divided by $y it »

** Exponentiation $x ** $y Result of raising


$x to the $y'th
power (Introduced
in PHP 5.6)

PHP Assignment Operators


The PHP assignment operators are used with numeric values to write a value to
a variable.

The basic assignment operator in PHP is "=". It means that the left operand
gets set to the value of the assignment expression on the right.

Assignment Same Description Show


as... it

x=y x=y The left operand gets set to Show it


the value of the expression »
on the right
x += y x=x Addition Show it
+y »

x -= y x = x - Subtraction Show it
y »

x *= y x = x * Multiplication Show it
y »

x /= y x = x / Division Show it
y »

x %= y x=x Modulus Show it


%y »

PHP Comparison Operators


The PHP comparison operators are used to compare two values (number or
string):

Operator Name Example Result Show


it

== Equal $x == $y Returns true if $x Show


is equal to $y it »

=== Identical $x === Returns true if $x Show


$y is equal to $y, and it »
they are of the
same type

!= Not equal $x != $y Returns true if $x Show


is not equal to $y it »

<> Not equal $x <> $y Returns true if $x Show


is not equal to $y it »

!== Not $x !== Returns true if $x Show


identical $y is not equal to $y, it »
or they are not of
the same type

> Greater $x > $y Returns true if $x Show


than is greater than $y it »

< Less than $x < $y Returns true if $x Show


is less than $y it »

>= Greater $x >= $y Returns true if $x Show


than or is greater than or it »
equal to equal to $y
<= Less than $x <= $y Returns true if $x Show
or equal to is less than or it »
equal to $y

PHP Increment / Decrement Operators


The PHP increment operators are used to increment a variable's value.

The PHP decrement operators are used to decrement a variable's value.

Operator Name Description Show it

++$x Pre- Increments $x by one, Show it


increment then returns $x »

$x++ Post- Returns $x, then Show it


increment increments $x by one »

--$x Pre- Decrements $x by one, Show it


decrement then returns $x »

$x-- Post- Returns $x, then Show it


decrement decrements $x by one »

PHP Logical Operators


The PHP logical operators are used to combine conditional statements.

Operator Name Example Result Show it

and And $x and $y True if both $x and Show it


$y are true »

or Or $x or $y True if either $x or Show it


$y is true »

xor Xor $x xor $y True if either $x or Show it


$y is true, but not »
both

&& And $x && $y True if both $x and Show it


$y are true »

|| Or $x || $y True if either $x or Show it


$y is true »

! Not !$x True if $x is not true Show it


»

PHP String Operators


PHP has two operators that are specially designed for strings.
Operator Name Example Result Show
it

. Concatenation $txt1 . Concatenation of Show


$txt2 $txt1 and $txt2 it »

.= Concatenation $txt1 .= Appends $txt2 to Show


assignment $txt2 $txt1 it »

PHP Array Operators


The PHP array operators are used to compare arrays.

Operator Name Example Result Show


it

+ Union $x + $y Union of $x and $y Show


it »

== Equality $x == $y Returns true if $x Show


and $y have the it »
same key/value
pairs

=== Identity $x === Returns true if $x Show


$y and $y have the it »
same key/value
pairs in the same
order and of the
same types

!= Inequality $x != $y Returns true if $x is Show


not equal to $y it »

<> Inequality $x <> $y Returns true if $x is Show


not equal to $y it »

!== Non- $x !== Returns true if $x is Show


identity $y not identical to $y it »

Test Yourself With Exercises


Exercise:
Multiply 10 with 5, and output the result.

echo 10 5;
PHP 5 if...else...elseif Statements
❮ PreviousNext ❯

Conditional statements are used to perform different actions based on


different conditions.

PHP Conditional Statements


Very often when you write code, you want to perform different actions for
different conditions. You can use conditional statements in your code to do this.

In PHP we have the following conditional statements:

 if statement - executes some code if one condition is true


 if...else statement - executes some code if a condition is true and
another code if that condition is false
 if...elseif....else statement - executes different codes for more than
two conditions
 switch statement - selects one of many blocks of code to be executed

PHP - The if Statement


The if statement executes some code if one condition is true.

Syntax
if (condition) {
code to be executed if condition is true;
}

The example below will output "Have a good day!" if the current time (HOUR) is
less than 20:

Example
<?php
$t = date("H");

if ($t < "20") {


echo "Have a good day!";
}
?>
Run example »

PHP - The if...else Statement


The if....else statement executes some code if a condition is true and
another code if that condition is false.

Syntax
if (condition) {
code to be executed if condition is true;
} else {
code to be executed if condition is false;
}

The example below will output "Have a good day!" if the current time is less
than 20, and "Have a good night!" otherwise:

Example
<?php
$t = date("H");

if ($t < "20") {


echo "Have a good day!";
} else {
echo "Have a good night!";
}
?>
Run example »
PHP - The if...elseif....else Statement
The if....elseif...else statement executes different codes for more than
two conditions.

Syntax
if (condition) {
code to be executed if this condition is true;
} elseif (condition) {
code to be executed if this condition is true;
} else {
code to be executed if all conditions are false;
}

The example below will output "Have a good morning!" if the current time is
less than 10, and "Have a good day!" if the current time is less than 20.
Otherwise it will output "Have a good night!":

Example
<?php
$t = date("H");

if ($t < "10") {


echo "Have a good morning!";
} elseif ($t < "20") {
echo "Have a good day!";
} else {
echo "Have a good night!";
}
?>
Run example »

PHP - The switch Statement


The switch statement will be explained in the next chapter.
Test Yourself With Exercises
Exercise:
Output "Hello World" if $a is greater than $b.

$a = 50;
$b = 10;
> {
echo "Hello World";
}
PHP 5 switch Statement
❮ PreviousNext ❯

The switch statement is used to perform different actions based on different


conditions.

The PHP switch Statement


Use the switch statement to select one of many blocks of code to be
executed.

Syntax
switch (n) {
case label1:
code to be executed if n=label1;
break;
case label2:
code to be executed if n=label2;
break;
case label3:
code to be executed if n=label3;
break;
...
default:
code to be executed if n is different from all labels;
}

This is how it works: First we have a single expression n (most often a


variable), that is evaluated once. The value of the expression is then compared
with the values for each case in the structure. If there is a match, the block of
code associated with that case is executed. Use break to prevent the code from
running into the next case automatically. The default statement is used if no
match is found.

Example
<?php
$favcolor = "red";

switch ($favcolor) {
case "red":
echo "Your favorite color is red!";
break;
case "blue":
echo "Your favorite color is blue!";
break;
case "green":
echo "Your favorite color is green!";
break;
default:
echo "Your favorite color is neither red, blue, nor green!";
}
?>
Run example »

Test Yourself With Exercises


Exercise:
Create a switch statement that will output "Hello" if $coloris "red", and "welcome"
if $color is "green".

($color) {
"red":
echo "Hello";
break;
"green":
echo "Welcome";
break;
}
PHP 5 while Loops
❮ PreviousNext ❯

PHP while loops execute a block of code while the specified condition is true.

PHP Loops
Often when you write code, you want the same block of code to run over and
over again in a row. Instead of adding several almost equal code-lines in a
script, we can use loops to perform a task like this.

In PHP, we have the following looping statements:

 while - loops through a block of code as long as the specified condition is


true
 do...while - loops through a block of code once, and then repeats the
loop as long as the specified condition is true
 for - loops through a block of code a specified number of times
 foreach - loops through a block of code for each element in an array

The PHP while Loop


The while loop executes a block of code as long as the specified condition is
true.

Syntax
while (condition is true) {
code to be executed;
}

The example below first sets a variable $x to 1 ($x = 1). Then, the while loop
will continue to run as long as $x is less than, or equal to 5 ($x <= 5). $x will
increase by 1 each time the loop runs ($x++):
Example
<?php
$x = 1;

while($x <= 5) {
echo "The number is: $x <br>";
$x++;
}
?>
Run example »

The PHP do...while Loop


The do...while loop will always execute the block of code once, it will then
check the condition, and repeat the loop while the specified condition is true.

Syntax
do {
code to be executed;
} while (condition is true);

The example below first sets a variable $x to 1 ($x = 1). Then, the do while
loop will write some output, and then increment the variable $x with 1. Then
the condition is checked (is $x less than, or equal to 5?), and the loop will
continue to run as long as $x is less than, or equal to 5:

Example
<?php
$x = 1;

do {
echo "The number is: $x <br>";
$x++;
} while ($x <= 5);
?>
Run example »
Notice that in a do while loop the condition is tested AFTER executing the
statements within the loop. This means that the do while loop would execute
its statements at least once, even if the condition is false the first time.

The example below sets the $x variable to 6, then it runs the loop, and then
the condition is checked:

Example
<?php
$x = 6;

do {
echo "The number is: $x <br>";
$x++;
} while ($x <= 5);
?>
Run example »

The for loop and the foreach loop will be explained in the next chapter.

Test Yourself With Exercises


Exercise:
Output $i as long as $i is less than 6.

$i = 1;

($i < 6)
echo $i;
$i++;
PHP 5 for Loops
❮ PreviousNext ❯

PHP for loops execute a block of code a specified number of times.

The PHP for Loop


The for loop is used when you know in advance how many times the script
should run.

Syntax
for (init counter; test counter; increment counter) {
code to be executed;
}

Parameters:

 init counter: Initialize the loop counter value


 test counter: Evaluated for each loop iteration. If it evaluates to TRUE,
the loop continues. If it evaluates to FALSE, the loop ends.
 increment counter: Increases the loop counter value

The example below displays the numbers from 0 to 10:

Example
<?php
for ($x = 0; $x <= 10; $x++) {
echo "The number is: $x <br>";
}
?>
Run example »
The PHP foreach Loop
The foreach loop works only on arrays, and is used to loop through each
key/value pair in an array.

Syntax
foreach ($array as $value) {
code to be executed;
}

For every loop iteration, the value of the current array element is assigned to
$value and the array pointer is moved by one, until it reaches the last array
element.

The following example demonstrates a loop that will output the values of the
given array ($colors):

Example
<?php
$colors = array("red", "green", "blue", "yellow");

foreach ($colors as $value) {


echo "$value <br>";
}
?>
Run example »

You will learn more about arrays in a later chapter.

Test Yourself With Exercises


Exercise:
Create a loop that runs from 0 to 9.

($i = 0; $i < 10; ) {


echo $i;
}
PHP 5 Functions
❮ PreviousNext ❯

The real power of PHP comes from its functions; it has more than 1000 built-
in functions.

PHP User Defined Functions


Besides the built-in PHP functions, we can create our own functions.

A function is a block of statements that can be used repeatedly in a program.

A function will not execute immediately when a page loads.

A function will be executed by a call to the function.

Create a User Defined Function in PHP


A user-defined function declaration starts with the word function:

Syntax
function functionName() {
code to be executed;
}

Note: A function name can start with a letter or underscore (not a number).

Tip: Give the function a name that reflects what the function does!

Function names are NOT case-sensitive.

In the example below, we create a function named "writeMsg()". The opening


curly brace ( { ) indicates the beginning of the function code and the closing
curly brace ( } ) indicates the end of the function. The function outputs "Hello
world!". To call the function, just write its name:

Example
<?php
function writeMsg() {
echo "Hello world!";
}

writeMsg(); // call the function


?>
Run example »

PHP Function Arguments


Information can be passed to functions through arguments. An argument is just
like a variable.

Arguments are specified after the function name, inside the parentheses. You
can add as many arguments as you want, just separate them with a comma.

The following example has a function with one argument ($fname). When the
familyName() function is called, we also pass along a name (e.g. Jani), and the
name is used inside the function, which outputs several different first names,
but an equal last name:

Example
<?php
function familyName($fname) {
echo "$fname Refsnes.<br>";
}

familyName("Jani");
familyName("Hege");
familyName("Stale");
familyName("Kai Jim");
familyName("Borge");
?>
Run example »

The following example has a function with two arguments ($fname and $year):

Example
<?php
function familyName($fname, $year) {
echo "$fname Refsnes. Born in $year <br>";
}

familyName("Hege", "1975");
familyName("Stale", "1978");
familyName("Kai Jim", "1983");
?>
Run example »

PHP Default Argument Value


The following example shows how to use a default parameter. If we call the
function setHeight() without arguments it takes the default value as argument:

Example
<?php
function setHeight($minheight = 50) {
echo "The height is : $minheight <br>";
}

setHeight(350);
setHeight(); // will use the default value of 50
setHeight(135);
setHeight(80);
?>
Run example »

PHP Functions - Returning values


To let a function return a value, use the return statement:
Example
<?php
function sum($x, $y) {
$z = $x + $y;
return $z;
}

echo "5 + 10 = " . sum(5, 10) . "<br>";


echo "7 + 13 = " . sum(7, 13) . "<br>";
echo "2 + 4 = " . sum(2, 4);
?>
Run example »

Test Yourself With Exercises


Exercise:
Create a function named myFunction.

{
echo "Hello World!";
}
PHP 5 Arrays
❮ PreviousNext ❯

An array stores multiple values in one single variable:

Example
<?php
$cars = array("Volvo", "BMW", "Toyota");
echo "I like " . $cars[0] . ", " . $cars[1] . " and ". $cars[2] . ".";
?>
Run example »

What is an Array?
An array is a special variable, which can hold more than one value at a time.

If you have a list of items (a list of car names, for example), storing the cars in
single variables could look like this:

$cars1 = "Volvo";
$cars2 = "BMW";
$cars3 = "Toyota";

However, what if you want to loop through the cars and find a specific one? And
what if you had not 3 cars, but 300?

The solution is to create an array!

An array can hold many values under a single name, and you can access the
values by referring to an index number.

Create an Array in PHP


In PHP, the array() function is used to create an array:
array();

In PHP, there are three types of arrays:

 Indexed arrays - Arrays with a numeric index


 Associative arrays - Arrays with named keys
 Multidimensional arrays - Arrays containing one or more arrays

PHP Indexed Arrays


There are two ways to create indexed arrays:

The index can be assigned automatically (index always starts at 0), like this:

$cars = array("Volvo", "BMW", "Toyota");

or the index can be assigned manually:

$cars[0] = "Volvo";
$cars[1] = "BMW";
$cars[2] = "Toyota";

The following example creates an indexed array named $cars, assigns three
elements to it, and then prints a text containing the array values:

Example
<?php
$cars = array("Volvo", "BMW", "Toyota");
echo "I like " . $cars[0] . ", " . $cars[1] . " and ". $cars[2] . ".";
?>
Run example »

Get The Length of an Array - The count()


Function
The count() function is used to return the length (the number of elements) of
an array:

Example
<?php
$cars = array("Volvo", "BMW", "Toyota");
echo count($cars);
?>
Run example »

Loop Through an Indexed Array


To loop through and print all the values of an indexed array, you could use
a for loop, like this:

Example
<?php
$cars = array("Volvo", "BMW", "Toyota");
$arrlength = count($cars);

for($x = 0; $x < $arrlength; $x++) {


echo $cars[$x];
echo "<br>";
}
?>
Run example »

PHP Associative Arrays


Associative arrays are arrays that use named keys that you assign to them.

There are two ways to create an associative array:

$age = array("Peter"=>"35", "Ben"=>"37", "Joe"=>"43");

or:
$age['Peter'] = "35";
$age['Ben'] = "37";
$age['Joe'] = "43";

The named keys can then be used in a script:

Example
<?php
$age = array("Peter"=>"35", "Ben"=>"37", "Joe"=>"43");
echo "Peter is " . $age['Peter'] . " years old.";
?>
Run example »

Loop Through an Associative Array


To loop through and print all the values of an associative array, you could use
a foreach loop, like this:

Example
<?php
$age = array("Peter"=>"35", "Ben"=>"37", "Joe"=>"43");

foreach($age as $x => $x_value) {


echo "Key=" . $x . ", Value=" . $x_value;
echo "<br>";
}
?>
Run example »

Multidimensional Arrays
Multidimensional arrays will be explained in the PHP advanced section.
Complete PHP Array Reference
For a complete reference of all array functions, go to our complete PHP Array
Reference.

The reference contains a brief description, and examples of use, for each
function!

Test Yourself With Exercises


Exercise:
Use the correct function to output the number of items in an array.

$fruits = array("Apple", "Banana" "Orange");


echo ;
PHP 5 Sorting Arrays
❮ PreviousNext ❯

The elements in an array can be sorted in alphabetical or numerical order,


descending or ascending.

PHP - Sort Functions For Arrays


In this chapter, we will go through the following PHP array sort functions:

 sort() - sort arrays in ascending order


 rsort() - sort arrays in descending order
 asort() - sort associative arrays in ascending order, according to the
value
 ksort() - sort associative arrays in ascending order, according to the key
 arsort() - sort associative arrays in descending order, according to the
value
 krsort() - sort associative arrays in descending order, according to the
key

Sort Array in Ascending Order - sort()


The following example sorts the elements of the $cars array in ascending
alphabetical order:

Example
<?php
$cars = array("Volvo", "BMW", "Toyota");
sort($cars);
?>
Run example »
The following example sorts the elements of the $numbers array in ascending
numerical order:

Example
<?php
$numbers = array(4, 6, 2, 22, 11);
sort($numbers);
?>
Run example »

Sort Array in Descending Order - rsort()


The following example sorts the elements of the $cars array in descending
alphabetical order:

Example
<?php
$cars = array("Volvo", "BMW", "Toyota");
rsort($cars);
?>
Run example »

The following example sorts the elements of the $numbers array in descending
numerical order:

Example
<?php
$numbers = array(4, 6, 2, 22, 11);
rsort($numbers);
?>
Run example »
Sort Array (Ascending Order), According to
Value - asort()
The following example sorts an associative array in ascending order, according
to the value:

Example
<?php
$age = array("Peter"=>"35", "Ben"=>"37", "Joe"=>"43");
asort($age);
?>
Run example »

Sort Array (Ascending Order), According to Key


- ksort()
The following example sorts an associative array in ascending order, according
to the key:

Example
<?php
$age = array("Peter"=>"35", "Ben"=>"37", "Joe"=>"43");
ksort($age);
?>
Run example »

Sort Array (Descending Order), According to


Value - arsort()
The following example sorts an associative array in descending order, according
to the value:
Example
<?php
$age = array("Peter"=>"35", "Ben"=>"37", "Joe"=>"43");
arsort($age);
?>
Run example »

Sort Array (Descending Order), According to


Key - krsort()
The following example sorts an associative array in descending order, according
to the key:

Example
<?php
$age = array("Peter"=>"35", "Ben"=>"37", "Joe"=>"43");
krsort($age);
?>
Run example »

Complete PHP Array Reference


For a complete reference of all array functions, go to our complete PHP Array
Reference.

The reference contains a brief description, and examples of use, for each
function!

Test Yourself With Exercises


Exercise:
Use the correct array method to sort the $colors array alphabetically.

$colors = array("red", "green", "blue", "yellow");


PHP 5 Global Variables - Superglobals
❮ PreviousNext ❯

Superglobals were introduced in PHP 4.1.0, and are built-in variables that
are always available in all scopes.

PHP Global Variables - Superglobals


Several predefined variables in PHP are "superglobals", which means that they
are always accessible, regardless of scope - and you can access them from any
function, class or file without having to do anything special.

The PHP superglobal variables are:

 $GLOBALS
 $_SERVER
 $_REQUEST
 $_POST
 $_GET
 $_FILES
 $_ENV
 $_COOKIE
 $_SESSION

This chapter will explain some of the superglobals, and the rest will be explained
in later chapters.

PHP $GLOBALS
$GLOBALS is a PHP super global variable which is used to access global
variables from anywhere in the PHP script (also from within functions or
methods).

PHP stores all global variables in an array called $GLOBALS[index].


The index holds the name of the variable.
The example below shows how to use the super global variable $GLOBALS:

Example
<?php
$x = 75;
$y = 25;

function addition() {
$GLOBALS['z'] = $GLOBALS['x'] + $GLOBALS['y'];
}

addition();
echo $z;
?>
Run example »

In the example above, since z is a variable present within the $GLOBALS array,
it is also accessible from outside the function!

PHP $_SERVER
$_SERVER is a PHP super global variable which holds information about
headers, paths, and script locations.

The example below shows how to use some of the elements in $_SERVER:

Example
<?php
echo $_SERVER['PHP_SELF'];
echo "<br>";
echo $_SERVER['SERVER_NAME'];
echo "<br>";
echo $_SERVER['HTTP_HOST'];
echo "<br>";
echo $_SERVER['HTTP_REFERER'];
echo "<br>";
echo $_SERVER['HTTP_USER_AGENT'];
echo "<br>";
echo $_SERVER['SCRIPT_NAME'];
?>
Run example »

The following table lists the most important elements that can go inside
$_SERVER:

Element/Code Description

$_SERVER['PHP_SELF'] Returns the filename of


the currently executing
script

$_SERVER['GATEWAY_INTERFACE'] Returns the version of the


Common Gateway
Interface (CGI) the server
is using

$_SERVER['SERVER_ADDR'] Returns the IP address of


the host server

$_SERVER['SERVER_NAME'] Returns the name of the


host server (such as
www.w3schools.com)

$_SERVER['SERVER_SOFTWARE'] Returns the server


identification string (such
as Apache/2.2.24)

$_SERVER['SERVER_PROTOCOL'] Returns the name and


revision of the information
protocol (such as
HTTP/1.1)

$_SERVER['REQUEST_METHOD'] Returns the request


method used to access the
page (such as POST)

$_SERVER['REQUEST_TIME'] Returns the timestamp of


the start of the request
(such as 1377687496)

$_SERVER['QUERY_STRING'] Returns the query string if


the page is accessed via a
query string

$_SERVER['HTTP_ACCEPT'] Returns the Accept header


from the current request

$_SERVER['HTTP_ACCEPT_CHARSET'] Returns the


Accept_Charset header
from the current request
(such as utf-8,ISO-8859-
1)

$_SERVER['HTTP_HOST'] Returns the Host header


from the current request

$_SERVER['HTTP_REFERER'] Returns the complete URL


of the page from which
the current page was
called
$_SERVER['HTTPS'] Is the script queried
through a secure HTTP
protocol

$_SERVER['REMOTE_ADDR'] Returns the IP address


from where the user is
viewing the current page

$_SERVER['REMOTE_HOST'] Returns the Host name


from where the user is
viewing the current page

$_SERVER['REMOTE_PORT'] Returns the port being


used on the user's
machine to communicate
with the web server

$_SERVER['SCRIPT_FILENAME'] Returns the absolute


pathname of the currently
executing script

$_SERVER['SERVER_ADMIN'] Returns the value given to


the SERVER_ADMIN
directive in the web server
configuration file (if your
script runs on a virtual
host, it will be the value
defined for that virtual
host) (such as
someone@w3schools.com)
$_SERVER['SERVER_PORT'] Returns the port on the
server machine being used
by the web server for
communication (such as
80)

$_SERVER['SERVER_SIGNATURE'] Returns the server version


and virtual host name
which are added to server-
generated pages

$_SERVER['PATH_TRANSLATED'] Returns the file system


based path to the current
script

$_SERVER['SCRIPT_NAME'] Returns the path of the


current script

$_SERVER['SCRIPT_URI'] Returns the URI of the


current page

PHP $_REQUEST
PHP $_REQUEST is used to collect data after submitting an HTML form.

The example below shows a form with an input field and a submit button. When
a user submits the data by clicking on "Submit", the form data is sent to the file
specified in the action attribute of the <form> tag. In this example, we point to
this file itself for processing form data. If you wish to use another PHP file to
process form data, replace that with the filename of your choice. Then, we can
use the super global variable $_REQUEST to collect the value of the input field:
Example
<html>
<body>

<form method="post" action="<?php echo$_SERVER['PHP_SELF'];?>">


Name: <input type="text" name="fname">
<input type="submit">
</form>

<?php
if ($_SERVER["REQUEST_METHOD"] == "POST") {
// collect value of input field
$name = $_REQUEST['fname'];
if (empty($name)) {
echo "Name is empty";
} else {
echo $name;
}
}
?>

</body>
</html>
Run example »

PHP $_POST
PHP $_POST is widely used to collect form data after submitting an HTML form
with method="post". $_POST is also widely used to pass variables.

The example below shows a form with an input field and a submit button. When
a user submits the data by clicking on "Submit", the form data is sent to the file
specified in the action attribute of the <form> tag. In this example, we point to
the file itself for processing form data. If you wish to use another PHP file to
process form data, replace that with the filename of your choice. Then, we can
use the super global variable $_POST to collect the value of the input field:

Example
<html>
<body>
<form method="post" action="<?php echo$_SERVER['PHP_SELF'];?>">
Name: <input type="text" name="fname">
<input type="submit">
</form>

<?php
if ($_SERVER["REQUEST_METHOD"] == "POST") {
// collect value of input field
$name = $_POST['fname'];
if (empty($name)) {
echo "Name is empty";
} else {
echo $name;
}
}
?>

</body>
</html>
Run example »

PHP $_GET
PHP $_GET can also be used to collect form data after submitting an HTML form
with method="get".

$_GET can also collect data sent in the URL.

Assume we have an HTML page that contains a hyperlink with parameters:

<html>
<body>

<a href="test_get.php?subject=PHP&web=W3schools.com">Test $GET</a>

</body>
</html>

When a user clicks on the link "Test $GET", the parameters "subject" and "web"
are sent to "test_get.php", and you can then access their values in
"test_get.php" with $_GET.
The example below shows the code in "test_get.php":

Example
<html>
<body>

<?php
echo "Study " . $_GET['subject'] . " at " . $_GET['web'];
?>

</body>
</html>
PHP 5 Form Handling
❮ PreviousNext ❯

The PHP superglobals $_GET and $_POST are used to collect form-data.

PHP - A Simple HTML Form


The example below displays a simple HTML form with two input fields and a
submit button:

Example
<html>
<body>

<form action="welcome.php" method="post">


Name: <input type="text" name="name"><br>
E-mail: <input type="text" name="email"><br>
<input type="submit">
</form>

</body>
</html>
Run example »

When the user fills out the form above and clicks the submit button, the form
data is sent for processing to a PHP file named "welcome.php". The form data is
sent with the HTTP POST method.

To display the submitted data you could simply echo all the variables. The
"welcome.php" looks like this:

<html>
<body>

Welcome <?php echo $_POST["name"]; ?><br>


Your email address is: <?php echo $_POST["email"]; ?>
</body>
</html>

The output could be something like this:

Welcome John
Your email address is john.doe@example.com

The same result could also be achieved using the HTTP GET method:

Example
<html>
<body>

<form action="welcome_get.php" method="get">


Name: <input type="text" name="name"><br>
E-mail: <input type="text" name="email"><br>
<input type="submit">
</form>

</body>
</html>
Run example »

and "welcome_get.php" looks like this:

<html>
<body>

Welcome <?php echo $_GET["name"]; ?><br>


Your email address is: <?php echo $_GET["email"]; ?>

</body>
</html>

The code above is quite simple. However, the most important thing is missing.
You need to validate form data to protect your script from malicious code.

Think SECURITY when processing PHP forms!

This page does not contain any form validation, it just shows how you can send
and retrieve form data.
However, the next pages will show how to process PHP forms with security in
mind! Proper validation of form data is important to protect your form from
hackers and spammers!

GET vs. POST


Both GET and POST create an array (e.g. array( key1 => value1, key2 =>
value2, key3 => value3, ...)). This array holds key/value pairs, where keys are
the names of the form controls and values are the input data from the user.

Both GET and POST are treated as $_GET and $_POST. These are superglobals,
which means that they are always accessible, regardless of scope - and you can
access them from any function, class or file without having to do anything
special.

$_GET is an array of variables passed to the current script via the URL
parameters.

$_POST is an array of variables passed to the current script via the HTTP POST
method.

When to use GET?


Information sent from a form with the GET method is visible to everyone (all
variable names and values are displayed in the URL). GET also has limits on the
amount of information to send. The limitation is about 2000 characters.
However, because the variables are displayed in the URL, it is possible to
bookmark the page. This can be useful in some cases.

GET may be used for sending non-sensitive data.

Note: GET should NEVER be used for sending passwords or other sensitive
information!
When to use POST?
Information sent from a form with the POST method is invisible to others (all
names/values are embedded within the body of the HTTP request) and has no
limits on the amount of information to send.

Moreover POST supports advanced functionality such as support for multi-part


binary input while uploading files to server.

However, because the variables are not displayed in the URL, it is not possible
to bookmark the page.

Developers prefer POST for sending form data.

Next, lets see how we can process PHP forms the secure way!

Test Yourself With Exercises


Exercise:
If the form in the white section below gets submitted, how can you, in
welcome.php, output the value from the "first name" field?

<form action="welcome.php" method="get">


First name: <input type="text" name="fname">
</form>

<html>
<body>

Welcome <?php echo ; ?>

</body>
</html>
PHP 5 Form Validation
❮ PreviousNext ❯

This and the next chapters show how to use PHP to validate form data.

PHP Form Validation


Think SECURITY when processing PHP forms!

These pages will show how to process PHP forms with security in mind. Proper
validation of form data is important to protect your form from hackers and
spammers!

The HTML form we will be working at in these chapters, contains various input
fields: required and optional text fields, radio buttons, and a submit button:

The validation rules for the form above are as follows:

Field Validation Rules

Name Required. + Must only contain letters and


whitespace

E-mail Required. + Must contain a valid email address


(with @ and .)

Website Optional. If present, it must contain a valid URL


Comment Optional. Multi-line input field (textarea)

Gender Required. Must select one

First we will look at the plain HTML code for the form:

Text Fields
The name, email, and website fields are text input elements, and the comment
field is a textarea. The HTML code looks like this:

Name: <input type="text" name="name">


E-mail: <input type="text" name="email">
Website: <input type="text" name="website">
Comment: <textarea name="comment" rows="5" cols="40"></textarea>

Radio Buttons
The gender fields are radio buttons and the HTML code looks like this:

Gender:
<input type="radio" name="gender" value="female">Female
<input type="radio" name="gender" value="male">Male
<input type="radio" name="gender" value="other">Other

The Form Element


The HTML code of the form looks like this:
<form method="post" action="<?php echohtmlspecialchars($_SERVER["PHP_S
ELF"]);?>">

When the form is submitted, the form data is sent with method="post".

What is the $_SERVER["PHP_SELF"] variable?

The $_SERVER["PHP_SELF"] is a super global variable that returns the filename


of the currently executing script.

So, the $_SERVER["PHP_SELF"] sends the submitted form data to the page
itself, instead of jumping to a different page. This way, the user will get error
messages on the same page as the form.

What is the htmlspecialchars() function?

The htmlspecialchars() function converts special characters to HTML entities.


This means that it will replace HTML characters like < and > with &lt; and &gt;.
This prevents attackers from exploiting the code by injecting HTML or Javascript
code (Cross-site Scripting attacks) in forms.

Big Note on PHP Form Security


The $_SERVER["PHP_SELF"] variable can be used by hackers!

If PHP_SELF is used in your page then a user can enter a slash (/) and then
some Cross Site Scripting (XSS) commands to execute.

Cross-site scripting (XSS) is a type of computer security vulnerability


typically found in Web applications. XSS enables attackers to inject
client-side script into Web pages viewed by other users.

Assume we have the following form in a page named "test_form.php":

<form method="post" action="<?php echo$_SERVER["PHP_SELF"];?>">

Now, if a user enters the normal URL in the address bar like
"http://www.example.com/test_form.php", the above code will be translated to:

<form method="post" action="test_form.php">

So far, so good.
However, consider that a user enters the following URL in the address bar:

http://www.example.com/test_form.php/%22%3E%3Cscript%3Ealert('hacked')
%3C/script%3E

In this case, the above code will be translated to:

<form method="post" action="test_form.php/"><script>alert('hacked')</s


cript>

This code adds a script tag and an alert command. And when the page loads,
the JavaScript code will be executed (the user will see an alert box). This is just
a simple and harmless example how the PHP_SELF variable can be exploited.

Be aware of that any JavaScript code can be added inside the <script>
tag! A hacker can redirect the user to a file on another server, and that file can
hold malicious code that can alter the global variables or submit the form to
another address to save the user data, for example.

How To Avoid $_SERVER["PHP_SELF"] Exploits?


$_SERVER["PHP_SELF"] exploits can be avoided by using the htmlspecialchars()
function.

The form code should look like this:

<form method="post" action="<?php echohtmlspecialchars($_SERVER["PHP_S


ELF"]);?>">

The htmlspecialchars() function converts special characters to HTML entities.


Now if the user tries to exploit the PHP_SELF variable, it will result in the
following output:

<form method="post"action="test_form.php/&quot;&gt;&lt;script&gt;alert
('hacked')&lt;/script&gt;">

The exploit attempt fails, and no harm is done!

Validate Form Data With PHP


The first thing we will do is to pass all variables through PHP's
htmlspecialchars() function.

When we use the htmlspecialchars() function; then if a user tries to submit the
following in a text field:

<script>location.href('http://www.hacked.com')</script>

- this would not be executed, because it would be saved as HTML escaped code,
like this:

&lt;script&gt;location.href('http://www.hacked.com')&lt;/script&gt;

The code is now safe to be displayed on a page or inside an e-mail.

We will also do two more things when the user submits the form:

1. Strip unnecessary characters (extra space, tab, newline) from the user
input data (with the PHP trim() function)
2. Remove backslashes (\) from the user input data (with the PHP
stripslashes() function)

The next step is to create a function that will do all the checking for us (which is
much more convenient than writing the same code over and over again).

We will name the function test_input().

Now, we can check each $_POST variable with the test_input() function, and
the script looks like this:

Example
<?php
// define variables and set to empty values
$name = $email = $gender = $comment = $website = "";

if ($_SERVER["REQUEST_METHOD"] == "POST") {
$name = test_input($_POST["name"]);
$email = test_input($_POST["email"]);
$website = test_input($_POST["website"]);
$comment = test_input($_POST["comment"]);
$gender = test_input($_POST["gender"]);
}

function test_input($data) {
$data = trim($data);
$data = stripslashes($data);
$data = htmlspecialchars($data);
return $data;
}
?>
PHP 5 Forms - Required Fields
❮ PreviousNext ❯

This chapter shows how to make input fields required and create error
messages if needed.

PHP - Required Fields


From the validation rules table on the previous page, we see that the "Name",
"E-mail", and "Gender" fields are required. These fields cannot be empty and
must be filled out in the HTML form.

Field Validation Rules

Name Required. + Must only contain letters and


whitespace

E-mail Required. + Must contain a valid email address


(with @ and .)

Website Optional. If present, it must contain a valid URL

Comment Optional. Multi-line input field (textarea)

Gender Required. Must select one


In the previous chapter, all input fields were optional.

In the following code we have added some new variables: $nameErr, $emailErr,
$genderErr, and $websiteErr. These error variables will hold error messages for
the required fields. We have also added an if else statement for each $_POST
variable. This checks if the $_POST variable is empty (with the
PHP empty()function). If it is empty, an error message is stored in the different
error variables, and if it is not empty, it sends the user input data through
the test_input() function:

<?php
// define variables and set to empty values
$nameErr = $emailErr = $genderErr = $websiteErr = "";
$name = $email = $gender = $comment = $website = "";

if ($_SERVER["REQUEST_METHOD"] == "POST") {
if (empty($_POST["name"])) {
$nameErr = "Name is required";
} else {
$name = test_input($_POST["name"]);
}

if (empty($_POST["email"])) {
$emailErr = "Email is required";
} else {
$email = test_input($_POST["email"]);
}

if (empty($_POST["website"])) {
$website = "";
} else {
$website = test_input($_POST["website"]);
}

if (empty($_POST["comment"])) {
$comment = "";
} else {
$comment = test_input($_POST["comment"]);
}

if (empty($_POST["gender"])) {
$genderErr = "Gender is required";
} else {
$gender = test_input($_POST["gender"]);
}
}
?>

PHP - Display The Error Messages


Then in the HTML form, we add a little script after each required field, which
generates the correct error message if needed (that is if the user tries to submit
the form without filling out the required fields):

Example
<form method="post" action="<?php echohtmlspecialchars($_SERVER["PHP_S
ELF"]);?>">

Name: <input type="text" name="name">


<span class="error">* <?php echo $nameErr;?></span>
<br><br>
E-mail:
<input type="text" name="email">
<span class="error">* <?php echo $emailErr;?></span>
<br><br>
Website:
<input type="text" name="website">
<span class="error"><?php echo $websiteErr;?></span>
<br><br>
Comment: <textarea name="comment" rows="5" cols="40"></textarea>
<br><br>
Gender:
<input type="radio" name="gender"value="female">Female
<input type="radio" name="gender" value="male">Male
<input type="radio" name="gender" value="other">Other
<span class="error">* <?php echo $genderErr;?></span>
<br><br>
<input type="submit" name="submit" value="Submit">

</form>
PHP 5 Forms - Validate E-mail and URL
❮ PreviousNext ❯

This chapter shows how to validate names, e-mails, and URLs.

PHP - Validate Name


The code below shows a simple way to check if the name field only contains
letters and whitespace. If the value of the name field is not valid, then store an
error message:

$name = test_input($_POST["name"]);
if (!preg_match("/^[a-zA-Z ]*$/",$name)) {
$nameErr = "Only letters and white space allowed";
}

The preg_match() function searches a string for pattern, returning true if the
pattern exists, and false otherwise.

PHP - Validate E-mail


The easiest and safest way to check whether an email address is well-formed is
to use PHP's filter_var() function.

In the code below, if the e-mail address is not well-formed, then store an error
message:

$email = test_input($_POST["email"]);
if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
$emailErr = "Invalid email format";
}
PHP - Validate URL
The code below shows a way to check if a URL address syntax is valid (this
regular expression also allows dashes in the URL). If the URL address syntax is
not valid, then store an error message:

$website = test_input($_POST["website"]);
if (!preg_match("/\b(?:(?:https?|ftp):\/\/|www\.)[-a-z0-
9+&@#\/%?=~_|!:,.;]*[-a-z0-9+&@#\/%=~_|]/i",$website)) {
$websiteErr = "Invalid URL";
}

PHP - Validate Name, E-mail, and URL


Now, the script looks like this:

Example
<?php
// define variables and set to empty values
$nameErr = $emailErr = $genderErr = $websiteErr = "";
$name = $email = $gender = $comment = $website = "";

if ($_SERVER["REQUEST_METHOD"] == "POST") {
if (empty($_POST["name"])) {
$nameErr = "Name is required";
} else {
$name = test_input($_POST["name"]);
// check if name only contains letters and whitespace
if (!preg_match("/^[a-zA-Z ]*$/",$name)) {
$nameErr = "Only letters and white space allowed";
}
}

if (empty($_POST["email"])) {
$emailErr = "Email is required";
} else {
$email = test_input($_POST["email"]);
// check if e-mail address is well-formed
if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
$emailErr = "Invalid email format";
}
}

if (empty($_POST["website"])) {
$website = "";
} else {
$website = test_input($_POST["website"]);
// check if URL address syntax is valid (this regular expression
also allows dashes in the URL)
if (!preg_match("/\b(?:(?:https?|ftp):\/\/|www\.)[-a-z0-
9+&@#\/%?=~_|!:,.;]*[-a-z0-9+&@#\/%=~_|]/i",$website)) {
$websiteErr = "Invalid URL";
}
}

if (empty($_POST["comment"])) {
$comment = "";
} else {
$comment = test_input($_POST["comment"]);
}

if (empty($_POST["gender"])) {
$genderErr = "Gender is required";
} else {
$gender = test_input($_POST["gender"]);
}
}
?>
PHP 5 Complete Form Example
❮ PreviousNext ❯

This chapter shows how to keep the values in the input fields when the user
hits the submit button.

PHP - Keep The Values in The Form


To show the values in the input fields after the user hits the submit button, we
add a little PHP script inside the value attribute of the following input fields:
name, email, and website. In the comment textarea field, we put the script
between the <textarea> and </textarea> tags. The little script outputs the
value of the $name, $email, $website, and $comment variables.

Then, we also need to show which radio button that was checked. For this, we
must manipulate the checked attribute (not the value attribute for radio
buttons):

Name: <input type="text" name="name" value="<?php echo$name;?>">

E-mail: <input type="text" name="email" value="<?phpecho $email;?>">

Website: <input type="text" name="website" value="<?phpecho $website;?


>">

Comment: <textarea name="comment" rows="5" cols="40"><?php echo $comme


nt;?></textarea>

Gender:
<input type="radio" name="gender"
<?php if (isset($gender) && $gender=="female") echo"checked";?>
value="female">Female
<input type="radio" name="gender"
<?php if (isset($gender) && $gender=="male") echo"checked";?>
value="male">Male
<input type="radio" name="gender"
<?php if (isset($gender) && $gender=="other") echo"checked";?>
value="other">Other
PHP - Complete Form Example
Here is the complete code for the PHP Form Validation Example:

Example
Run example »
PHP 5 Multidimensional Arrays
❮ PreviousNext ❯

Earlier in this tutorial, we have described arrays that are a single list of
key/value pairs.

However, sometimes you want to store values with more than one key.

This can be stored in multidimensional arrays.

PHP - Multidimensional Arrays


A multidimensional array is an array containing one or more arrays.

PHP understands multidimensional arrays that are two, three, four, five, or
more levels deep. However, arrays more than three levels deep are hard to
manage for most people.

The dimension of an array indicates the number of indices you need to


select an element.

 For a two-dimensional array you need two indices to select an element


 For a three-dimensional array you need three indices to select an element

PHP - Two-dimensional Arrays


A two-dimensional array is an array of arrays (a three-dimensional array is an
array of arrays of arrays).

First, take a look at the following table:

Name Stock Sold


Volvo 22 18

BMW 15 13

Saab 5 2

Land Rover 17 15

We can store the data from the table above in a two-dimensional array, like
this:

$cars = array
(
array("Volvo",22,18),
array("BMW",15,13),
array("Saab",5,2),
array("Land Rover",17,15)
);

Now the two-dimensional $cars array contains four arrays, and it has two
indices: row and column.

To get access to the elements of the $cars array we must point to the two
indices (row and column):

Example
<?php
echo $cars[0][0].": In stock: ".$cars[0][1].", sold:
".$cars[0][2].".<br>";
echo $cars[1][0].": In stock: ".$cars[1][1].", sold:
".$cars[1][2].".<br>";
echo $cars[2][0].": In stock: ".$cars[2][1].", sold:
".$cars[2][2].".<br>";
echo $cars[3][0].": In stock: ".$cars[3][1].", sold:
".$cars[3][2].".<br>";
?>
Run example »

We can also put a for loop inside another for loop to get the elements of the
$cars array (we still have to point to the two indices):

Example
<?php
for ($row = 0; $row < 4; $row++) {
echo "<p><b>Row number $row</b></p>";
echo "<ul>";
for ($col = 0; $col < 3; $col++) {
echo "<li>".$cars[$row][$col]."</li>";
}
echo "</ul>";
}
?>
PHP 5 Date and Time
❮ PreviousNext ❯

The PHP date() function is used to format a date and/or a time.

The PHP Date() Function


The PHP date() function formats a timestamp to a more readable date and
time.

Syntax
date(format,timestamp)

Parameter Description

format Required. Specifies the format of the timestamp

timestamp Optional. Specifies a timestamp. Default is the


current date and time

A timestamp is a sequence of characters, denoting the date and/or time at


which a certain event occurred.

Get a Simple Date


The required format parameter of the date() function specifies how to format
the date (or time).
Here are some characters that are commonly used for dates:

 d - Represents the day of the month (01 to 31)


 m - Represents a month (01 to 12)
 Y - Represents a year (in four digits)
 l (lowercase 'L') - Represents the day of the week

Other characters, like"/", ".", or "-" can also be inserted between the characters
to add additional formatting.

The example below formats today's date in three different ways:

Example
<?php
echo "Today is " . date("Y/m/d") . "<br>";
echo "Today is " . date("Y.m.d") . "<br>";
echo "Today is " . date("Y-m-d") . "<br>";
echo "Today is " . date("l");
?>
Run example »

PHP Tip - Automatic Copyright Year


Use the date() function to automatically update the copyright year on your
website:

Example
&copy; 2010-<?php echo date("Y");?>
Run example »

Get a Simple Time


Here are some characters that are commonly used for times:

 H - 24-hour format of an hour (00 to 23)


 h - 12-hour format of an hour with leading zeros (01 to 12)
 i - Minutes with leading zeros (00 to 59)
 s - Seconds with leading zeros (00 to 59)
 a - Lowercase Ante meridiem and Post meridiem (am or pm)

The example below outputs the current time in the specified format:

Example
<?php
echo "The time is " . date("h:i:sa");
?>
Run example »

Note that the PHP date() function will return the current date/time of the
server!

Get Your Time Zone


If the time you got back from the code is not the right time, it's probably
because your server is in another country or set up for a different timezone.

So, if you need the time to be correct according to a specific location, you can
set a timezone to use.

The example below sets the timezone to "America/New_York", then outputs the
current time in the specified format:

Example
<?php
date_default_timezone_set("America/New_York");
echo "The time is " . date("h:i:sa");
?>
Run example »

Create a Date With PHP mktime()


The optional timestamp parameter in the date() function specifies a timestamp.
If you do not specify a timestamp, the current date and time will be used (as
shown in the examples above).

The mktime() function returns the Unix timestamp for a date. The Unix
timestamp contains the number of seconds between the Unix Epoch (January 1
1970 00:00:00 GMT) and the time specified.

Syntax
mktime(hour,minute,second,month,day,year)

The example below creates a date and time from a number of parameters in
the mktime() function:

Example
<?php
$d=mktime(11, 14, 54, 8, 12, 2014);
echo "Created date is " . date("Y-m-d h:i:sa", $d);
?>
Run example »

Create a Date From a String With PHP


strtotime()
The PHP strtotime() function is used to convert a human readable string to a
Unix time.

Syntax
strtotime(time,now)

The example below creates a date and time from the strtotime() function:

Example
<?php
$d=strtotime("10:30pm April 15 2014");
echo "Created date is " . date("Y-m-d h:i:sa", $d);
?>
Run example »

PHP is quite clever about converting a string to a date, so you can put in various
values:

Example
<?php
$d=strtotime("tomorrow");
echo date("Y-m-d h:i:sa", $d) . "<br>";

$d=strtotime("next Saturday");
echo date("Y-m-d h:i:sa", $d) . "<br>";

$d=strtotime("+3 Months");
echo date("Y-m-d h:i:sa", $d) . "<br>";
?>
Run example »

However, strtotime() is not perfect, so remember to check the strings you put
in there.

More Date Examples


The example below outputs the dates for the next six Saturdays:

Example
<?php
$startdate = strtotime("Saturday");
$enddate = strtotime("+6 weeks", $startdate);

while ($startdate < $enddate) {


echo date("M d", $startdate) . "<br>";
$startdate = strtotime("+1 week", $startdate);
}
?>
Run example »

The example below outputs the number of days until 4th of July:
Example
<?php
$d1=strtotime("July 04");
$d2=ceil(($d1-time())/60/60/24);
echo "There are " . $d2 ." days until 4th of July.";
?>
Run example »

Complete PHP Date Reference


For a complete reference of all date functions, go to our completePHP Date
Reference.

The reference contains a brief description, and examples of use, for each
function!

Test Yourself With Exercises


Exercise:
Use the correct date function to output todays day of the week (monday, tuesday
etc.).

echo ;
PHP 5 Include Files
❮ PreviousNext ❯

The include (or require) statement takes all the text/code/markup that
exists in the specified file and copies it into the file that uses the include
statement.

Including files is very useful when you want to include the same PHP, HTML,
or text on multiple pages of a website.

PHP include and require Statements


It is possible to insert the content of one PHP file into another PHP file (before
the server executes it), with the include or require statement.

The include and require statements are identical, except upon failure:

 require will produce a fatal error (E_COMPILE_ERROR) and stop the


script
 include will only produce a warning (E_WARNING) and the script will
continue

So, if you want the execution to go on and show users the output, even if the
include file is missing, use the include statement. Otherwise, in case of
FrameWork, CMS, or a complex PHP application coding, always use the require
statement to include a key file to the flow of execution. This will help avoid
compromising your application's security and integrity, just in-case one key file
is accidentally missing.

Including files saves a lot of work. This means that you can create a standard
header, footer, or menu file for all your web pages. Then, when the header
needs to be updated, you can only update the header include file.

Syntax
include 'filename';

or
require 'filename';

PHP include Examples


Example 1
Assume we have a standard footer file called "footer.php", that looks like this:

<?php
echo "<p>Copyright &copy; 1999-" . date("Y") . " W3Schools.com</p>";
?>

To include the footer file in a page, use the include statement:

Example
<html>
<body>

<h1>Welcome to my home page!</h1>


<p>Some text.</p>
<p>Some more text.</p>
<?php include 'footer.php';?>

</body>
</html>
Run example »

Example 2
Assume we have a standard menu file called "menu.php":

<?php
echo '<a href="/default.asp">Home</a> -
<a href="/html/default.asp">HTML Tutorial</a> -
<a href="/css/default.asp">CSS Tutorial</a> -
<a href="/js/default.asp">JavaScript Tutorial</a> -
<a href="default.asp">PHP Tutorial</a>';
?>

All pages in the Web site should use this menu file. Here is how it can be done
(we are using a <div> element so that the menu easily can be styled with CSS
later):

Example
<html>
<body>

<div class="menu">
<?php include 'menu.php';?>
</div>

<h1>Welcome to my home page!</h1>


<p>Some text.</p>
<p>Some more text.</p>

</body>
</html>
Run example »

Example 3
Assume we have a file called "vars.php", with some variables defined:

<?php
$color='red';
$car='BMW';
?>

Then, if we include the "vars.php" file, the variables can be used in the calling
file:

Example
<html>
<body>
<h1>Welcome to my home page!</h1>
<?php include 'vars.php';
echo "I have a $color $car.";
?>

</body>
</html>
Run example »

PHP include vs. require


The require statement is also used to include a file into the PHP code.

However, there is one big difference between include and require; when a file is
included with the include statement and PHP cannot find it, the script will
continue to execute:

Example
<html>
<body>

<h1>Welcome to my home page!</h1>


<?php include 'noFileExists.php';
echo "I have a $color $car.";
?>

</body>
</html>
Run example »

If we do the same example using the require statement, the echo statement
will not be executed because the script execution dies after
the require statement returned a fatal error:

Example
<html>
<body>

<h1>Welcome to my home page!</h1>


<?php require 'noFileExists.php';
echo "I have a $color $car.";
?>

</body>
</html>
Run example »

Use require when the file is required by the application.

Use include when the file is not required and application should continue when
file is not found.

Test Yourself With Exercises


Exercise:
Write a correct syntax to include a file named "footer.php".

<?php ;?>
PHP 5 File Handling
❮ PreviousNext ❯

File handling is an important part of any web application. You often need to
open and process a file for different tasks.

PHP Manipulating Files


PHP has several functions for creating, reading, uploading, and editing files.

Be careful when manipulating files!

When you are manipulating files you must be very careful.

You can do a lot of damage if you do something wrong. Common errors are:
editing the wrong file, filling a hard-drive with garbage data, and deleting the
content of a file by accident.

PHP readfile() Function


The readfile() function reads a file and writes it to the output buffer.

Assume we have a text file called "webdictionary.txt", stored on the server, that
looks like this:

AJAX = Asynchronous JavaScript and XML


CSS = Cascading Style Sheets
HTML = Hyper Text Markup Language
PHP = PHP Hypertext Preprocessor
SQL = Structured Query Language
SVG = Scalable Vector Graphics
XML = EXtensible Markup Language

The PHP code to read the file and write it to the output buffer is as follows
(the readfile() function returns the number of bytes read on success):
Example
<?php
echo readfile("webdictionary.txt");
?>
Run example »

The readfile() function is useful if all you want to do is open up a file and read
its contents.

The next chapters will teach you more about file handling.

Test Yourself With Exercises


Exercise:
Assume we have a file named "webdict.txt", write the correct syntax to open and
read the file content.

echo ;
PHP 5 File Open/Read/Close
❮ PreviousNext ❯

In this chapter we will teach you how to open, read, and close a file on the
server.

PHP Open File - fopen()


A better method to open files is with the fopen() function. This function gives
you more options than the readfile() function.

We will use the text file, "webdictionary.txt", during the lessons:

AJAX = Asynchronous JavaScript and XML


CSS = Cascading Style Sheets
HTML = Hyper Text Markup Language
PHP = PHP Hypertext Preprocessor
SQL = Structured Query Language
SVG = Scalable Vector Graphics
XML = EXtensible Markup Language

The first parameter of fopen() contains the name of the file to be opened and
the second parameter specifies in which mode the file should be opened. The
following example also generates a message if the fopen() function is unable to
open the specified file:

Example
<?php
$myfile = fopen("webdictionary.txt", "r") ordie("Unable to open
file!");
echo fread($myfile,filesize("webdictionary.txt"));
fclose($myfile);
?>
Run example »

Tip: The fread() and the fclose() functions will be explained below.
The file may be opened in one of the following modes:

Modes Description

r Open a file for read only. File pointer starts at the


beginning of the file

w Open a file for write only. Erases the contents of


the file or creates a new file if it doesn't exist. File
pointer starts at the beginning of the file

a Open a file for write only. The existing data in file


is preserved. File pointer starts at the end of the file.
Creates a new file if the file doesn't exist

x Creates a new file for write only. Returns FALSE


and an error if file already exists

r+ Open a file for read/write. File pointer starts at


the beginning of the file

w+ Open a file for read/write. Erases the contents of


the file or creates a new file if it doesn't exist. File
pointer starts at the beginning of the file

a+ Open a file for read/write. The existing data in file


is preserved. File pointer starts at the end of the file.
Creates a new file if the file doesn't exist
x+ Creates a new file for read/write. Returns FALSE
and an error if file already exists

PHP Read File - fread()


The fread() function reads from an open file.

The first parameter of fread() contains the name of the file to read from and
the second parameter specifies the maximum number of bytes to read.

The following PHP code reads the "webdictionary.txt" file to the end:

fread($myfile,filesize("webdictionary.txt"));

PHP Close File - fclose()


The fclose() function is used to close an open file.

It's a good programming practice to close all files after you have finished with
them. You don't want an open file running around on your server taking up
resources!

The fclose() requires the name of the file (or a variable that holds the
filename) we want to close:

<?php
$myfile = fopen("webdictionary.txt", "r");
// some code to be executed....
fclose($myfile);
?>
PHP Read Single Line - fgets()
The fgets() function is used to read a single line from a file.

The example below outputs the first line of the "webdictionary.txt" file:

Example
<?php
$myfile = fopen("webdictionary.txt", "r") ordie("Unable to open
file!");
echo fgets($myfile);
fclose($myfile);
?>
Run example »

Note: After a call to the fgets() function, the file pointer has moved to the
next line.

PHP Check End-Of-File - feof()


The feof() function checks if the "end-of-file" (EOF) has been reached.

The feof() function is useful for looping through data of unknown length.

The example below reads the "webdictionary.txt" file line by line, until end-of-
file is reached:

Example
<?php
$myfile = fopen("webdictionary.txt", "r") ordie("Unable to open
file!");
// Output one line until end-of-file
while(!feof($myfile)) {
echo fgets($myfile) . "<br>";
}
fclose($myfile);
?>
Run example »
PHP Read Single Character - fgetc()
The fgetc() function is used to read a single character from a file.

The example below reads the "webdictionary.txt" file character by character,


until end-of-file is reached:

Example
<?php
$myfile = fopen("webdictionary.txt", "r") ordie("Unable to open
file!");
// Output one character until end-of-file
while(!feof($myfile)) {
echo fgetc($myfile);
}
fclose($myfile);
?>
Run example »

Note: After a call to the fgetc() function, the file pointer moves to the next
character.

Complete PHP Filesystem Reference


For a complete reference of filesystem functions, go to our complete PHP
Filesystem Reference.

Test Yourself With Exercises


Exercise:
Open a file, and write the correct syntax to output one character at the time, until
end-of-file.
$myfile = fopen("webdict.txt", "r");

while(! ($myfile)) {
echo ($myfile);
}
PHP 5 File Create/Write
❮ PreviousNext ❯

In this chapter we will teach you how to create and write to a file on the
server.

PHP Create File - fopen()


The fopen() function is also used to create a file. Maybe a little confusing, but
in PHP, a file is created using the same function used to open files.

If you use fopen() on a file that does not exist, it will create it, given that the
file is opened for writing (w) or appending (a).

The example below creates a new file called "testfile.txt". The file will be created
in the same directory where the PHP code resides:

Example
$myfile = fopen("testfile.txt", "w")

PHP File Permissions


If you are having errors when trying to get this code to run, check that you
have granted your PHP file access to write information to the hard drive.

PHP Write to File - fwrite()


The fwrite() function is used to write to a file.
The first parameter of fwrite() contains the name of the file to write to and
the second parameter is the string to be written.

The example below writes a couple of names into a new file called "newfile.txt":

Example
<?php
$myfile = fopen("newfile.txt", "w") or die("Unable to open file!");
$txt = "John Doe\n";
fwrite($myfile, $txt);
$txt = "Jane Doe\n";
fwrite($myfile, $txt);
fclose($myfile);
?>

Notice that we wrote to the file "newfile.txt" twice. Each time we wrote to the
file we sent the string $txt that first contained "John Doe" and second contained
"Jane Doe". After we finished writing, we closed the file using
the fclose() function.

If we open the "newfile.txt" file it would look like this:

John Doe
Jane Doe

PHP Overwriting
Now that "newfile.txt" contains some data we can show what happens when we
open an existing file for writing. All the existing data will be ERASED and we
start with an empty file.

In the example below we open our existing file "newfile.txt", and write some
new data into it:

Example
<?php
$myfile = fopen("newfile.txt", "w") or die("Unable to open file!");
$txt = "Mickey Mouse\n";
fwrite($myfile, $txt);
$txt = "Minnie Mouse\n";
fwrite($myfile, $txt);
fclose($myfile);
?>

If we now open the "newfile.txt" file, both John and Jane have vanished, and
only the data we just wrote is present:

Mickey Mouse
Minnie Mouse
PHP 5 File Upload
❮ PreviousNext ❯

With PHP, it is easy to upload files to the server.

However, with ease comes danger, so always be careful when allowing file
uploads!

Configure The "php.ini" File


First, ensure that PHP is configured to allow file uploads.

In your "php.ini" file, search for the file_uploads directive, and set it to On:

file_uploads = On

Create The HTML Form


Next, create an HTML form that allow users to choose the image file they want
to upload:

<!DOCTYPE html>
<html>
<body>

<form action="upload.php" method="post"enctype="multipart/form-data">


Select image to upload:
<input type="file" name="fileToUpload"id="fileToUpload">
<input type="submit" value="Upload Image"name="submit">
</form>

</body>
</html>

Some rules to follow for the HTML form above:


 Make sure that the form uses method="post"
 The form also needs the following attribute: enctype="multipart/form-
data". It specifies which content-type to use when submitting the form

Without the requirements above, the file upload will not work.

Other things to notice:

 The type="file" attribute of the <input> tag shows the input field as a
file-select control, with a "Browse" button next to the input control

The form above sends data to a file called "upload.php", which we will create
next.

Create The Upload File PHP Script


The "upload.php" file contains the code for uploading a file:

<?php
$target_dir = "uploads/";
$target_file = $target_dir .
basename($_FILES["fileToUpload"]["name"]);
$uploadOk = 1;
$imageFileType =strtolower(pathinfo($target_file,PATHINFO_EXTENSION));
// Check if image file is a actual image or fake image
if(isset($_POST["submit"])) {
$check = getimagesize($_FILES["fileToUpload"]["tmp_name"]);
if($check !== false) {
echo "File is an image - " . $check["mime"] . ".";
$uploadOk = 1;
} else {
echo "File is not an image.";
$uploadOk = 0;
}
}
?>

PHP script explained:


 $target_dir = "uploads/" - specifies the directory where the file is going to
be placed
 $target_file specifies the path of the file to be uploaded
 $uploadOk=1 is not used yet (will be used later)
 $imageFileType holds the file extension of the file (in lower case)
 Next, check if the image file is an actual image or a fake image

Note: You will need to create a new directory called "uploads" in the directory
where "upload.php" file resides. The uploaded files will be saved there.

Check if File Already Exists


Now we can add some restrictions.

First, we will check if the file already exists in the "uploads" folder. If it does, an
error message is displayed, and $uploadOk is set to 0:

// Check if file already exists


if (file_exists($target_file)) {
echo "Sorry, file already exists.";
$uploadOk = 0;
}

Limit File Size


The file input field in our HTML form above is named "fileToUpload".

Now, we want to check the size of the file. If the file is larger than 500KB, an
error message is displayed, and $uploadOk is set to 0:

// Check file size


if ($_FILES["fileToUpload"]["size"] > 500000) {
echo "Sorry, your file is too large.";
$uploadOk = 0;
}
Limit File Type
The code below only allows users to upload JPG, JPEG, PNG, and GIF files. All
other file types gives an error message before setting $uploadOk to 0:

// Allow certain file formats


if($imageFileType != "jpg" && $imageFileType != "png" &&
$imageFileType != "jpeg"
&& $imageFileType != "gif" ) {
echo "Sorry, only JPG, JPEG, PNG & GIF files are allowed.";
$uploadOk = 0;
}

Complete Upload File PHP Script


The complete "upload.php" file now looks like this:

<?php
$target_dir = "uploads/";
$target_file = $target_dir .
basename($_FILES["fileToUpload"]["name"]);
$uploadOk = 1;
$imageFileType =strtolower(pathinfo($target_file,PATHINFO_EXTENSION));
// Check if image file is a actual image or fake image
if(isset($_POST["submit"])) {
$check = getimagesize($_FILES["fileToUpload"]["tmp_name"]);
if($check !== false) {
echo "File is an image - " . $check["mime"] . ".";
$uploadOk = 1;
} else {
echo "File is not an image.";
$uploadOk = 0;
}
}
// Check if file already exists
if (file_exists($target_file)) {
echo "Sorry, file already exists.";
$uploadOk = 0;
}
// Check file size
if ($_FILES["fileToUpload"]["size"] > 500000) {
echo "Sorry, your file is too large.";
$uploadOk = 0;
}
// Allow certain file formats
if($imageFileType != "jpg" && $imageFileType != "png"&& $imageFileType
!= "jpeg"
&& $imageFileType != "gif" ) {
echo "Sorry, only JPG, JPEG, PNG & GIF files are allowed.";
$uploadOk = 0;
}
// Check if $uploadOk is set to 0 by an error
if ($uploadOk == 0) {
echo "Sorry, your file was not uploaded.";
// if everything is ok, try to upload file
} else {
if (move_uploaded_file($_FILES["fileToUpload"]["tmp_name"],
$target_file)) {
echo "The file ".
basename( $_FILES["fileToUpload"]["name"]). " has been uploaded.";
} else {
echo "Sorry, there was an error uploading your file.";
}
}
?>
PHP 5 Cookies
❮ PreviousNext ❯

A cookie is often used to identify a user.

What is a Cookie?
A cookie is often used to identify a user. A cookie is a small file that the server
embeds on the user's computer. Each time the same computer requests a page
with a browser, it will send the cookie too. With PHP, you can both create and
retrieve cookie values.

Create Cookies With PHP


A cookie is created with the setcookie() function.

Syntax
setcookie(name, value, expire, path, domain, secure, httponly);

Only the name parameter is required. All other parameters are optional.

PHP Create/Retrieve a Cookie


The following example creates a cookie named "user" with the value "John
Doe". The cookie will expire after 30 days (86400 * 30). The "/" means that the
cookie is available in entire website (otherwise, select the directory you prefer).

We then retrieve the value of the cookie "user" (using the global variable
$_COOKIE). We also use the isset() function to find out if the cookie is set:
Example
<?php
$cookie_name = "user";
$cookie_value = "John Doe";
setcookie($cookie_name, $cookie_value, time() + (86400* 30), "/"); //
86400 = 1 day
?>
<html>
<body>

<?php
if(!isset($_COOKIE[$cookie_name])) {
echo "Cookie named '" . $cookie_name . "' is not set!";
} else {
echo "Cookie '" . $cookie_name . "' is set!<br>";
echo "Value is: " . $_COOKIE[$cookie_name];
}
?>

</body>
</html>
Run example »

Note: The setcookie() function must appear BEFORE the <html> tag.

Note: The value of the cookie is automatically URLencoded when sending the
cookie, and automatically decoded when received (to prevent URLencoding,
use setrawcookie() instead).

Modify a Cookie Value


To modify a cookie, just set (again) the cookie using the setcookie() function:

Example
<?php
$cookie_name = "user";
$cookie_value = "Alex Porter";
setcookie($cookie_name, $cookie_value, time() + (86400* 30), "/");
?>
<html>
<body>

<?php
if(!isset($_COOKIE[$cookie_name])) {
echo "Cookie named '" . $cookie_name . "' is not set!";
} else {
echo "Cookie '" . $cookie_name . "' is set!<br>";
echo "Value is: " . $_COOKIE[$cookie_name];
}
?>

</body>
</html>
Run example »

Delete a Cookie
To delete a cookie, use the setcookie() function with an expiration date in the
past:

Example
<?php
// set the expiration date to one hour ago
setcookie("user", "", time() - 3600);
?>
<html>
<body>

<?php
echo "Cookie 'user' is deleted.";
?>

</body>
</html>
Run example »
Check if Cookies are Enabled
The following example creates a small script that checks whether cookies are
enabled. First, try to create a test cookie with the setcookie() function, then
count the $_COOKIE array variable:

Example
<?php
setcookie("test_cookie", "test", time() + 3600, '/');
?>
<html>
<body>

<?php
if(count($_COOKIE) > 0) {
echo "Cookies are enabled.";
} else {
echo "Cookies are disabled.";
}
?>

</body>
</html>
Run example »

Complete PHP HTTP Reference


For a complete reference of HTTP functions, go to our completePHP HTTP
Reference.

Test Yourself With Exercises


Exercise:
Create a cookie named "username".
("username", "John", time() + (86400 * 3
PHP 5 Sessions
❮ PreviousNext ❯

A session is a way to store information (in variables) to be used across


multiple pages.

Unlike a cookie, the information is not stored on the users computer.

What is a PHP Session?


When you work with an application, you open it, do some changes, and then
you close it. This is much like a Session. The computer knows who you are. It
knows when you start the application and when you end. But on the internet
there is one problem: the web server does not know who you are or what you
do, because the HTTP address doesn't maintain state.

Session variables solve this problem by storing user information to be used


across multiple pages (e.g. username, favorite color, etc). By default, session
variables last until the user closes the browser.

So; Session variables hold information about one single user, and are available
to all pages in one application.

Tip: If you need a permanent storage, you may want to store the data in
a database.

Start a PHP Session


A session is started with the session_start() function.

Session variables are set with the PHP global variable: $_SESSION.

Now, let's create a new page called "demo_session1.php". In this page, we start
a new PHP session and set some session variables:
Example
<?php
// Start the session
session_start();
?>
<!DOCTYPE html>
<html>
<body>

<?php
// Set session variables
$_SESSION["favcolor"] = "green";
$_SESSION["favanimal"] = "cat";
echo "Session variables are set.";
?>

</body>
</html>
Run example »

Note: The session_start() function must be the very first thing in your
document. Before any HTML tags.

Get PHP Session Variable Values


Next, we create another page called "demo_session2.php". From this page, we
will access the session information we set on the first page
("demo_session1.php").

Notice that session variables are not passed individually to each new page,
instead they are retrieved from the session we open at the beginning of each
page (session_start()).

Also notice that all session variable values are stored in the global $_SESSION
variable:

Example
<?php
session_start();
?>
<!DOCTYPE html>
<html>
<body>

<?php
// Echo session variables that were set on previous page
echo "Favorite color is " . $_SESSION["favcolor"] . ".<br>";
echo "Favorite animal is " . $_SESSION["favanimal"] . ".";
?>

</body>
</html>
Run example »

Another way to show all the session variable values for a user session is to run
the following code:

Example
<?php
session_start();
?>
<!DOCTYPE html>
<html>
<body>

<?php
print_r($_SESSION);
?>

</body>
</html>
Run example »

How does it work? How does it know it's me?

Most sessions set a user-key on the user's computer that looks something like
this: 765487cf34ert8dede5a562e4f3a7e12. Then, when a session is opened on
another page, it scans the computer for a user-key. If there is a match, it
accesses that session, if not, it starts a new session.
Modify a PHP Session Variable
To change a session variable, just overwrite it:

Example
<?php
session_start();
?>
<!DOCTYPE html>
<html>
<body>

<?php
// to change a session variable, just overwrite it
$_SESSION["favcolor"] = "yellow";
print_r($_SESSION);
?>

</body>
</html>
Run example »

Destroy a PHP Session


To remove all global session variables and destroy the session,
use session_unset() and session_destroy():

Example
<?php
session_start();
?>
<!DOCTYPE html>
<html>
<body>

<?php
// remove all session variables
session_unset();
// destroy the session
session_destroy();
?>

</body>
</html>
Run example »

Test Yourself With Exercises


Exercise:
Create a session variable named "favcolor".

session_start();
["favcolor"] = "green";
PHP Filters
❮ PreviousNext ❯

Validating data = Determine if the data is in proper form.

Sanitizing data = Remove any illegal character from the data.

The PHP Filter Extension


PHP filters are used to validate and sanitize external input.

The PHP filter extension has many of the functions needed for checking user
input, and is designed to make data validation easier and quicker.

The filter_list() function can be used to list what the PHP filter extension
offers:

Example
<table>
<tr>
<td>Filter Name</td>
<td>Filter ID</td>
</tr>
<?php
foreach (filter_list() as $id =>$filter) {
echo '<tr><td>' . $filter . '</td><td>' . filter_id($filter)
. '</td></tr>';
}
?>
</table>
Run example »

Why Use Filters?


Many web applications receive external input. External input/data can be:

 User input from a form


 Cookies
 Web services data
 Server variables
 Database query results

You should always validate external data!


Invalid submitted data can lead to security problems and break your webpage!
By using PHP filters you can be sure your application gets the correct input!

PHP filter_var() Function


The filter_var() function both validate and sanitize data.

The filter_var() function filters a single variable with a specified filter. It


takes two pieces of data:

 The variable you want to check


 The type of check to use

Sanitize a String
The following example uses the filter_var() function to remove all HTML tags
from a string:

Example
<?php
$str = "<h1>Hello World!</h1>";
$newstr = filter_var($str, FILTER_SANITIZE_STRING);
echo $newstr;
?>
Run example »
Validate an Integer
The following example uses the filter_var() function to check if the variable
$int is an integer. If $int is an integer, the output of the code below will be:
"Integer is valid". If $int is not an integer, the output will be: "Integer is not
valid":

Example
<?php
$int = 100;

if (!filter_var($int, FILTER_VALIDATE_INT) === false) {


echo("Integer is valid");
} else {
echo("Integer is not valid");
}
?>
Run example »

Tip: filter_var() and Problem With 0


In the example above, if $int was set to 0, the function above will return
"Integer is not valid". To solve this problem, use the code below:

Example
<?php
$int = 0;

if (filter_var($int, FILTER_VALIDATE_INT) === 0 || !filter_var($int,


FILTER_VALIDATE_INT) === false) {
echo("Integer is valid");
} else {
echo("Integer is not valid");
}
?>
Run example »

Validate an IP Address
The following example uses the filter_var() function to check if the variable
$ip is a valid IP address:

Example
<?php
$ip = "127.0.0.1";

if (!filter_var($ip, FILTER_VALIDATE_IP) === false) {


echo("$ip is a valid IP address");
} else {
echo("$ip is not a valid IP address");
}
?>
Run example »

Sanitize and Validate an Email Address


The following example uses the filter_var() function to first remove all illegal
characters from the $email variable, then check if it is a valid email address:

Example
<?php
$email = "john.doe@example.com";

// Remove all illegal characters from email


$email = filter_var($email, FILTER_SANITIZE_EMAIL);

// Validate e-mail
if (!filter_var($email, FILTER_VALIDATE_EMAIL) === false) {
echo("$email is a valid email address");
} else {
echo("$email is not a valid email address");
}
?>
Run example »

Sanitize and Validate a URL


The following example uses the filter_var() function to first remove all illegal
characters from a URL, then check if $url is a valid URL:

Example
<?php
$url = "https://www.w3schools.com";

// Remove all illegal characters from a url


$url = filter_var($url, FILTER_SANITIZE_URL);

// Validate url
if (!filter_var($url, FILTER_VALIDATE_URL) === false) {
echo("$url is a valid URL");
} else {
echo("$url is not a valid URL");
}
?>
PHP Filters Advanced
❮ PreviousNext ❯

Validate an Integer Within a Range


The following example uses the filter_var() function to check if a variable is
both of type INT, and between 1 and 200:

Example
<?php
$int = 122;
$min = 1;
$max = 200;

if (filter_var($int,
FILTER_VALIDATE_INT, array("options" => array("min_range"=>$min, "max_
range"=>$max))) === false) {
echo("Variable value is not within the legal range");
} else {
echo("Variable value is within the legal range");
}
?>
Run example »

Validate IPv6 Address


The following example uses the filter_var() function to check if the variable
$ip is a valid IPv6 address:

Example
<?php
$ip = "2001:0db8:85a3:08d3:1319:8a2e:0370:7334";

if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) === false)


{
echo("$ip is a valid IPv6 address");
} else {
echo("$ip is not a valid IPv6 address");
}
?>
Run example »

Validate URL - Must Contain QueryString


The following example uses the filter_var() function to check if the variable
$url is a URL with a querystring:

Example
<?php
$url = "https://www.w3schools.com";

if (!filter_var($url, FILTER_VALIDATE_URL, FILTER_FLAG_QUERY_REQUIRED)


=== false) {
echo("$url is a valid URL");
} else {
echo("$url is not a valid URL");
}
?>
Run example »

Remove Characters With ASCII Value > 127


The following example uses the filter_var() function to sanitize a string. It
will both remove all HTML tags, and all characters with ASCII value > 127, from
the string:

Example
<?php
$str = "<h1>Hello WorldÆØÅ!</h1>";
$newstr = filter_var($str, FILTER_SANITIZE_STRING,
FILTER_FLAG_STRIP_HIGH);
echo $newstr;
?>
Run example »
PHP Error Handling
❮ PreviousNext ❯

The default error handling in PHP is very simple. An error message with
filename, line number and a message describing the error is sent to the
browser.

PHP Error Handling


When creating scripts and web applications, error handling is an important part.
If your code lacks error checking code, your program may look very
unprofessional and you may be open to security risks.

This tutorial contains some of the most common error checking methods in PHP.

We will show different error handling methods:

 Simple "die()" statements


 Custom errors and error triggers
 Error reporting

Basic Error Handling: Using the die() function


The first example shows a simple script that opens a text file:

<?php
$file=fopen("welcome.txt","r");
?>

If the file does not exist you might get an error like this:

Warning: fopen(welcome.txt) [function.fopen]: failed to open stream:


No such file or directory in C:\webfolder\test.php on line 2
To prevent the user from getting an error message like the one above, we test
whether the file exist before we try to access it:

<?php
if(!file_exists("welcome.txt")) {
die("File not found");
} else {
$file=fopen("welcome.txt","r");
}
?>

Now if the file does not exist you get an error like this:

File not found

The code above is more efficient than the earlier code, because it uses a simple
error handling mechanism to stop the script after the error.

However, simply stopping the script is not always the right way to go. Let's take
a look at alternative PHP functions for handling errors.

Creating a Custom Error Handler


Creating a custom error handler is quite simple. We simply create a special
function that can be called when an error occurs in PHP.

This function must be able to handle a minimum of two parameters (error level
and error message) but can accept up to five parameters (optionally: file, line-
number, and the error context):

Syntax
error_function(error_level,error_message,
error_file,error_line,error_context)

Parameter Description
error_level Required. Specifies the error report level for
the user-defined error. Must be a value
number. See table below for possible error
report levels

error_message Required. Specifies the error message for the


user-defined error

error_file Optional. Specifies the filename in which the


error occurred

error_line Optional. Specifies the line number in which


the error occurred

error_context Optional. Specifies an array containing every


variable, and their values, in use when the
error occurred

Error Report levels


These error report levels are the different types of error the user-defined error
handler can be used for:

Value Constant Description

2 E_WARNING Non-fatal run-time errors.


Execution of the script is not
halted
8 E_NOTICE Run-time notices. The script found
something that might be an error,
but could also happen when
running a script normally

256 E_USER_ERROR Fatal user-generated error. This is


like an E_ERROR set by the
programmer using the PHP
function trigger_error()

512 E_USER_WARNING Non-fatal user-generated warning.


This is like an E_WARNING set
by the programmer using the PHP
function trigger_error()

1024 E_USER_NOTICE User-generated notice. This is like


an E_NOTICE set by the
programmer using the PHP
function trigger_error()

4096 E_RECOVERABLE_ERROR Catchable fatal error. This is like


an E_ERROR but can be caught
by a user defined handle (see also
set_error_handler())

8191 E_ALL All errors and warnings


(E_STRICT became a part of
E_ALL in PHP 5.4)

Now lets create a function to handle errors:

function customError($errno, $errstr) {


echo "<b>Error:</b> [$errno] $errstr<br>";
echo "Ending Script";
die();
}

The code above is a simple error handling function. When it is triggered, it gets
the error level and an error message. It then outputs the error level and
message and terminates the script.

Now that we have created an error handling function we need to decide when it
should be triggered.

Set Error Handler


The default error handler for PHP is the built in error handler. We are going to
make the function above the default error handler for the duration of the script.

It is possible to change the error handler to apply for only some errors, that
way the script can handle different errors in different ways. However, in this
example we are going to use our custom error handler for all errors:

set_error_handler("customError");

Since we want our custom function to handle all errors,


the set_error_handler() only needed one parameter, a second parameter
could be added to specify an error level.

Example
Testing the error handler by trying to output variable that does not exist:

<?php
//error handler function
function customError($errno, $errstr) {
echo "<b>Error:</b> [$errno] $errstr";
}

//set error handler


set_error_handler("customError");

//trigger error
echo($test);
?>

The output of the code above should be something like this:

Error: [8] Undefined variable: test

Trigger an Error
In a script where users can input data it is useful to trigger errors when an
illegal input occurs. In PHP, this is done by the trigger_error() function.

Example
In this example an error occurs if the "test" variable is bigger than "1":

<?php
$test=2;
if ($test>=1) {
trigger_error("Value must be 1 or below");
}
?>

The output of the code above should be something like this:

Notice: Value must be 1 or below


in C:\webfolder\test.php on line 6

An error can be triggered anywhere you wish in a script, and by adding a


second parameter, you can specify what error level is triggered.

Possible error types:

 E_USER_ERROR - Fatal user-generated run-time error. Errors that can


not be recovered from. Execution of the script is halted
 E_USER_WARNING - Non-fatal user-generated run-time warning.
Execution of the script is not halted
 E_USER_NOTICE - Default. User-generated run-time notice. The script
found something that might be an error, but could also happen when
running a script normally
Example
In this example an E_USER_WARNING occurs if the "test" variable is bigger
than "1". If an E_USER_WARNING occurs we will use our custom error handler
and end the script:

<?php
//error handler function
function customError($errno, $errstr) {
echo "<b>Error:</b> [$errno] $errstr<br>";
echo "Ending Script";
die();
}

//set error handler


set_error_handler("customError",E_USER_WARNING);

//trigger error
$test=2;
if ($test>=1) {
trigger_error("Value must be 1 or below",E_USER_WARNING);
}
?>

The output of the code above should be something like this:

Error: [512] Value must be 1 or below


Ending Script

Now that we have learned to create our own errors and how to trigger them,
lets take a look at error logging.

Error Logging
By default, PHP sends an error log to the server's logging system or a file,
depending on how the error_log configuration is set in the php.ini file. By using
the error_log() function you can send error logs to a specified file or a remote
destination.

Sending error messages to yourself by e-mail can be a good way of getting


notified of specific errors.
Send an Error Message by E-Mail
In the example below we will send an e-mail with an error message and end the
script, if a specific error occurs:

<?php
//error handler function
function customError($errno, $errstr) {
echo "<b>Error:</b> [$errno] $errstr<br>";
echo "Webmaster has been notified";
error_log("Error: [$errno] $errstr",1,
"someone@example.com","From: webmaster@example.com");
}

//set error handler


set_error_handler("customError",E_USER_WARNING);

//trigger error
$test=2;
if ($test>=1) {
trigger_error("Value must be 1 or below",E_USER_WARNING);
}
?>

The output of the code above should be something like this:

Error: [512] Value must be 1 or below


Webmaster has been notified

And the mail received from the code above looks like this:

Error: [512] Value must be 1 or below

This should not be used with all errors. Regular errors should be logged on the
server using the default PHP logging system.
PHP Exception Handling
❮ PreviousNext ❯

Exceptions are used to change the normal flow of a script if a specified error
occurs.

What is an Exception
With PHP 5 came a new object oriented way of dealing with errors.

Exception handling is used to change the normal flow of the code execution if a
specified error (exceptional) condition occurs. This condition is called an
exception.

This is what normally happens when an exception is triggered:

 The current code state is saved


 The code execution will switch to a predefined (custom) exception handler
function
 Depending on the situation, the handler may then resume the execution
from the saved code state, terminate the script execution or continue the
script from a different location in the code

We will show different error handling methods:

 Basic use of Exceptions


 Creating a custom exception handler
 Multiple exceptions
 Re-throwing an exception
 Setting a top level exception handler

Note: Exceptions should only be used with error conditions, and should not be
used to jump to another place in the code at a specified point.

Basic Use of Exceptions


When an exception is thrown, the code following it will not be executed, and
PHP will try to find the matching "catch" block.

If an exception is not caught, a fatal error will be issued with an "Uncaught


Exception" message.

Lets try to throw an exception without catching it:

<?php
//create function with an exception
function checkNum($number) {
if($number>1) {
throw new Exception("Value must be 1 or below");
}
return true;
}

//trigger exception
checkNum(2);
?>

The code above will get an error like this:

Fatal error: Uncaught exception 'Exception'


with message 'Value must be 1 or below' in C:\webfolder\test.php:6
Stack trace: #0 C:\webfolder\test.php(12):
checkNum(28) #1 {main} thrown in C:\webfolder\test.phpon line 6

Try, throw and catch


To avoid the error from the example above, we need to create the proper code
to handle an exception.

Proper exception code should include:

1. try - A function using an exception should be in a "try" block. If the


exception does not trigger, the code will continue as normal. However if
the exception triggers, an exception is "thrown"
2. throw - This is how you trigger an exception. Each "throw" must have at
least one "catch"
3. catch - A "catch" block retrieves an exception and creates an object
containing the exception information

Lets try to trigger an exception with valid code:


<?php
//create function with an exception
function checkNum($number) {
if($number>1) {
throw new Exception("Value must be 1 or below");
}
return true;
}

//trigger exception in a "try" block


try {
checkNum(2);
//If the exception is thrown, this text will not be shown
echo 'If you see this, the number is 1 or below';
}

//catch exception
catch(Exception $e) {
echo 'Message: ' .$e->getMessage();
}
?>

The code above will get an error like this:

Message: Value must be 1 or below

Example explained:
The code above throws an exception and catches it:

1. The checkNum() function is created. It checks if a number is greater than


1. If it is, an exception is thrown
2. The checkNum() function is called in a "try" block
3. The exception within the checkNum() function is thrown
4. The "catch" block retrieves the exception and creates an object ($e)
containing the exception information
5. The error message from the exception is echoed by calling $e-
>getMessage() from the exception object

However, one way to get around the "every throw must have a catch" rule is to
set a top level exception handler to handle errors that slip through.
Creating a Custom Exception Class
To create a custom exception handler you must create a special class with
functions that can be called when an exception occurs in PHP. The class must be
an extension of the exception class.

The custom exception class inherits the properties from PHP's exception class
and you can add custom functions to it.

Lets create an exception class:

<?php
class customException extends Exception {
public function errorMessage() {
//error message
$errorMsg = 'Error on line '.$this->getLine().' in '.$this-
>getFile()
.': <b>'.$this->getMessage().'</b> is not a valid E-Mail address';
return $errorMsg;
}
}

$email = "someone@example...com";

try {
//check if
if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE) {
//throw exception if email is not valid
throw new customException($email);
}
}

catch (customException $e) {


//display custom message
echo $e->errorMessage();
}
?>

The new class is a copy of the old exception class with an addition of the
errorMessage() function. Since it is a copy of the old class, and it inherits the
properties and methods from the old class, we can use the exception class
methods like getLine() and getFile() and getMessage().
Example explained:
The code above throws an exception and catches it with a custom exception
class:

1. The customException() class is created as an extension of the old


exception class. This way it inherits all methods and properties from the
old exception class
2. The errorMessage() function is created. This function returns an error
message if an e-mail address is invalid
3. The $email variable is set to a string that is not a valid e-mail address
4. The "try" block is executed and an exception is thrown since the e-mail
address is invalid
5. The "catch" block catches the exception and displays the error message

Multiple Exceptions
It is possible for a script to use multiple exceptions to check for multiple
conditions.

It is possible to use several if..else blocks, a switch, or nest multiple exceptions.


These exceptions can use different exception classes and return different error
messages:

<?php
class customException extends Exception {
public function errorMessage() {
//error message
$errorMsg = 'Error on line '.$this->getLine().' in '.$this-
>getFile()
.': <b>'.$this->getMessage().'</b> is not a valid E-Mail address';
return $errorMsg;
}
}

$email = "someone@example.com";

try {
//check if
if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE) {
//throw exception if email is not valid
throw new customException($email);
}
//check for "example" in mail address
if(strpos($email, "example") !== FALSE) {
throw new Exception("$email is an example e-mail");
}
}

catch (customException $e) {


echo $e->errorMessage();
}

catch(Exception $e) {
echo $e->getMessage();
}
?>

Example explained:
The code above tests two conditions and throws an exception if any of the
conditions are not met:

1. The customException() class is created as an extension of the old


exception class. This way it inherits all methods and properties from the
old exception class
2. The errorMessage() function is created. This function returns an error
message if an e-mail address is invalid
3. The $email variable is set to a string that is a valid e-mail address, but
contains the string "example"
4. The "try" block is executed and an exception is not thrown on the first
condition
5. The second condition triggers an exception since the e-mail contains the
string "example"
6. The "catch" block catches the exception and displays the correct error
message

If the exception thrown were of the class customException and there were no
customException catch, only the base exception catch, the exception would be
handled there.

Re-throwing Exceptions
Sometimes, when an exception is thrown, you may wish to handle it differently
than the standard way. It is possible to throw an exception a second time within
a "catch" block.

A script should hide system errors from users. System errors may be important
for the coder, but are of no interest to the user. To make things easier for the
user you can re-throw the exception with a user friendly message:

<?php
class customException extends Exception {
public function errorMessage() {
//error message
$errorMsg = $this->getMessage().' is not a valid E-Mail address.';
return $errorMsg;
}
}

$email = "someone@example.com";

try {
try {
//check for "example" in mail address
if(strpos($email, "example") !== FALSE) {
//throw exception if email is not valid
throw new Exception($email);
}
}
catch(Exception $e) {
//re-throw exception
throw new customException($email);
}
}

catch (customException $e) {


//display custom message
echo $e->errorMessage();
}
?>

Example explained:
The code above tests if the email-address contains the string "example" in it, if
it does, the exception is re-thrown:
1. The customException() class is created as an extension of the old
exception class. This way it inherits all methods and properties from the
old exception class
2. The errorMessage() function is created. This function returns an error
message if an e-mail address is invalid
3. The $email variable is set to a string that is a valid e-mail address, but
contains the string "example"
4. The "try" block contains another "try" block to make it possible to re-
throw the exception
5. The exception is triggered since the e-mail contains the string "example"
6. The "catch" block catches the exception and re-throws a
"customException"
7. The "customException" is caught and displays an error message

If the exception is not caught in its current "try" block, it will search for a catch
block on "higher levels".

Set a Top Level Exception Handler


The set_exception_handler() function sets a user-defined function to handle
all uncaught exceptions:

<?php
function myException($exception) {
echo "<b>Exception:</b> " . $exception->getMessage();
}

set_exception_handler('myException');

throw new Exception('Uncaught Exception occurred');


?>

The output of the code above should be something like this:

Exception: Uncaught Exception occurred

In the code above there was no "catch" block. Instead, the top level exception
handler triggered. This function should be used to catch uncaught exceptions.
Rules for exceptions
 Code may be surrounded in a try block, to help catch potential exceptions
 Each try block or "throw" must have at least one corresponding catch
block
 Multiple catch blocks can be used to catch different classes of exceptions
 Exceptions can be thrown (or re-thrown) in a catch block within a try
block

A simple rule: If you throw something, you have to catch it.


PHP MySQL Database
❮ PreviousNext ❯

With PHP, you can connect to and manipulate databases.

MySQL is the most popular database system used with PHP.

What is MySQL?
 MySQL is a database system used on the web
 MySQL is a database system that runs on a server
 MySQL is ideal for both small and large applications
 MySQL is very fast, reliable, and easy to use
 MySQL uses standard SQL
 MySQL compiles on a number of platforms
 MySQL is free to download and use
 MySQL is developed, distributed, and supported by Oracle Corporation
 MySQL is named after co-founder Monty Widenius's daughter: My

The data in a MySQL database are stored in tables. A table is a collection of


related data, and it consists of columns and rows.

Databases are useful for storing information categorically. A company may have
a database with the following tables:

 Employees
 Products
 Customers
 Orders

PHP + MySQL Database System


 PHP combined with MySQL are cross-platform (you can develop in
Windows and serve on a Unix platform)
Database Queries
A query is a question or a request.

We can query a database for specific information and have a recordset


returned.

Look at the following query (using standard SQL):

SELECT LastName FROM Employees

The query above selects all the data in the "LastName" column from the
"Employees" table.

To learn more about SQL, please visit our SQL tutorial.

Download MySQL Database


If you don't have a PHP server with a MySQL Database, you can download it for
free here: http://www.mysql.com

Facts About MySQL Database


MySQL is the de-facto standard database system for web sites with HUGE
volumes of both data and end-users (like Facebook, Twitter, and Wikipedia).

Another great thing about MySQL is that it can be scaled down to support
embedded database applications.

Look at http://www.mysql.com/customers/ for an overview of companies using


MySQL.
PHP Connect to MySQL
❮ PreviousNext ❯

PHP 5 and later can work with a MySQL database using:

 MySQLi extension (the "i" stands for improved)


 PDO (PHP Data Objects)

Earlier versions of PHP used the MySQL extension. However, this extension
was deprecated in 2012.

Should I Use MySQLi or PDO?


If you need a short answer, it would be "Whatever you like".

Both MySQLi and PDO have their advantages:

PDO will work on 12 different database systems, whereas MySQLi will only work
with MySQL databases.

So, if you have to switch your project to use another database, PDO makes the
process easy. You only have to change the connection string and a few queries.
With MySQLi, you will need to rewrite the entire code - queries included.

Both are object-oriented, but MySQLi also offers a procedural API.

Both support Prepared Statements. Prepared Statements protect from SQL


injection, and are very important for web application security.

MySQL Examples in Both MySQLi and PDO


Syntax
In this, and in the following chapters we demonstrate three ways of working
with PHP and MySQL:
 MySQLi (object-oriented)
 MySQLi (procedural)
 PDO

MySQLi Installation
For Linux and Windows: The MySQLi extension is automatically installed in most
cases, when php5 mysql package is installed.

For installation details, go to:http://php.net/manual/en/mysqli.installation.php

PDO Installation
For installation details, go to:http://php.net/manual/en/pdo.installation.php

Open a Connection to MySQL


Before we can access data in the MySQL database, we need to be able to
connect to the server:

Example (MySQLi Object-Oriented)


<?php
$servername = "localhost";
$username = "username";
$password = "password";

// Create connection
$conn = new mysqli($servername, $username, $password);

// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}
echo "Connected successfully";
?>

PHP is an amazing and popular language!

Note on the object-oriented example above: $connect_error was broken until


PHP 5.2.9 and 5.3.0. If you need to ensure compatibility with PHP versions prior
to 5.2.9 and 5.3.0, use the following code instead:

// Check connection
if (mysqli_connect_error()) {
die("Database connection failed: " . mysqli_connect_error());
}

Example (MySQLi Procedural)


<?php
$servername = "localhost";
$username = "username";
$password = "password";

// Create connection
$conn = mysqli_connect($servername, $username, $password);

// Check connection
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}
echo "Connected successfully";
?>

Example (PDO)
<?php
$servername = "localhost";
$username = "username";
$password = "password";

try {
$conn = newPDO("mysql:host=$servername;dbname=myDB", $username,
$password);
// set the PDO error mode to exception
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "Connected successfully";
}
catch(PDOException $e)
{
echo "Connection failed: " . $e->getMessage();
}
?>

Note: In the PDO example above we have also specified a database


(myDB). PDO require a valid database to connect to. If no database is
specified, an exception is thrown.

Tip: A great benefit of PDO is that it has an exception class to handle any
problems that may occur in our database queries. If an exception is thrown
within the try{ } block, the script stops executing and flows directly to the first
catch(){ } block.

Close the Connection


The connection will be closed automatically when the script ends. To close the
connection before, use the following:

Example (MySQLi Object-Oriented)


$conn->close();

Example (MySQLi Procedural)


mysqli_close($conn);

Example (PDO)
$conn = null;
PHP Create a MySQL Database
❮ PreviousNext ❯

A database consists of one or more tables.

You will need special CREATE privileges to create or to delete a MySQL


database.

Create a MySQL Database Using MySQLi and


PDO
The CREATE DATABASE statement is used to create a database in MySQL.

The following examples create a database named "myDB":

Example (MySQLi Object-oriented)


<?php
$servername = "localhost";
$username = "username";
$password = "password";

// Create connection
$conn = new mysqli($servername, $username, $password);
// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

// Create database
$sql = "CREATE DATABASE myDB";
if ($conn->query($sql) === TRUE) {
echo "Database created successfully";
} else {
echo "Error creating database: " . $conn->error;
}
$conn->close();
?>

Note: When you create a new database, you must only specify the first three
arguments to the mysqli object (servername, username and password).

Tip: If you have to use a specific port, add an empty string for the database-
name argument, like this: new mysqli("localhost", "username", "password", "",
port)

Example (MySQLi Procedural)


<?php
$servername = "localhost";
$username = "username";
$password = "password";

// Create connection
$conn = mysqli_connect($servername, $username, $password);
// Check connection
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}

// Create database
$sql = "CREATE DATABASE myDB";
if (mysqli_query($conn, $sql)) {
echo "Database created successfully";
} else {
echo "Error creating database: " . mysqli_error($conn);
}

mysqli_close($conn);
?>

Note: The following PDO example create a database named "myDBPDO":

Example (PDO)
<?php
$servername = "localhost";
$username = "username";
$password = "password";

try {
$conn = new PDO("mysql:host=$servername", $username, $password);
// set the PDO error mode to exception
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$sql = "CREATE DATABASE myDBPDO";
// use exec() because no results are returned
$conn->exec($sql);
echo "Database created successfully<br>";
}
catch(PDOException $e)
{
echo $sql . "<br>" . $e->getMessage();
}

$conn = null;
?>

Tip: A great benefit of PDO is that it has exception class to handle any problems
that may occur in our database queries. If an exception is thrown within the
try{ } block, the script stops executing and flows directly to the first catch(){ }
block. In the catch block above we echo the SQL statement and the generated
error message.
PHP Create MySQL Tables
❮ PreviousNext ❯

A database table has its own unique name and consists of columns and
rows.

Create a MySQL Table Using MySQLi and PDO


The CREATE TABLE statement is used to create a table in MySQL.

We will create a table named "MyGuests", with five columns: "id", "firstname",
"lastname", "email" and "reg_date":

CREATE TABLE MyGuests (


id INT(6) UNSIGNED AUTO_INCREMENT PRIMARY KEY,
firstname VARCHAR(30) NOT NULL,
lastname VARCHAR(30) NOT NULL,
email VARCHAR(50),
reg_date TIMESTAMP
)

Notes on the table above:

The data type specifies what type of data the column can hold. For a complete
reference of all the available data types, go to our Data Types reference.

After the data type, you can specify other optional attributes for each column:

 NOT NULL - Each row must contain a value for that column, null values
are not allowed
 DEFAULT value - Set a default value that is added when no other value is
passed
 UNSIGNED - Used for number types, limits the stored data to positive
numbers and zero
 AUTO INCREMENT - MySQL automatically increases the value of the field
by 1 each time a new record is added
 PRIMARY KEY - Used to uniquely identify the rows in a table. The column
with PRIMARY KEY setting is often an ID number, and is often used with
AUTO_INCREMENT

Each table should have a primary key column (in this case: the "id" column). Its
value must be unique for each record in the table.

The following examples shows how to create the table in PHP:

Example (MySQLi Object-oriented)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = new mysqli($servername, $username, $password, $dbname);
// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

// sql to create table


$sql = "CREATE TABLE MyGuests (
id INT(6) UNSIGNED AUTO_INCREMENT PRIMARY KEY,
firstname VARCHAR(30) NOT NULL,
lastname VARCHAR(30) NOT NULL,
email VARCHAR(50),
reg_date TIMESTAMP
)";

if ($conn->query($sql) === TRUE) {


echo "Table MyGuests created successfully";
} else {
echo "Error creating table: " . $conn->error;
}

$conn->close();
?>
Example (MySQLi Procedural)
<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = mysqli_connect($servername, $username, $password, $dbname);
// Check connection
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}

// sql to create table


$sql = "CREATE TABLE MyGuests (
id INT(6) UNSIGNED AUTO_INCREMENT PRIMARY KEY,
firstname VARCHAR(30) NOT NULL,
lastname VARCHAR(30) NOT NULL,
email VARCHAR(50),
reg_date TIMESTAMP
)";

if (mysqli_query($conn, $sql)) {
echo "Table MyGuests created successfully";
} else {
echo "Error creating table: " . mysqli_error($conn);
}

mysqli_close($conn);
?>

Example (PDO)
<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDBPDO";

try {
$conn = newPDO("mysql:host=$servername;dbname=$dbname", $username,
$password);
// set the PDO error mode to exception
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

// sql to create table


$sql = "CREATE TABLE MyGuests (
id INT(6) UNSIGNED AUTO_INCREMENT PRIMARY KEY,
firstname VARCHAR(30) NOT NULL,
lastname VARCHAR(30) NOT NULL,
email VARCHAR(50),
reg_date TIMESTAMP
)";

// use exec() because no results are returned


$conn->exec($sql);
echo "Table MyGuests created successfully";
}
catch(PDOException $e)
{
echo $sql . "<br>" . $e->getMessage();
}

$conn = null;
?>
PHP Insert Data Into MySQL
❮ PreviousNext ❯

Insert Data Into MySQL Using MySQLi and


PDO
After a database and a table have been created, we can start adding data in
them.

Here are some syntax rules to follow:

 The SQL query must be quoted in PHP


 String values inside the SQL query must be quoted
 Numeric values must not be quoted
 The word NULL must not be quoted

The INSERT INTO statement is used to add new records to a MySQL table:

INSERT INTO table_name (column1, column2, column3,...)


VALUES (value1, value2, value3,...)

To learn more about SQL, please visit our SQL tutorial.

In the previous chapter we created an empty table named "MyGuests" with five
columns: "id", "firstname", "lastname", "email" and "reg_date". Now, let us fill
the table with data.

Note: If a column is AUTO_INCREMENT (like the "id" column) or TIMESTAMP


(like the "reg_date" column), it is no need to be specified in the SQL query;
MySQL will automatically add the value.

The following examples add a new record to the "MyGuests" table:

Example (MySQLi Object-oriented)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = new mysqli($servername, $username, $password, $dbname);
// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

$sql = "INSERT INTO MyGuests (firstname, lastname, email)


VALUES ('John', 'Doe', 'john@example.com')";

if ($conn->query($sql) === TRUE) {


echo "New record created successfully";
} else {
echo "Error: " . $sql . "<br>" . $conn->error;
}

$conn->close();
?>

Example (MySQLi Procedural)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = mysqli_connect($servername, $username, $password, $dbname);
// Check connection
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}

$sql = "INSERT INTO MyGuests (firstname, lastname, email)


VALUES ('John', 'Doe', 'john@example.com')";

if (mysqli_query($conn, $sql)) {
echo "New record created successfully";
} else {
echo "Error: " . $sql . "<br>" . mysqli_error($conn);
}

mysqli_close($conn);
?>

Example (PDO)
<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDBPDO";

try {
$conn = newPDO("mysql:host=$servername;dbname=$dbname", $username,
$password);
// set the PDO error mode to exception
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$sql = "INSERT INTO MyGuests (firstname, lastname, email)
VALUES ('John', 'Doe', 'john@example.com')";
// use exec() because no results are returned
$conn->exec($sql);
echo "New record created successfully";
}
catch(PDOException $e)
{
echo $sql . "<br>" . $e->getMessage();
}

$conn = null;
?>
PHP Get ID of Last Inserted Record
❮ PreviousNext ❯

Get ID of The Last Inserted Record


If we perform an INSERT or UPDATE on a table with an AUTO_INCREMENT field,
we can get the ID of the last inserted/updated record immediately.

In the table "MyGuests", the "id" column is an AUTO_INCREMENT field:

CREATE TABLE MyGuests (


id INT(6) UNSIGNED AUTO_INCREMENT PRIMARY KEY,
firstname VARCHAR(30) NOT NULL,
lastname VARCHAR(30) NOT NULL,
email VARCHAR(50),
reg_date TIMESTAMP
)

The following examples are equal to the examples from the previous page (PHP
Insert Data Into MySQL), except that we have added one single line of code to
retrieve the ID of the last inserted record. We also echo the last inserted ID:

Example (MySQLi Object-oriented)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = new mysqli($servername, $username, $password, $dbname);
// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

$sql = "INSERT INTO MyGuests (firstname, lastname, email)


VALUES ('John', 'Doe', 'john@example.com')";
if ($conn->query($sql) === TRUE) {
$last_id = $conn->insert_id;
echo "New record created successfully. Last inserted ID is: " .
$last_id;
} else {
echo "Error: " . $sql . "<br>" . $conn->error;
}

$conn->close();
?>

Example (MySQLi Procedural)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = mysqli_connect($servername, $username, $password, $dbname);
// Check connection
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}

$sql = "INSERT INTO MyGuests (firstname, lastname, email)


VALUES ('John', 'Doe', 'john@example.com')";

if (mysqli_query($conn, $sql)) {
$last_id = mysqli_insert_id($conn);
echo "New record created successfully. Last inserted ID is: " .
$last_id;
} else {
echo "Error: " . $sql . "<br>" . mysqli_error($conn);
}

mysqli_close($conn);
?>
Example (PDO)
<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDBPDO";

try {
$conn = newPDO("mysql:host=$servername;dbname=$dbname", $username,
$password);
// set the PDO error mode to exception
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$sql = "INSERT INTO MyGuests (firstname, lastname, email)
VALUES ('John', 'Doe', 'john@example.com')";
// use exec() because no results are returned
$conn->exec($sql);
$last_id = $conn->lastInsertId();
echo "New record created successfully. Last inserted ID is: " .
$last_id;
}
catch(PDOException $e)
{
echo $sql . "<br>" . $e->getMessage();
}

$conn = null;
?>
PHP Insert Multiple Records Into
MySQL
❮ PreviousNext ❯

Insert Multiple Records Into MySQL Using


MySQLi and PDO
Multiple SQL statements must be executed with
the mysqli_multi_query() function.

The following examples add three new records to the "MyGuests" table:

Example (MySQLi Object-oriented)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = new mysqli($servername, $username, $password, $dbname);
// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

$sql = "INSERT INTO MyGuests (firstname, lastname, email)


VALUES ('John', 'Doe', 'john@example.com');";
$sql .= "INSERT INTO MyGuests (firstname, lastname, email)
VALUES ('Mary', 'Moe', 'mary@example.com');";
$sql .= "INSERT INTO MyGuests (firstname, lastname, email)
VALUES ('Julie', 'Dooley', 'julie@example.com')";

if ($conn->multi_query($sql) === TRUE) {


echo "New records created successfully";
} else {
echo "Error: " . $sql . "<br>" . $conn->error;
}

$conn->close();
?>

Note that each SQL statement must be separated by a semicolon.

Example (MySQLi Procedural)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = mysqli_connect($servername, $username, $password, $dbname);
// Check connection
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}

$sql = "INSERT INTO MyGuests (firstname, lastname, email)


VALUES ('John', 'Doe', 'john@example.com');";
$sql .= "INSERT INTO MyGuests (firstname, lastname, email)
VALUES ('Mary', 'Moe', 'mary@example.com');";
$sql .= "INSERT INTO MyGuests (firstname, lastname, email)
VALUES ('Julie', 'Dooley', 'julie@example.com')";

if (mysqli_multi_query($conn, $sql)) {
echo "New records created successfully";
} else {
echo "Error: " . $sql . "<br>" . mysqli_error($conn);
}

mysqli_close($conn);
?>
The PDO way is a little bit different:

Example (PDO)
<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDBPDO";

try {
$conn = newPDO("mysql:host=$servername;dbname=$dbname", $username,
$password);
// set the PDO error mode to exception
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

// begin the transaction


$conn->beginTransaction();
// our SQL statements
$conn->exec("INSERT INTO MyGuests (firstname, lastname, email)
VALUES ('John', 'Doe', 'john@example.com')");
$conn->exec("INSERT INTO MyGuests (firstname, lastname, email)
VALUES ('Mary', 'Moe', 'mary@example.com')");
$conn->exec("INSERT INTO MyGuests (firstname, lastname, email)
VALUES ('Julie', 'Dooley', 'julie@example.com')");

// commit the transaction


$conn->commit();
echo "New records created successfully";
}
catch(PDOException $e)
{
// roll back the transaction if something failed
$conn->rollback();
echo "Error: " . $e->getMessage();
}

$conn = null;
?>
PHP Prepared Statements
❮ PreviousNext ❯

Prepared statements are very useful against SQL injections.

Prepared Statements and Bound Parameters


A prepared statement is a feature used to execute the same (or similar) SQL
statements repeatedly with high efficiency.

Prepared statements basically work like this:

1. Prepare: An SQL statement template is created and sent to the database.


Certain values are left unspecified, called parameters (labeled "?").
Example: INSERT INTO MyGuests VALUES(?, ?, ?)
2. The database parses, compiles, and performs query optimization on the
SQL statement template, and stores the result without executing it
3. Execute: At a later time, the application binds the values to the
parameters, and the database executes the statement. The application
may execute the statement as many times as it wants with different
values

Compared to executing SQL statements directly, prepared statements have


three main advantages:

 Prepared statements reduce parsing time as the preparation on the query


is done only once (although the statement is executed multiple times)
 Bound parameters minimize bandwidth to the server as you need send
only the parameters each time, and not the whole query
 Prepared statements are very useful against SQL injections, because
parameter values, which are transmitted later using a different protocol,
need not be correctly escaped. If the original statement template is not
derived from external input, SQL injection cannot occur.

Prepared Statements in MySQLi


The following example uses prepared statements and bound parameters in
MySQLi:

Example (MySQLi with Prepared Statements)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = new mysqli($servername, $username, $password, $dbname);

// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

// prepare and bind


$stmt = $conn->prepare("INSERT INTO MyGuests (firstname, lastname,
email) VALUES (?, ?, ?)");
$stmt->bind_param("sss", $firstname, $lastname, $email);

// set parameters and execute


$firstname = "John";
$lastname = "Doe";
$email = "john@example.com";
$stmt->execute();

$firstname = "Mary";
$lastname = "Moe";
$email = "mary@example.com";
$stmt->execute();

$firstname = "Julie";
$lastname = "Dooley";
$email = "julie@example.com";
$stmt->execute();

echo "New records created successfully";

$stmt->close();
$conn->close();
?>
Code lines to explain from the example above:

"INSERT INTO MyGuests (firstname, lastname, email) VALUES (?, ?, ?)"

In our SQL, we insert a question mark (?) where we want to substitute in an


integer, string, double or blob value.

Then, have a look at the bind_param() function:

$stmt->bind_param("sss", $firstname, $lastname, $email);

This function binds the parameters to the SQL query and tells the database
what the parameters are. The "sss" argument lists the types of data that the
parameters are. The s character tells mysql that the parameter is a string.

The argument may be one of four types:

 i - integer
 d - double
 s - string
 b - BLOB

We must have one of these for each parameter.

By telling mysql what type of data to expect, we minimize the risk of SQL
injections.

Note: If we want to insert any data from external sources (like user input), it is
very important that the data is sanitized and validated.

Prepared Statements in PDO


The following example uses prepared statements and bound parameters in
PDO:

Example (PDO with Prepared Statements)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDBPDO";

try {
$conn = newPDO("mysql:host=$servername;dbname=$dbname", $username,
$password);
// set the PDO error mode to exception
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

// prepare sql and bind parameters


$stmt = $conn->prepare("INSERT INTO MyGuests (firstname, lastname,
email)
VALUES (:firstname, :lastname, :email)");
$stmt->bindParam(':firstname', $firstname);
$stmt->bindParam(':lastname', $lastname);
$stmt->bindParam(':email', $email);

// insert a row
$firstname = "John";
$lastname = "Doe";
$email = "john@example.com";
$stmt->execute();

// insert another row


$firstname = "Mary";
$lastname = "Moe";
$email = "mary@example.com";
$stmt->execute();

// insert another row


$firstname = "Julie";
$lastname = "Dooley";
$email = "julie@example.com";
$stmt->execute();

echo "New records created successfully";


}
catch(PDOException $e)
{
echo "Error: " . $e->getMessage();
}
$conn = null;
?>
PHP Select Data From MySQL
❮ PreviousNext ❯

Select Data From a MySQL Database


The SELECT statement is used to select data from one or more tables:

SELECT column_name(s) FROM table_name

or we can use the * character to select ALL columns from a table:

SELECT * FROM table_name

To learn more about SQL, please visit our SQL tutorial.

Select Data With MySQLi


The following example selects the id, firstname and lastname columns from the
MyGuests table and displays it on the page:

Example (MySQLi Object-oriented)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = new mysqli($servername, $username, $password, $dbname);
// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

$sql = "SELECT id, firstname, lastname FROM MyGuests";


$result = $conn->query($sql);
if ($result->num_rows > 0) {
// output data of each row
while($row = $result->fetch_assoc()) {
echo "id: " . $row["id"]. " - Name: " . $row["firstname"]. "
" . $row["lastname"]. "<br>";
}
} else {
echo "0 results";
}
$conn->close();
?>
Run example »

Code lines to explain from the example above:

First, we set up an SQL query that selects the id, firstname and lastname
columns from the MyGuests table. The next line of code runs the query and puts
the resulting data into a variable called $result.

Then, the function num_rows() checks if there are more than zero rows
returned.

If there are more than zero rows returned, the function fetch_assoc() puts all
the results into an associative array that we can loop through. The while() loop
loops through the result set and outputs the data from the id, firstname and
lastname columns.

The following example shows the same as the example above, in the MySQLi
procedural way:

Example (MySQLi Procedural)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = mysqli_connect($servername, $username, $password, $dbname);
// Check connection
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}
$sql = "SELECT id, firstname, lastname FROM MyGuests";
$result = mysqli_query($conn, $sql);

if (mysqli_num_rows($result) > 0) {
// output data of each row
while($row = mysqli_fetch_assoc($result)) {
echo "id: " . $row["id"]. " - Name: " . $row["firstname"]. "
" . $row["lastname"]. "<br>";
}
} else {
echo "0 results";
}

mysqli_close($conn);
?>
Run example »

You can also put the result in an HTML table:

Example (MySQLi Object-oriented)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = new mysqli($servername, $username, $password, $dbname);
// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

$sql = "SELECT id, firstname, lastname FROM MyGuests";


$result = $conn->query($sql);

if ($result->num_rows > 0) {
echo "<table><tr><th>ID</th><th>Name</th></tr>";
// output data of each row
while($row = $result->fetch_assoc()) {
echo "<tr><td>".$row["id"]."</td><td>".$row["firstname"]."
".$row["lastname"]."</td></tr>";
}
echo "</table>";
} else {
echo "0 results";
}
$conn->close();
?>
Run example »

Select Data With PDO (+ Prepared Statements)


The following example uses prepared statements.

It selects the id, firstname and lastname columns from the MyGuests table and
displays it in an HTML table:

Example (PDO)
<?php
echo "<table style='border: solid 1px black;'>";
echo "<tr><th>Id</th><th>Firstname</th><th>Lastname</th></tr>";

class TableRows extends RecursiveIteratorIterator {


function __construct($it) {
parent::__construct($it, self::LEAVES_ONLY);
}

function current() {
return "<td style='width:150px;border:1px solid black;'>" .
parent::current(). "</td>";
}

function beginChildren() {
echo "<tr>";
}

function endChildren() {
echo "</tr>" . "\n";
}
}

$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDBPDO";

try {
$conn = newPDO("mysql:host=$servername;dbname=$dbname", $username,
$password);
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$stmt = $conn->prepare("SELECT id, firstname, lastname FROM
MyGuests");
$stmt->execute();

// set the resulting array to associative


$result = $stmt->setFetchMode(PDO::FETCH_ASSOC);
foreach(new TableRows(newRecursiveArrayIterator($stmt-
>fetchAll())) as $k=>$v) {
echo $v;
}
}
catch(PDOException $e) {
echo "Error: " . $e->getMessage();
}
$conn = null;
echo "</table>";
?>
PHP Delete Data From MySQL
❮ PreviousNext ❯

Delete Data From a MySQL Table Using


MySQLi and PDO
The DELETE statement is used to delete records from a table:

DELETE FROM table_name


WHERE some_column = some_value

Notice the WHERE clause in the DELETE syntax: The WHERE clause
specifies which record or records that should be deleted. If you omit the WHERE
clause, all records will be deleted!

To learn more about SQL, please visit our SQL tutorial.

Let's look at the "MyGuests" table:

id firstname lastname email reg_date

1 John Doe john@example.com 2014-10-22 14:26:15

2 Mary Moe mary@example.com 2014-10-23 10:22:30

3 Julie Dooley julie@example.com 2014-10-26 10:48:23

The following examples delete the record with id=3 in the "MyGuests" table:
Example (MySQLi Object-oriented)
<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = new mysqli($servername, $username, $password, $dbname);
// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

// sql to delete a record


$sql = "DELETE FROM MyGuests WHERE id=3";

if ($conn->query($sql) === TRUE) {


echo "Record deleted successfully";
} else {
echo "Error deleting record: " . $conn->error;
}

$conn->close();
?>

Example (MySQLi Procedural)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = mysqli_connect($servername, $username, $password, $dbname);
// Check connection
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}

// sql to delete a record


$sql = "DELETE FROM MyGuests WHERE id=3";

if (mysqli_query($conn, $sql)) {
echo "Record deleted successfully";
} else {
echo "Error deleting record: " . mysqli_error($conn);
}

mysqli_close($conn);
?>

Example (PDO)
<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDBPDO";

try {
$conn = newPDO("mysql:host=$servername;dbname=$dbname", $username,
$password);
// set the PDO error mode to exception
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

// sql to delete a record


$sql = "DELETE FROM MyGuests WHERE id=3";

// use exec() because no results are returned


$conn->exec($sql);
echo "Record deleted successfully";
}
catch(PDOException $e)
{
echo $sql . "<br>" . $e->getMessage();
}

$conn = null;
?>

After the record is deleted, the table will look like this:
id firstname lastname email reg_date

1 John Doe john@example.com 2014-10-22 14:26:15

2 Mary Moe mary@example.com 2014-10-23 10:22:30


PHP Update Data in MySQL
❮ PreviousNext ❯

Update Data In a MySQL Table Using MySQLi


and PDO
The UPDATE statement is used to update existing records in a table:

UPDATE table_name
SET column1=value, column2=value2,...
WHERE some_column=some_value

Notice the WHERE clause in the UPDATE syntax: The WHERE clause
specifies which record or records that should be updated. If you omit the
WHERE clause, all records will be updated!

To learn more about SQL, please visit our SQL tutorial.

Let's look at the "MyGuests" table:

id firstname lastname email reg_date

1 John Doe john@example.com 2014-10-22 14:26:15

2 Mary Moe mary@example.com 2014-10-23 10:22:30

The following examples update the record with id=2 in the "MyGuests" table:

Example (MySQLi Object-oriented)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = new mysqli($servername, $username, $password, $dbname);
// Check connection
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}

$sql = "UPDATE MyGuests SET lastname='Doe' WHERE id=2";

if ($conn->query($sql) === TRUE) {


echo "Record updated successfully";
} else {
echo "Error updating record: " . $conn->error;
}

$conn->close();
?>

Example (MySQLi Procedural)


<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDB";

// Create connection
$conn = mysqli_connect($servername, $username, $password, $dbname);
// Check connection
if (!$conn) {
die("Connection failed: " . mysqli_connect_error());
}

$sql = "UPDATE MyGuests SET lastname='Doe' WHERE id=2";

if (mysqli_query($conn, $sql)) {
echo "Record updated successfully";
} else {
echo "Error updating record: " . mysqli_error($conn);
}

mysqli_close($conn);
?>

Example (PDO)
<?php
$servername = "localhost";
$username = "username";
$password = "password";
$dbname = "myDBPDO";

try {
$conn = newPDO("mysql:host=$servername;dbname=$dbname", $username,
$password);
// set the PDO error mode to exception
$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

$sql = "UPDATE MyGuests SET lastname='Doe' WHERE id=2";

// Prepare statement
$stmt = $conn->prepare($sql);

// execute the query


$stmt->execute();

// echo a message to say the UPDATE succeeded


echo $stmt->rowCount() . " records UPDATED successfully";
}
catch(PDOException $e)
{
echo $sql . "<br>" . $e->getMessage();
}

$conn = null;
?>

After the record is updated, the table will look like this:
id firstname lastname email reg_date

1 John Doe john@example.com 2014-10-22 14:26:15

2 Mary Doe mary@example.com 2014-10-23 10:22:30


PHP Limit Data Selections From MySQL
❮ PreviousNext ❯

Limit Data Selections From a MySQL Database


MySQL provides a LIMIT clause that is used to specify the number of records to
return.

The LIMIT clause makes it easy to code multi page results or pagination with
SQL, and is very useful on large tables. Returning a large number of records can
impact on performance.

Assume we wish to select all records from 1 - 30 (inclusive) from a table called
"Orders". The SQL query would then look like this:

$sql = "SELECT * FROM Orders LIMIT 30";

When the SQL query above is run, it will return the first 30 records.

What if we want to select records 16 - 25 (inclusive)?

Mysql also provides a way to handle this: by using OFFSET.

The SQL query below says "return only 10 records, start on record 16 (OFFSET
15)":

$sql = "SELECT * FROM Orders LIMIT 10 OFFSET 15";

You could also use a shorter syntax to achieve the same result:

$sql = "SELECT * FROM Orders LIMIT 15, 10";

Notice that the numbers are reversed when you use a comma.
PHP XML Parsers
❮ PreviousNext ❯

What is XML?
The XML language is a way to structure data for sharing across websites.

Several web technologies like RSS Feeds and Podcasts are written in XML.

XML is easy to create. It looks a lot like HTML, except that you make up your
own tags.

If you want to learn more about XML, please visit our XML tutorial.

What is an XML Parser?


To read and update, create and manipulate an XML document, you will need an
XML parser.

In PHP there are two major types of XML parsers:

 Tree-Based Parsers
 Event-Based Parsers

Tree-Based Parsers
Tree-based parsers holds the entire document in Memory and transforms the
XML document into a Tree structure. It analyzes the whole document, and
provides access to the Tree elements (DOM).

This type of parser is a better option for smaller XML documents, but not for
large XML document as it causes major performance issues.

Example of tree-based parsers:


 SimpleXML
 DOM

Event-Based Parsers
Event-based parsers do not hold the entire document in Memory, instead, they
read in one node at a time and allow you to interact with in real time. Once you
move onto the next node, the old one is thrown away.

This type of parser is well suited for large XML documents. It parses faster and
consumes less memory.

Example of event-based parsers:

 XMLReader
 XML Expat Parser
PHP SimpleXML Parser
❮ PreviousNext ❯

SimpleXML is a PHP extension that allows us to easily manipulate and get


XML data.

The SimpleXML Parser


SimpleXML is a tree-based parser.

SimpleXML provides an easy way of getting an element's name, attributes and


textual content if you know the XML document's structure or layout.

SimpleXML turns an XML document into a data structure you can iterate
through like a collection of arrays and objects.

Compared to DOM or the Expat parser, SimpleXML takes a fewer lines of code
to read text data from an element.

Installation
As of PHP 5, the SimpleXML functions are part of the PHP core. No installation is
required to use these functions.

PHP SimpleXML - Read From String


The PHP simplexml_load_string() function is used to read XML data from a
string.

Assume we have a variable that contains XML data, like this:


$myXMLData =
"<?xml version='1.0' encoding='UTF-8'?>
<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Don't forget me this weekend!</body>
</note>";

The example below shows how to use the simplexml_load_string() function


to read XML data from a string:

Example
<?php
$myXMLData =
"<?xml version='1.0' encoding='UTF-8'?>
<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Don't forget me this weekend!</body>
</note>";

$xml=simplexml_load_string($myXMLData) or die("Error: Cannot create


object");
print_r($xml);
?>
Run example »

The output of the code above will be:

SimpleXMLElement Object ( [to] => Tove [from] => Jani [heading] =>
Reminder [body] => Don't forget me this weekend! )

Error Handling Tip: Use the libxml functionality to retrieve all XML errors when
loading the document and then iterate over the errors. The following example
tries to load a broken XML string:

Example
<?php
libxml_use_internal_errors(true);
$myXMLData =
"<?xml version='1.0' encoding='UTF-8'?>
<document>
<user>John Doe</wronguser>
<email>john@example.com</wrongemail>
</document>";

$xml = simplexml_load_string($myXMLData);
if ($xml === false) {
echo "Failed loading XML: ";
foreach(libxml_get_errors() as $error) {
echo "<br>", $error->message;
}
} else {
print_r($xml);
}
?>
Run example »

The output of the code above will be:

Failed loading XML:


Opening and ending tag mismatch: user line 3 and wronguser
Opening and ending tag mismatch: email line 4 and wrongemail

PHP SimpleXML - Read From File


The PHP simplexml_load_file() function is used to read XML data from a file.

Assume we have an XML file called "note.xml", that looks like this:

<?xml version="1.0" encoding="UTF-8"?>


<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Don't forget me this weekend!</body>
</note>

The example below shows how to use the simplexml_load_file() function to


read XML data from a file:
Example
<?php
$xml=simplexml_load_file("note.xml") or die("Error: Cannot create
object");
print_r($xml);
?>
Run example »

The output of the code above will be:

SimpleXMLElement Object ( [to] => Tove [from] => Jani [heading] =>
Reminder [body] => Don't forget me this weekend! )

Tip: The next chapter shows how to get/retrieve node values from an XML file
with SimpleXML!

More PHP SimpleXML


For more information about the PHP SimpleXML functions, visit ourPHP
SimpleXML Reference.
PHP SimpleXML - Get Node/Attribute
Values
❮ PreviousNext ❯

SimpleXML is a PHP extension that allows us to easily manipulate and get


XML data.

PHP SimpleXML - Get Node Values


Get the node values from the "note.xml" file:

Example
<?php
$xml=simplexml_load_file("note.xml") or die("Error: Cannot create
object");
echo $xml->to . "<br>";
echo $xml->from . "<br>";
echo $xml->heading . "<br>";
echo $xml->body;
?>
Run example »

The output of the code above will be:

Tove
Jani
Reminder
Don't forget me this weekend!

Another XML File


Assume we have an XML file called "books.xml", that looks like this:
<?xml version="1.0" encoding="utf-8"?>
<bookstore>
<book category="COOKING">
<title lang="en">Everyday Italian</title>
<author>Giada De Laurentiis</author>
<year>2005</year>
<price>30.00</price>
</book>
<book category="CHILDREN">
<title lang="en">Harry Potter</title>
<author>J K. Rowling</author>
<year>2005</year>
<price>29.99</price>
</book>
<book category="WEB">
<title lang="en-us">XQuery Kick Start</title>
<author>James McGovern</author>
<year>2003</year>
<price>49.99</price>
</book>
<book category="WEB">
<title lang="en-us">Learning XML</title>
<author>Erik T. Ray</author>
<year>2003</year>
<price>39.95</price>
</book>
</bookstore>

PHP SimpleXML - Get Node Values of Specific


Elements
The following example gets the node value of the <title> element in the first
and second <book> elements in the "books.xml" file:

Example
<?php
$xml=simplexml_load_file("books.xml") or die("Error: Cannot create
object");
echo $xml->book[0]->title . "<br>";
echo $xml->book[1]->title;
?>
Run example »

The output of the code above will be:

Everyday Italian
Harry Potter

PHP SimpleXML - Get Node Values - Loop


The following example loops through all the <book> elements in the
"books.xml" file, and gets the node values of the <title>, <author>, <year>,
and <price> elements:

Example
<?php
$xml=simplexml_load_file("books.xml") or die("Error: Cannot create
object");
foreach($xml->children() as $books) {
echo $books->title . ", ";
echo $books->author . ", ";
echo $books->year . ", ";
echo $books->price . "<br>";
}
?>
Run example »

The output of the code above will be:

Everyday Italian, Giada De Laurentiis, 2005, 30.00


Harry Potter, J K. Rowling, 2005, 29.99
XQuery Kick Start, James McGovern, 2003, 49.99
Learning XML, Erik T. Ray, 2003, 39.95

PHP SimpleXML - Get Attribute Values


The following example gets the attribute value of the "category" attribute of the
first <book> element and the attribute value of the "lang" attribute of the
<title> element in the second <book> element:

Example
<?php
$xml=simplexml_load_file("books.xml") or die("Error: Cannot create
object");
echo $xml->book[0]['category'] . "<br>";
echo $xml->book[1]->title['lang'];
?>
Run example »

The output of the code above will be:

COOKING
en

PHP SimpleXML - Get Attribute Values - Loop


The following example gets the attribute values of the <title> elements in the
"books.xml" file:

Example
<?php
$xml=simplexml_load_file("books.xml") or die("Error: Cannot create
object");
foreach($xml->children() as $books) {
echo $books->title['lang'];
echo "<br>";
}
?>
Run example »

The output of the code above will be:

en
en
en-us
en-us
More PHP SimpleXML
For more information about the PHP SimpleXML functions, visit ourPHP
SimpleXML Reference.
PHP XML Expat Parser
❮ PreviousNext ❯

The built-in XML Expat Parser makes it possible to process XML documents
in PHP.

The XML Expat Parser


The Expat parser is an event-based parser.

Look at the following XML fraction:

<from>Jani</from>

An event-based parser reports the XML above as a series of three events:

 Start element: from


 Start CDATA section, value: Jani
 Close element: from

The XML Expat Parser functions are part of the PHP core. There is no installation
needed to use these functions.

The XML File


The XML file "note.xml" will be used in the example below:

<?xml version="1.0" encoding="UTF-8"?>


<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Don't forget me this weekend!</body>
</note>
Initializing the XML Expat Parser
We want to initialize the XML Expat Parser in PHP, define some handlers for
different XML events, and then parse the XML file.

Example
<?php
// Initialize the XML parser
$parser=xml_parser_create();

// Function to use at the start of an element


function start($parser,$element_name,$element_attrs) {
switch($element_name) {
case "NOTE":
echo "-- Note --<br>";
break;
case "TO":
echo "To: ";
break;
case "FROM":
echo "From: ";
break;
case "HEADING":
echo "Heading: ";
break;
case "BODY":
echo "Message: ";
}
}

// Function to use at the end of an element


function stop($parser,$element_name) {
echo "<br>";
}

// Function to use when finding character data


function char($parser,$data) {
echo $data;
}
// Specify element handler
xml_set_element_handler($parser,"start","stop");

// Specify data handler


xml_set_character_data_handler($parser,"char");

// Open XML file


$fp=fopen("note.xml","r");

// Read data
while ($data=fread($fp,4096)) {
xml_parse($parser,$data,feof($fp)) or
die (sprintf("XML Error: %s at line %d",
xml_error_string(xml_get_error_code($parser)),
xml_get_current_line_number($parser)));
}

// Free the XML parser


xml_parser_free($parser);
?>
Run example »

Example explained:

1. Initialize the XML parser with the xml_parser_create()function


2. Create functions to use with the different event handlers
3. Add the xml_set_element_handler() function to specify which function
will be executed when the parser encounters the opening and closing tags
4. Add the xml_set_character_data_handler() function to specify which
function will execute when the parser encounters character data
5. Parse the file "note.xml" with the xml_parse() function
6. In case of an error, add xml_error_string() function to convert an XML
error to a textual description
7. Call the xml_parser_free() function to release the memory allocated
with the xml_parser_create() function

More PHP XML Expat Parser


For more information about the PHP Expat functions, visit our PHP XML Parser
Reference.
PHP XML DOM Parser
❮ PreviousNext ❯

The built-in DOM parser makes it possible to process XML documents in PHP.

The XML DOM Parser


The DOM parser is a tree-based parser.

Look at the following XML document fraction:

<?xml version="1.0" encoding="UTF-8"?>


<from>Jani</from>

The DOM sees the XML above as a tree structure:

 Level 1: XML Document


 Level 2: Root element: <from>
 Level 3: Text element: "Jani"

Installation
The DOM parser functions are part of the PHP core. There is no installation
needed to use these functions.

The XML File


The XML file below ("note.xml") will be used in our example:

<?xml version="1.0" encoding="UTF-8"?>


<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Don't forget me this weekend!</body>
</note>

Load and Output XML


We want to initialize the XML parser, load the xml, and output it:

<?php
$xmlDoc = new DOMDocument();
$xmlDoc->load("note.xml");

print $xmlDoc->saveXML();
?>

The output of the code above will be:

Tove Jani Reminder Don't forget me this weekend!

If you select "View source" in the browser window, you will see the following
HTML:

<?xml version="1.0" encoding="UTF-8"?>


<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Don't forget me this weekend!</body>
</note>

The example above creates a DOMDocument-Object and loads the XML from
"note.xml" into it.

Then the saveXML() function puts the internal XML document into a string, so
we can output it.
Looping through XML
We want to initialize the XML parser, load the XML, and loop through all
elements of the <note> element:

<?php
$xmlDoc = new DOMDocument();
$xmlDoc->load("note.xml");

$x = $xmlDoc->documentElement;
foreach ($x->childNodes AS $item) {
print $item->nodeName . " = " . $item->nodeValue . "<br>";
}
?>

The output of the code above will be:

#text =
to = Tove
#text =
from = Jani
#text =
heading = Reminder
#text =
body = Don't forget me this weekend!
#text =

In the example above you see that there are empty text nodes between each
element.

When XML generates, it often contains white-spaces between the nodes. The
XML DOM parser treats these as ordinary elements, and if you are not aware of
them, they sometimes cause problems.

If you want to learn more about the XML DOM, please visit ourXML tutorial.
AJAX Introduction
❮ PreviousNext ❯

AJAX is about updating parts of a web page, without reloading the whole
page.

What is AJAX?
AJAX = Asynchronous JavaScript and XML.

AJAX is a technique for creating fast and dynamic web pages.

AJAX allows web pages to be updated asynchronously by exchanging small


amounts of data with the server behind the scenes. This means that it is
possible to update parts of a web page, without reloading the whole page.

Classic web pages, (which do not use AJAX) must reload the entire page if the
content should change.

Examples of applications using AJAX: Google Maps, Gmail, Youtube, and


Facebook tabs.

How AJAX Works


AJAX is Based on Internet Standards
AJAX is based on internet standards, and uses a combination of:

 XMLHttpRequest object (to exchange data asynchronously with a server)


 JavaScript/DOM (to display/interact with the information)
 CSS (to style the data)
 XML (often used as the format for transferring data)

AJAX applications are browser- and platform-independent!

Google Suggest
AJAX was made popular in 2005 by Google, with Google Suggest.

Google Suggest is using AJAX to create a very dynamic web interface: When
you start typing in Google's search box, a JavaScript sends the letters off to a
server and the server returns a list of suggestions.
Start Using AJAX Today
In our PHP tutorial, we will demonstrate how AJAX can update parts of a web
page, without reloading the whole page. The server script will be written in PHP.

If you want to learn more about AJAX, visit our AJAX tutorial
PHP - AJAX and PHP
❮ PreviousNext ❯

AJAX is used to create more interactive applications.

AJAX PHP Example


The following example will demonstrate how a web page can communicate with
a web server while a user type characters in an input field:

Example
Start typing a name in the input field below:

First name:

Suggestions:

Example Explained
In the example above, when a user types a character in the input field, a
function called "showHint()" is executed.

The function is triggered by the onkeyup event.

Here is the HTML code:

Example
<html>
<head>
<script>
function showHint(str) {
if (str.length == 0) {
document.getElementById("txtHint").innerHTML = "";
return;
} else {
var xmlhttp = new XMLHttpRequest();
xmlhttp.onreadystatechange = function() {
if (this.readyState == 4 && this.status == 200) {

document.getElementById("txtHint").innerHTML = this.responseText;
}
};
xmlhttp.open("GET", "gethint.php?q=" + str, true);
xmlhttp.send();
}
}
</script>
</head>
<body>

<p><b>Start typing a name in the input field below:</b></p>


<form>
First name: <input type="text"onkeyup="showHint(this.value)">
</form>
<p>Suggestions: <span id="txtHint"></span></p>
</body>
</html>
Run example »

Code explanation:

First, check if the input field is empty (str.length == 0). If it is, clear the
content of the txtHint placeholder and exit the function.

However, if the input field is not empty, do the following:

 Create an XMLHttpRequest object


 Create the function to be executed when the server response is ready
 Send the request off to a PHP file (gethint.php) on the server
 Notice that q parameter is added to the url (gethint.php?q="+str)
 And the str variable holds the content of the input field
The PHP File - "gethint.php"
The PHP file checks an array of names, and returns the corresponding name(s)
to the browser:

<?php
// Array with names
$a[] = "Anna";
$a[] = "Brittany";
$a[] = "Cinderella";
$a[] = "Diana";
$a[] = "Eva";
$a[] = "Fiona";
$a[] = "Gunda";
$a[] = "Hege";
$a[] = "Inga";
$a[] = "Johanna";
$a[] = "Kitty";
$a[] = "Linda";
$a[] = "Nina";
$a[] = "Ophelia";
$a[] = "Petunia";
$a[] = "Amanda";
$a[] = "Raquel";
$a[] = "Cindy";
$a[] = "Doris";
$a[] = "Eve";
$a[] = "Evita";
$a[] = "Sunniva";
$a[] = "Tove";
$a[] = "Unni";
$a[] = "Violet";
$a[] = "Liza";
$a[] = "Elizabeth";
$a[] = "Ellen";
$a[] = "Wenche";
$a[] = "Vicky";

// get the q parameter from URL


$q = $_REQUEST["q"];

$hint = "";

// lookup all hints from array if $q is different from ""


if ($q !== "") {
$q = strtolower($q);
$len=strlen($q);
foreach($a as $name) {
if (stristr($q, substr($name, 0, $len))) {
if ($hint === "") {
$hint = $name;
} else {
$hint .= ", $name";
}
}
}
}

// Output "no suggestion" if no hint was found or output correct


values
echo $hint === "" ? "no suggestion" : $hint;
?>
PHP - AJAX and MySQL
❮ PreviousNext ❯

AJAX can be used for interactive communication with a database.

AJAX Database Example


The following example will demonstrate how a web page can fetch information
from a database with AJAX:

Example

Person info will be listed here...

Example Explained - The MySQL Database


The database table we use in the example above looks like this:

id FirstName LastName Age Hometown Job

1 Peter Griffin 41 Quahog Brewery

2 Lois Griffin 40 Newport Piano Teacher


3 Joseph Swanson 39 Quahog Police Officer

4 Glenn Quagmire 41 Quahog Pilot

Example Explained
In the example above, when a user selects a person in the dropdown list above,
a function called "showUser()" is executed.

The function is triggered by the onchange event.

Here is the HTML code:

Example
<html>
<head>
<script>
function showUser(str) {
if (str == "") {
document.getElementById("txtHint").innerHTML = "";
return;
} else {
if (window.XMLHttpRequest) {
// code for IE7+, Firefox, Chrome, Opera, Safari
xmlhttp = new XMLHttpRequest();
} else {
// code for IE6, IE5
xmlhttp = newActiveXObject("Microsoft.XMLHTTP");
}
xmlhttp.onreadystatechange = function() {
if (this.readyState == 4 && this.status == 200) {

document.getElementById("txtHint").innerHTML = this.responseText;
}
};
xmlhttp.open("GET","getuser.php?q="+str,true);
xmlhttp.send();
}
}
</script>
</head>
<body>

<form>
<select name="users" onchange="showUser(this.value)">
<option value="">Select a person:</option>
<option value="1">Peter Griffin</option>
<option value="2">Lois Griffin</option>
<option value="3">Joseph Swanson</option>
<option value="4">Glenn Quagmire</option>
</select>
</form>
<br>
<div id="txtHint"><b>Person info will be listed here...</b></div>

</body>
</html>
Run example »

Code explanation:

First, check if person is selected. If no person is selected (str == ""), clear the
content of txtHint and exit the function. If a person is selected, do the following:

 Create an XMLHttpRequest object


 Create the function to be executed when the server response is ready
 Send the request off to a file on the server
 Notice that a parameter (q) is added to the URL (with the content of the
dropdown list)

The PHP File


The page on the server called by the JavaScript above is a PHP file called
"getuser.php".
The source code in "getuser.php" runs a query against a MySQL database, and
returns the result in an HTML table:

<!DOCTYPE html>
<html>
<head>
<style>
table {
width: 100%;
border-collapse: collapse;
}

table, td, th {
border: 1px solid black;
padding: 5px;
}

th {text-align: left;}
</style>
</head>
<body>

<?php
$q = intval($_GET['q']);

$con = mysqli_connect('localhost','peter','abc123','my_db');
if (!$con) {
die('Could not connect: ' . mysqli_error($con));
}

mysqli_select_db($con,"ajax_demo");
$sql="SELECT * FROM user WHERE id = '".$q."'";
$result = mysqli_query($con,$sql);

echo "<table>
<tr>
<th>Firstname</th>
<th>Lastname</th>
<th>Age</th>
<th>Hometown</th>
<th>Job</th>
</tr>";
while($row = mysqli_fetch_array($result)) {
echo "<tr>";
echo "<td>" . $row['FirstName'] . "</td>";
echo "<td>" . $row['LastName'] . "</td>";
echo "<td>" . $row['Age'] . "</td>";
echo "<td>" . $row['Hometown'] . "</td>";
echo "<td>" . $row['Job'] . "</td>";
echo "</tr>";
}
echo "</table>";
mysqli_close($con);
?>
</body>
</html>

Explanation: When the query is sent from the JavaScript to the PHP file, the
following happens:

1. PHP opens a connection to a MySQL server


2. The correct person is found
3. An HTML table is created, filled with data, and sent back to the "txtHint"
placeholder
PHP Example - AJAX and XML
❮ PreviousNext ❯

AJAX can be used for interactive communication with an XML file.

AJAX XML Example


The following example will demonstrate how a web page can fetch information
from an XML file with AJAX:

Example

CD info will be listed here...

Example Explained - The HTML Page


When a user selects a CD in the dropdown list above, a function called
"showCD()" is executed. The function is triggered by the "onchange" event:

<html>
<head>
<script>
function showCD(str) {
if (str=="") {
document.getElementById("txtHint").innerHTML="";
return;
}
if (window.XMLHttpRequest) {
// code for IE7+, Firefox, Chrome, Opera, Safari
xmlhttp=new XMLHttpRequest();
} else { // code for IE6, IE5
xmlhttp=new ActiveXObject("Microsoft.XMLHTTP");
}
xmlhttp.onreadystatechange=function() {
if (this.readyState==4 && this.status==200) {
document.getElementById("txtHint").innerHTML=this.responseText;
}
}
xmlhttp.open("GET","getcd.php?q="+str,true);
xmlhttp.send();
}
</script>
</head>
<body>

<form>
Select a CD:
<select name="cds" onchange="showCD(this.value)">
<option value="">Select a CD:</option>
<option value="Bob Dylan">Bob Dylan</option>
<option value="Bee Gees">Bee Gees</option>
<option value="Cat Stevens">Cat Stevens</option>
</select>
</form>
<div id="txtHint"><b>CD info will be listed here...</b></div>

</body>
</html>

The showCD() function does the following:

 Check if a CD is selected
 Create an XMLHttpRequest object
 Create the function to be executed when the server response is ready
 Send the request off to a file on the server
 Notice that a parameter (q) is added to the URL (with the content of the
dropdown list)

The PHP File


The page on the server called by the JavaScript above is a PHP file called
"getcd.php".
The PHP script loads an XML document, "cd_catalog.xml", runs a query against
the XML file, and returns the result as HTML:

<?php
$q=$_GET["q"];

$xmlDoc = new DOMDocument();


$xmlDoc->load("cd_catalog.xml");

$x=$xmlDoc->getElementsByTagName('ARTIST');

for ($i=0; $i<=$x->length-1; $i++) {


//Process only element nodes
if ($x->item($i)->nodeType==1) {
if ($x->item($i)->childNodes->item(0)->nodeValue == $q) {
$y=($x->item($i)->parentNode);
}
}
}

$cd=($y->childNodes);

for ($i=0;$i<$cd->length;$i++) {
//Process only element nodes
if ($cd->item($i)->nodeType==1) {
echo("<b>" . $cd->item($i)->nodeName . ":</b> ");
echo($cd->item($i)->childNodes->item(0)->nodeValue);
echo("<br>");
}
}
?>

When the CD query is sent from the JavaScript to the PHP page, the following
happens:

1. PHP creates an XML DOM object


2. Find all <artist> elements that matches the name sent from the
JavaScript
3. Output the album information (send to the "txtHint" placeholder)
PHP Example - AJAX Live Search
❮ PreviousNext ❯

AJAX can be used to create more user-friendly and interactive searches.

AJAX Live Search


The following example will demonstrate a live search, where you get search
results while you type.

Live search has many benefits compared to traditional searching:

 Results are shown as you type


 Results narrow as you continue typing
 If results become too narrow, remove characters to see a broader result

Search for a W3Schools page in the input field below:

The results in the example above are found in an XML file (links.xml). To make
this example small and simple, only six results are available.

Example Explained - The HTML Page


When a user types a character in the input field above, the function
"showResult()" is executed. The function is triggered by the "onkeyup" event:

<html>
<head>
<script>
function showResult(str) {
if (str.length==0) {
document.getElementById("livesearch").innerHTML="";
document.getElementById("livesearch").style.border="0px";
return;
}
if (window.XMLHttpRequest) {
// code for IE7+, Firefox, Chrome, Opera, Safari
xmlhttp=new XMLHttpRequest();
} else { // code for IE6, IE5
xmlhttp=new ActiveXObject("Microsoft.XMLHTTP");
}
xmlhttp.onreadystatechange=function() {
if (this.readyState==4 && this.status==200) {
document.getElementById("livesearch").innerHTML=this.responseText
;
document.getElementById("livesearch").style.border="1px solid
#A5ACB2";
}
}
xmlhttp.open("GET","livesearch.php?q="+str,true);
xmlhttp.send();
}
</script>
</head>
<body>

<form>
<input type="text" size="30"onkeyup="showResult(this.value)">
<div id="livesearch"></div>
</form>

</body>
</html>

Source code explanation:

If the input field is empty (str.length==0), the function clears the content of the
livesearch placeholder and exits the function.

If the input field is not empty, the showResult() function executes the following:

 Create an XMLHttpRequest object


 Create the function to be executed when the server response is ready
 Send the request off to a file on the server
 Notice that a parameter (q) is added to the URL (with the content of the
input field)
The PHP File
The page on the server called by the JavaScript above is a PHP file called
"livesearch.php".

The source code in "livesearch.php" searches an XML file for titles matching the
search string and returns the result:

<?php
$xmlDoc=new DOMDocument();
$xmlDoc->load("links.xml");

$x=$xmlDoc->getElementsByTagName('link');

//get the q parameter from URL


$q=$_GET["q"];

//lookup all links from the xml file if length of q>0


if (strlen($q)>0) {
$hint="";
for($i=0; $i<($x->length); $i++) {
$y=$x->item($i)->getElementsByTagName('title');
$z=$x->item($i)->getElementsByTagName('url');
if ($y->item(0)->nodeType==1) {
//find a link matching the search text
if (stristr($y->item(0)->childNodes->item(0)->nodeValue,$q)) {
if ($hint=="") {
$hint="<a href='" .
$z->item(0)->childNodes->item(0)->nodeValue .
"' target='_blank'>" .
$y->item(0)->childNodes->item(0)->nodeValue . "</a>";
} else {
$hint=$hint . "<br /><a href='" .
$z->item(0)->childNodes->item(0)->nodeValue .
"' target='_blank'>" .
$y->item(0)->childNodes->item(0)->nodeValue . "</a>";
}
}
}
}
}
// Set output to "no suggestion" if no hint was found
// or to the correct values
if ($hint=="") {
$response="no suggestion";
} else {
$response=$hint;
}

//output the response


echo $response;
?>

If there is any text sent from the JavaScript (strlen($q) > 0), the following
happens:

 Load an XML file into a new XML DOM object


 Loop through all <title> elements to find matches from the text sent from
the JavaScript
 Sets the correct url and title in the "$response" variable. If more than one
match is found, all matches are added to the variable
 If no matches are found, the $response variable is set to "no suggestion"
PHP Example - AJAX RSS Reader
❮ PreviousNext ❯

An RSS Reader is used to read RSS Feeds.

AJAX RSS Reader


The following example will demonstrate an RSS reader, where the RSS-feed is
loaded into a webpage without reloading:

RSS-feed will be listed here...

Example Explained - The HTML Page


When a user selects an RSS-feed in the dropdown list above, a function called
"showRSS()" is executed. The function is triggered by the "onchange" event:

<html>
<head>
<script>
function showRSS(str) {
if (str.length==0) {
document.getElementById("rssOutput").innerHTML="";
return;
}
if (window.XMLHttpRequest) {
// code for IE7+, Firefox, Chrome, Opera, Safari
xmlhttp=new XMLHttpRequest();
} else { // code for IE6, IE5
xmlhttp=new ActiveXObject("Microsoft.XMLHTTP");
}
xmlhttp.onreadystatechange=function() {
if (this.readyState==4 && this.status==200) {
document.getElementById("rssOutput").innerHTML=this.responseText;
}
}
xmlhttp.open("GET","getrss.php?q="+str,true);
xmlhttp.send();
}
</script>
</head>
<body>

<form>
<select onchange="showRSS(this.value)">
<option value="">Select an RSS-feed:</option>
<option value="Google">Google News</option>
<option value="ZDN">ZDNet News</option>
</select>
</form>
<br>
<div id="rssOutput">RSS-feed will be listed here...</div>
</body>
</html>

The showRSS() function does the following:

 Check if an RSS-feed is selected


 Create an XMLHttpRequest object
 Create the function to be executed when the server response is ready
 Send the request off to a file on the server
 Notice that a parameter (q) is added to the URL (with the content of the
dropdown list)

The PHP File


The page on the server called by the JavaScript above is a PHP file called
"getrss.php":

<?php
//get the q parameter from URL
$q=$_GET["q"];
//find out which feed was selected
if($q=="Google") {
$xml=("http://news.google.com/news?ned=us&topic=h&output=rss");
} elseif($q=="ZDN") {
$xml=("https://www.zdnet.com/news/rss.xml");
}

$xmlDoc = new DOMDocument();


$xmlDoc->load($xml);

//get elements from "<channel>"


$channel=$xmlDoc->getElementsByTagName('channel')->item(0);
$channel_title = $channel->getElementsByTagName('title')
->item(0)->childNodes->item(0)->nodeValue;
$channel_link = $channel->getElementsByTagName('link')
->item(0)->childNodes->item(0)->nodeValue;
$channel_desc = $channel->getElementsByTagName('description')
->item(0)->childNodes->item(0)->nodeValue;

//output elements from "<channel>"


echo("<p><a href='" . $channel_link
. "'>" . $channel_title . "</a>");
echo("<br>");
echo($channel_desc . "</p>");

//get and output "<item>" elements


$x=$xmlDoc->getElementsByTagName('item');
for ($i=0; $i<=2; $i++) {
$item_title=$x->item($i)->getElementsByTagName('title')
->item(0)->childNodes->item(0)->nodeValue;
$item_link=$x->item($i)->getElementsByTagName('link')
->item(0)->childNodes->item(0)->nodeValue;
$item_desc=$x->item($i)->getElementsByTagName('description')
->item(0)->childNodes->item(0)->nodeValue;
echo ("<p><a href='" . $item_link
. "'>" . $item_title . "</a>");
echo ("<br>");
echo ($item_desc . "</p>");
}
?>

When a request for an RSS feed is sent from the JavaScript, the following
happens:

 Check which feed was selected


 Create a new XML DOM object
 Load the RSS document in the xml variable
 Extract and output elements from the channel element
 Extract and output elements from the item elements
PHP Example - AJAX Poll
❮ PreviousNext ❯

AJAX Poll
The following example will demonstrate a poll where the result is shown without
reloading.

Do you like PHP and AJAX so far?


Yes:
No:

Example Explained - The HTML Page


When a user chooses an option above, a function called "getVote()" is executed.
The function is triggered by the "onclick" event:

<html>
<head>
<script>
function getVote(int) {
if (window.XMLHttpRequest) {
// code for IE7+, Firefox, Chrome, Opera, Safari
xmlhttp=new XMLHttpRequest();
} else { // code for IE6, IE5
xmlhttp=new ActiveXObject("Microsoft.XMLHTTP");
}
xmlhttp.onreadystatechange=function() {
if (this.readyState==4 && this.status==200) {
document.getElementById("poll").innerHTML=this.responseText;
}
}
xmlhttp.open("GET","poll_vote.php?vote="+int,true);
xmlhttp.send();
}
</script>
</head>
<body>

<div id="poll">
<h3>Do you like PHP and AJAX so far?</h3>
<form>
Yes:
<input type="radio" name="vote" value="0"onclick="getVote(this.value)"
>
<br>No:
<input type="radio" name="vote" value="1"onclick="getVote(this.value)"
>
</form>
</div>

</body>
</html>

The getVote() function does the following:

 Create an XMLHttpRequest object


 Create the function to be executed when the server response is ready
 Send the request off to a file on the server
 Notice that a parameter (vote) is added to the URL (with the value of the
yes or no option)

The PHP File


The page on the server called by the JavaScript above is a PHP file called
"poll_vote.php":

<?php
$vote = $_REQUEST['vote'];

//get content of textfile


$filename = "poll_result.txt";
$content = file($filename);

//put content in array


$array = explode("||", $content[0]);
$yes = $array[0];
$no = $array[1];

if ($vote == 0) {
$yes = $yes + 1;
}
if ($vote == 1) {
$no = $no + 1;
}

//insert votes to txt file


$insertvote = $yes."||".$no;
$fp = fopen($filename,"w");
fputs($fp,$insertvote);
fclose($fp);
?>

<h2>Result:</h2>
<table>
<tr>
<td>Yes:</td>
<td>
<img src="poll.gif"
width='<?php echo(100*round($yes/($no+$yes),2)); ?>'
height='20'>
<?php echo(100*round($yes/($no+$yes),2)); ?>%
</td>
</tr>
<tr>
<td>No:</td>
<td>
<img src="poll.gif"
width='<?php echo(100*round($no/($no+$yes),2)); ?>'
height='20'>
<?php echo(100*round($no/($no+$yes),2)); ?>%
</td>
</tr>
</table>

The value is sent from the JavaScript, and the following happens:

1. Get the content of the "poll_result.txt" file


2. Put the content of the file in variables and add one to the selected
variable
3. Write the result to the "poll_result.txt" file
4. Output a graphical representation of the poll result

The Text File


The text file (poll_result.txt) is where we store the data from the poll.

It is stored like this:

0||0

The first number represents the "Yes" votes, the second number represents the
"No" votes.

Note: Remember to allow your web server to edit the text file. Do NOT give
everyone access, just the web server (PHP).
PHP 5 Reference
❮ PreviousNext ❯

This section contains a complete PHP reference documentation.

PHP Reference
The PHP reference contains different categories of all PHP functions and
constants, along with examples.

ArrayCalendarDateDirectoryErrorFilesystemFilterFTPHTTPlibxmlMailMathMisc
MySQLiSimpleXMLStringXMLZipTimezones
PHP 5 Array Functions
❮ PreviousNext ❯

PHP Array Introduction


The array functions allow you to access and manipulate arrays.

Simple and multi-dimensional arrays are supported.

Installation
The array functions are part of the PHP core. There is no installation needed to use these
functions.

PHP 5 Array Functions

Function Description

array() Creates an array

array_change_key_case() Changes all keys in an array to


lowercase or uppercase

array_chunk() Splits an array into chunks of


arrays

array_column() Returns the values from a single


column in the input array
array_combine() Creates an array by using the
elements from one "keys" array
and one "values" array

array_count_values() Counts all the values of an array

array_diff() Compare arrays, and returns the


differences (compare values only)

array_diff_assoc() Compare arrays, and returns the


differences (compare keys and
values)

array_diff_key() Compare arrays, and returns the


differences (compare keys only)

array_diff_uassoc() Compare arrays, and returns the


differences (compare keys and
values, using a user-defined key
comparison function)

array_diff_ukey() Compare arrays, and returns the


differences (compare keys only,
using a user-defined key
comparison function)

array_fill() Fills an array with values

array_fill_keys() Fills an array with values,


specifying keys

array_filter() Filters the values of an array


using a callback function

array_flip() Flips/Exchanges all keys with


their associated values in an
array

array_intersect() Compare arrays, and returns the


matches (compare values only)

array_intersect_assoc() Compare arrays and returns the


matches (compare keys and
values)

array_intersect_key() Compare arrays, and returns the


matches (compare keys only)

array_intersect_uassoc() Compare arrays, and returns the


matches (compare keys and
values, using a user-defined key
comparison function)

array_intersect_ukey() Compare arrays, and returns the


matches (compare keys only,
using a user-defined key
comparison function)

array_key_exists() Checks if the specified key exists


in the array

array_keys() Returns all the keys of an array

array_map() Sends each value of an array to a


user-made function, which
returns new values

array_merge() Merges one or more arrays into


one array

array_merge_recursive() Merges one or more arrays into


one array recursively

array_multisort() Sorts multiple or multi-


dimensional arrays

array_pad() Inserts a specified number of


items, with a specified value, to
an array

array_pop() Deletes the last element of an


array

array_product() Calculates the product of the


values in an array

array_push() Inserts one or more elements to


the end of an array

array_rand() Returns one or more random keys


from an array

array_reduce() Returns an array as a string,


using a user-defined function

array_replace() Replaces the values of the first


array with the values from
following arrays

array_replace_recursive() Replaces the values of the first


array with the values from
following arrays recursively

array_reverse() Returns an array in the reverse


order

array_search() Searches an array for a given


value and returns the key

array_shift() Removes the first element from


an array, and returns the value of
the removed element

array_slice() Returns selected parts of an array

array_splice() Removes and replaces specified


elements of an array

array_sum() Returns the sum of the values in


an array

array_udiff() Compare arrays, and returns the


differences (compare values only,
using a user-defined key
comparison function)

array_udiff_assoc() Compare arrays, and returns the


differences (compare keys and
values, using a built-in function to
compare the keys and a user-
defined function to compare the
values)

array_udiff_uassoc() Compare arrays, and returns the


differences (compare keys and
values, using two user-defined
key comparison functions)

array_uintersect() Compare arrays, and returns the


matches (compare values only,
using a user-defined key
comparison function)

array_uintersect_assoc() Compare arrays, and returns the


matches (compare keys and
values, using a built-in function to
compare the keys and a user-
defined function to compare the
values)

array_uintersect_uassoc() Compare arrays, and returns the


matches (compare keys and
values, using two user-defined
key comparison functions)

array_unique() Removes duplicate values from


an array

array_unshift() Adds one or more elements to the


beginning of an array

array_values() Returns all the values of an array

array_walk() Applies a user function to every


member of an array
array_walk_recursive() Applies a user function recursively
to every member of an array

arsort() Sorts an associative array in


descending order, according to
the value

asort() Sorts an associative array in


ascending order, according to the
value

compact() Create array containing variables


and their values

count() Returns the number of elements


in an array

current() Returns the current element in an


array

each() Returns the current key and value


pair from an array

end() Sets the internal pointer of an


array to its last element

extract() Imports variables into the current


symbol table from an array

in_array() Checks if a specified value exists


in an array
key() Fetches a key from an array

krsort() Sorts an associative array in


descending order, according to
the key

ksort() Sorts an associative array in


ascending order, according to the
key

list() Assigns variables as if they were


an array

natcasesort() Sorts an array using a case


insensitive "natural order"
algorithm

natsort() Sorts an array using a "natural


order" algorithm

next() Advance the internal array pointer


of an array

pos() Alias of current()

prev() Rewinds the internal array pointer

range() Creates an array containing a


range of elements
reset() Sets the internal pointer of an
array to its first element

rsort() Sorts an indexed array in


descending order

shuffle() Shuffles an array

sizeof() Alias of count()

sort() Sorts an indexed array in


ascending order

uasort() Sorts an array by values using a


user-defined comparison function

uksort() Sorts an array by keys using a


user-defined comparison function

usort() Sorts an array using a user-


defined comparison function
PHP 5 Calendar Functions
❮ PreviousNext ❯

PHP Calendar Introduction


The calendar extension contains functions that simplifies converting between different
calendar formats.

It is based on the Julian Day Count, which is a count of days starting from January
1st, 4713 B.C.

Note: To convert between calendar formats, you must first convert to Julian Day Count,
then to the calendar of your choice.

Note: The Julian Day Count is not the same as the Julian Calendar!

Installation
For these functions to work, you have to compile PHP with --enable-calendar.

The Windows version of PHP has built-in support for this extension.

PHP 5 Calendar Functions

Function Description

cal_days_in_month() Returns the number of days in a


month for a specified year and
calendar

cal_from_jd() Converts a Julian Day Count into a


date of a specified calendar
cal_info() Returns information about a specified
calendar

cal_to_jd() Converts a date in a specified calendar


to Julian Day Count

easter_date() Returns the Unix timestamp for


midnight on Easter of a specified year

easter_days() Returns the number of days after


March 21, that the Easter Day is in a
specified year

frenchtojd() Converts a French Republican date to a


Julian Day Count

gregoriantojd() Converts a Gregorian date to a Julian


Day Count

jddayofweek() Returns the day of the week

jdmonthname() Returns a month name

jdtofrench() Converts a Julian Day Count to a


French Republican date

jdtogregorian() Converts a Julian Day Count to a


Gregorian date

jdtojewish() Converts a Julian Day Count to a


Jewish date

jdtojulian() Converts a Julian Day Count to a Julian


date

jdtounix() Converts Julian Day Count to Unix


timestamp

jewishtojd() Converts a Jewish date to a Julian Day


Count

juliantojd() Converts a Julian date to a Julian Day


Count

unixtojd() Converts Unix timestamp to Julian Day


Count

PHP 5 Predefined Calendar Constants

Constant Type PHP


Version

CAL_GREGORIAN Integer PHP 4

CAL_JULIAN Integer PHP 4


CAL_JEWISH Integer PHP 4

CAL_FRENCH Integer PHP 4

CAL_NUM_CALS Integer PHP 4

CAL_DOW_DAYNO Integer PHP 4

CAL_DOW_SHORT Integer PHP 4

CAL_DOW_LONG Integer PHP 4

CAL_MONTH_GREGORIAN_SHORT Integer PHP 4

CAL_MONTH_GREGORIAN_LONG Integer PHP 4

CAL_MONTH_JULIAN_SHORT Integer PHP 4

CAL_MONTH_JULIAN_LONG Integer PHP 4

CAL_MONTH_JEWISH Integer PHP 4

CAL_MONTH_FRENCH Integer PHP 4


CAL_EASTER_DEFAULT Integer PHP 4.3

CAL_EASTER_ROMAN Integer PHP 4.3

CAL_EASTER_ALWAYS_GREGORIAN Integer PHP 4.3

CAL_EASTER_ALWAYS_JULIAN Integer PHP 4.3

CAL_JEWISH_ADD_ALAFIM_GERESH Integer PHP 5.0

CAL_JEWISH_ADD_ALAFIM Integer PHP 5.0

CAL_JEWISH_ADD_GERESHAYIM Integer PHP 5.0


PHP 5 Date/Time Functions
❮ PreviousNext ❯

PHP Date/Time Introduction


The date/time functions allow you to get the date and time from the server where your PHP
script runs. You can then use the date/time functions to format the date and time in several
ways.

Note: These functions depend on the locale settings of your server. Remember to take
daylight saving time and leap years into consideration when working with these functions.

Installation
The PHP date/time functions are part of the PHP core. No installation is required to use
these functions.

Runtime Configuration
The behavior of these functions is affected by settings in php.ini:

Name Description Default PHP


Version

date.timezone The default "" PHP 5.1


timezone (used by
all date/time
functions)

date.default_latitude The default "31.7667" PHP 5.0


latitude (used by
date_sunrise() and
date_sunset())

date.default_longitude The default "35.2333" PHP 5.0


longitude (used by
date_sunrise() and
date_sunset())

date.sunrise_zenith The default sunrise "90.83" PHP 5.0


zenith (used by
date_sunrise() and
date_sunset())

date.sunset_zenith The default sunset "90.83" PHP 5.0


zenith (used by
date_sunrise() and
date_sunset())

PHP 5 Date/Time Functions

Function Description

checkdate() Validates a Gregorian


date

date_add() Adds days, months,


years, hours, minutes,
and seconds to a date
date_create_from_format() Returns a new
DateTime object
formatted according to
a specified format

date_create() Returns a new


DateTime object

date_date_set() Sets a new date

date_default_timezone_get() Returns the default


timezone used by all
date/time functions

date_default_timezone_set() Sets the default


timezone used by all
date/time functions

date_diff() Returns the difference


between two dates

date_format() Returns a date


formatted according to
a specified format

date_get_last_errors() Returns the


warnings/errors found
in a date string

date_interval_create_from_date_string() Sets up a DateInterval


from the relative parts
of the string

date_interval_format() Formats the interval

date_isodate_set() Sets the ISO date

date_modify() Modifies the


timestamp

date_offset_get() Returns the timezone


offset

date_parse_from_format() Returns an associative


array with detailed
info about a specified
date, according to a
specified format

date_parse() Returns an associative


array with detailed
info about a specified
date

date_sub() Subtracts days,


months, years, hours,
minutes, and seconds
from a date

date_sun_info() Returns an array


containing info about
sunset/sunrise and
twilight begin/end, for
a specified day and
location

date_sunrise() Returns the sunrise


time for a specified
day and location

date_sunset() Returns the sunset


time for a specified
day and location

date_time_set() Sets the time

date_timestamp_get() Returns the Unix


timestamp

date_timestamp_set() Sets the date and time


based on a Unix
timestamp

date_timezone_get() Returns the time zone


of the given DateTime
object

date_timezone_set() Sets the time zone for


the DateTime object

date() Formats a local date


and time

getdate() Returns date/time


information of a
timestamp or the
current local date/time

gettimeofday() Returns the current


time

gmdate() Formats a GMT/UTC


date and time

gmmktime() Returns the Unix


timestamp for a GMT
date

gmstrftime() Formats a GMT/UTC


date and time
according to locale
settings

idate() Formats a local


time/date as integer

localtime() Returns the local time

microtime() Returns the current


Unix timestamp with
microseconds

mktime() Returns the Unix


timestamp for a date
strftime() Formats a local time
and/or date according
to locale settings

strptime() Parses a time/date


generated with
strftime()

strtotime() Parses an English


textual datetime into a
Unix timestamp

time() Returns the current


time as a Unix
timestamp

timezone_abbreviations_list() Returns an associative


array containing dst,
offset, and the
timezone name

timezone_identifiers_list() Returns an indexed


array with all
timezone identifiers

timezone_location_get() Returns location


information for a
specified timezone

timezone_name_from_ abbr() Returns the timezone


name from
abbreviation
timezone_name_get() Returns the name of
the timezone

timezone_offset_get() Returns the timezone


offset from GMT

timezone_open() Creates new


DateTimeZone object

timezone_transitions_get() Returns all transitions


for the timezone

timezone_version_get() Returns the version of


the timezone db

PHP 5 Predefined Date/Time Constants

Constant Description

DATE_ATOM Atom (example: 2005-08-


15T16:13:03+0000)

DATE_COOKIE HTTP Cookies (example: Sun, 14 Aug


2005 16:13:03 UTC)

DATE_ISO8601 ISO-8601 (example: 2005-08-


14T16:13:03+0000)

DATE_RFC822 RFC 822 (example: Sun, 14 Aug 2005


16:13:03 UTC)

DATE_RFC850 RFC 850 (example: Sunday, 14-Aug-05


16:13:03 UTC)

DATE_RFC1036 RFC 1036 (example: Sunday, 14-Aug-05


16:13:03 UTC)

DATE_RFC1123 RFC 1123 (example: Sun, 14 Aug 2005


16:13:03 UTC)

DATE_RFC2822 RFC 2822 (Sun, 14 Aug 2005 16:13:03


+0000)

DATE_RSS RSS (Sun, 14 Aug 2005 16:13:03 UTC)

DATE_W3C World Wide Web Consortium (example:


2005-08-14T16:13:03+0000)
PHP 5 Directory Functions
❮ PreviousNext ❯

PHP Directory Introduction


The directory functions allow you to retrieve information about directories and their
contents.

Installation
The PHP directory functions are part of the PHP core. No installation is required to use these
functions.

PHP 5 Directory Functions

Function Description

chdir() Changes the current directory

chroot() Changes the root directory

closedir() Closes a directory handle

dir() Returns an instance of the Directory class

getcwd() Returns the current working directory


opendir() Opens a directory handle

readdir() Returns an entry from a directory handle

rewinddir() Resets a directory handle

scandir() Returns an array of files and directories of a


specified directory
PHP 5 Error Functions
❮ PreviousNext ❯

PHP Error Introduction


The error functions are used to deal with error handling and logging.

The error functions allow us to define own error handling rules, and modify the way the
errors can be logged.

The logging functions allow us to send messages directly to other machines, emails, or
system logs.

The error reporting functions allow us to customize what level and kind of error feedback is
given.

Installation
The PHP error functions are part of the PHP core. No installation is required to use these
functions.

Runtime Configuration
The behavior of the error functions is affected by settings in php.ini.

Errors and logging configuration options:

Name Default Description Changeable

error_reporting NULL Sets the error reporting PHP_INI_ALL


level (either an integer
or named constants)
display_errors "1" Specifies whether PHP_INI_ALL
errors should be printed
to the screen, or if they
should be hidden from
the user.
Note: This feature
should never be used
on production systems
(only to support your
development)

display_startup_errors "0" Even when PHP_INI_ALL


display_errors is on,
errors that occur during
PHP's startup sequence
are not displayed
Note: It is strongly
recommended to keep
display_startup_errors
off, except for
debugging

log_errors "0" Defines whether script PHP_INI_ALL


error messages should
be logged to the
server's error log or
error_log.
Note: It is strongly
advised to use error
logging instead of error
displaying on
production web sites

log_errors_max_len "1024" Sets the maximum PHP_INI_ALL


length of log_errors in
bytes. The value "0"
can be used to not
apply any maximum
length at all. This
length is applied to
logged errors,
displayed errors, and
also to $php_errormsg
(available since PHP
4.3)

ignore_repeated_errors "0" Specifies whether to PHP_INI_ALL


log repeated error
messages. When set to
"1" it will not log errors
with repeated errors
from the same file on
the same line (available
since PHP 4.3)

ignore_repeated_source "0" Specifies whether to PHP_INI_ALL


log repeated error
messages. When set to
"1" it will not log errors
with repeated errors
from different files or
source lines (available
since PHP 4.3)

report_memleaks "1" If set to "1" (the PHP_INI_ALL


default), this parameter
will show a report of
memory leaks detected
by the Zend memory
manager (available
since PHP 4.3)

track_errors "0" If set to "1", the last PHP_INI_ALL


error message will
always be present in the
variable $php_errormsg
html_errors "1" Turns off HTML tags PHP_INI_ALL
in error messages PHP_INI_SYSTEM
in PHP <= 4.2.3.

xmlrpc_errors "0" Turns off normal error PHP_INI_SYSTEM


reporting and formats
errors as XML-RPC
error message
(available since PHP
4.1)

xmlrpc_error_number "0" Used as the value of the PHP_INI_ALL


XML-RPC faultCode
element (available
since PHP 4.1)

docref_root "" (available since PHP PHP_INI_ALL


4.3)

docref_ext "" (available since PHP PHP_INI_ALL


4.3.2)

error_prepend_string NULL Specifies a string to PHP_INI_ALL


output before an error
message

error_append_string NULL Specifies a string to PHP_INI_ALL


output after an error
message

error_log NULL Specifies the name of PHP_INI_ALL


the file where script
errors should be
logged. The file should
be writable by the web
server's user. If the
special value syslog is
used, the errors are sent
to the system logger
instead

PHP Error and Logging Functions

Function Description

debug_backtrace() Generates a backtrace

debug_print_backtrace() Prints a backtrace

error_get_last() Returns the last error that


occurred

error_log() Sends an error message to a


log, to a file, or to a mail
account

error_reporting() Specifies which errors are


reported

restore_error_handler() Restores the previous error


handler
restore_exception_handler() Restores the previous exception
handler

set_error_handler() Sets a user-defined error


handler function

set_exception_handler() Sets a user-defined exception


handler function

trigger_error() Creates a user-level error


message

user_error() Alias of trigger_error()

PHP 5 Predefined Error and Logging Constants

Value Constant Description

1 E_ERROR Fatal run-time errors.


Errors that cannot be
recovered from.
Execution of the script is
halted

2 E_WARNING Run-time warnings (non-


fatal errors). Execution
of the script is not halted

4 E_PARSE Compile-time parse


errors. Parse errors
should only be generated
by the parser

8 E_NOTICE Run-time notices. The


script found something
that might be an error,
but could also happen
when running a script
normally

16 E_CORE_ERROR Fatal errors at PHP


startup. This is like
E_ERROR, except it is
generated by the core of
PHP

32 E_CORE_WARNING Non-fatal errors at PHP


startup. This is like
E_WARNING, except it
is generated by the core
of PHP

64 E_COMPILE_ERROR Fatal compile-time


errors. This is like
E_ERROR, except it is
generated by the Zend
Scripting Engine

128 E_COMPILE_WARNING Non-fatal compile-time


errors. This is like
E_WARNING, except it
is generated by the Zend
Scripting Engine

256 E_USER_ERROR Fatal user-generated


error. This is like
E_ERROR, except it is
generated in PHP code
by using the PHP
function trigger_error()

512 E_USER_WARNING Non-fatal user-generated


warning. This is like
E_WARNING, except it
is generated in PHP code
by using the PHP
function trigger_error()

1024 E_USER_NOTICE User-generated notice.


This is like E_NOTICE,
except it is generated in
PHP code by using the
PHP function
trigger_error()

2048 E_STRICT Enable to have PHP


suggest changes to your
code which will ensure
the best interoperability
and forward
compatibility of your
code (Since PHP 5 but
not included in E_ALL
until PHP 5.4)

4096 E_RECOVERABLE_ERROR Catchable fatal error.


Indicates that a probably
dangerous error
occurred, but did not
leave the Engine in an
unstable state. If the
error is not caught by a
user defined handle, the
application aborts as it
was an E_ERROR
(Since PHP 5.2)

8192 E_DEPRECATED Run-time notices. Enable


this to receive warnings
about code that will not
work in future versions
(Since PHP 5.3)

16384 E_USER_DEPRECATED User-generated warning


message. This is like
E_DEPRECATED,
except it is generated in
PHP code by using the
PHP function
trigger_error() (Since
PHP 5.3)

32767 E_ALL Enable all PHP errors


and warnings (except
E_STRICT in versions <
5.4)
PHP 5 Filesystem Functions
❮ PreviousNext ❯

PHP Filesystem Introduction


The filesystem functions allow you to access and manipulate the filesystem.

Installation
The filesystem functions are part of the PHP core. There is no installation needed to use
these functions.

Unix / Windows Compatibility


When specifying a path on Unix platforms, a forward slash (/) is used as directory
separator.

On Windows platforms, both forward slash (/) and backslash (\) can be used.

Runtime Configuration
The behavior of the filesystem functions is affected by settings in php.ini.

Filesystem configuration options:

Name Default Description Changeable

allow_url_fopen "1" Allows PHP_INI_SYSTEM


fopen()-type
functions to
work with
URLs
(available
since PHP
4.0.4)

user_agent NULL Defines the PHP_INI_ALL


user agent for
PHP to send
(available
since PHP
4.3)

default_socket_timeout "60" Sets the PHP_INI_ALL


default
timeout, in
seconds, for
socket based
streams
(available
since PHP
4.3)

from "" Defines the PHP_INI_ALL


anonymous
FTP
password
(your email
address)

auto_detect_line_endings "0" When set to PHP_INI_ALL


"1", PHP will
examine the
data read by
fgets() and
file() to see if
it is using
Unix, MS-
Dos or Mac
line-ending
characters
(available
since PHP
4.3)

PHP 5 Filesystem Functions

Function Description

basename() Returns the filename component of a


path

chgrp() Changes the file group

chmod() Changes the file mode

chown() Changes the file owner

clearstatcache() Clears the file status cache

copy() Copies a file

delete() See unlink() or unset()

dirname() Returns the directory name component


of a path

disk_free_space() Returns the free space of a directory

disk_total_space() Returns the total size of a directory

diskfreespace() Alias of disk_free_space()

fclose() Closes an open file

feof() Tests for end-of-file on an open file

fflush() Flushes buffered output to an open file

fgetc() Returns a character from an open file

fgetcsv() Parses a line from an open file, checking


for CSV fields

fgets() Returns a line from an open file

fgetss() Returns a line, with HTML and PHP


tags removed, from an open file

file() Reads a file into an array


file_exists() Checks whether or not a file or directory
exists

file_get_contents() Reads a file into a string

file_put_contents() Writes a string to a file

fileatime() Returns the last access time of a file

filectime() Returns the last change time of a file

filegroup() Returns the group ID of a file

fileinode() Returns the inode number of a file

filemtime() Returns the last modification time of a


file

fileowner() Returns the user ID (owner) of a file

fileperms() Returns the permissions of a file

filesize() Returns the file size

filetype() Returns the file type


flock() Locks or releases a file

fnmatch() Matches a filename or string against a


specified pattern

fopen() Opens a file or URL

fpassthru() Reads from an open file, until EOF, and


writes the result to the output buffer

fputcsv() Formats a line as CSV and writes it to an


open file

fputs() Alias of fwrite()

fread() Reads from an open file

fscanf() Parses input from an open file according


to a specified format

fseek() Seeks in an open file

fstat() Returns information about an open file

ftell() Returns the current position in an open


file
ftruncate() Truncates an open file to a specified
length

fwrite() Writes to an open file

glob() Returns an array of filenames /


directories matching a specified pattern

is_dir() Checks whether a file is a directory

is_executable() Checks whether a file is executable

is_file() Checks whether a file is a regular file

is_link() Checks whether a file is a link

is_readable() Checks whether a file is readable

is_uploaded_file() Checks whether a file was uploaded via


HTTP POST

is_writable() Checks whether a file is writeable

is_writeable() Alias of is_writable()

lchgrp() Changes group ownership of symlink


lchown() Changes user ownership of symlink

link() Creates a hard link

linkinfo() Returns information about a hard link

lstat() Returns information about a file or


symbolic link

mkdir() Creates a directory

move_uploaded_file() Moves an uploaded file to a new


location

parse_ini_file() Parses a configuration file

parse_ini_string() Parses a configuration string

pathinfo() Returns information about a file path

pclose() Closes a pipe opened by popen()

popen() Opens a pipe

readfile() Reads a file and writes it to the output


buffer
readlink() Returns the target of a symbolic link

realpath() Returns the absolute pathname

realpath_cache_get() Returns realpath cache entries

realpath_cache_size() Returns realpath cache size

rename() Renames a file or directory

rewind() Rewinds a file pointer

rmdir() Removes an empty directory

set_file_buffer() Sets the buffer size of an open file

stat() Returns information about a file

symlink() Creates a symbolic link

tempnam() Creates a unique temporary file

tmpfile() Creates a unique temporary file


touch() Sets access and modification time of a
file

umask() Changes file permissions for files

unlink() Deletes a file

❮ PreviousNext ❯
PHP 5 Filter Functions
❮ PreviousNext ❯

PHP Filter Introduction


This PHP filters is used to validate and filter data coming from insecure sources, like user
input.

Installation
As of PHP 5.2.0, the filter functions are enabled by default. There is no installation needed
to use these functions.

Runtime Configurations
The behavior of these functions is affected by settings in php.ini:

Name Description Default Changeable

filter.default Filter all $_GET, $_POST, $_COOKIE, "unsafe_raw PHP_INI_PERDI


$_REQUEST and $_SERVER data by " R
this filter. Accepts the name of the filter
you like to use by default. See the filter
list for the list of the filter names

filter.default_flag Default flags to apply when the default NULL PHP_INI_PERDI


s filter is set. This is set to R
FILTER_FLAG_NO_ENCODE_QUOTE
S by default for backwards compatibility
reasons
PHP 5 Filter Functions

Function Description

filter_has_var() Checks if a variable of a specified input


type exist

filter_id() Returns the filter ID of a specified filter


name

filter_input() Gets an external variable (e.g. from


form input) and optionally filters it

filter_input_array() Gets external variables (e.g. from form


input) and optionally filters them

filter_list() Returns a list of all supported filters

filter_var_array() Gets multiple variables and filter them

filter_var() Filters a variable with a specified filter

PHP 5 Predefined Filter Constants

Constant ID Description
FILTER_VALIDATE_BOOLEAN 258 Validates a boolean

FILTER_VALIDATE_EMAIL 274 Validates an e-mail address

FILTER_VALIDATE_FLOAT 259 Validates a float

FILTER_VALIDATE_INT 257 Validates an integer

FILTER_VALIDATE_IP 275 Validates an IP address

FILTER_VALIDATE_REGEXP 272 Validates a regular expression

FILTER_VALIDATE_URL 273 Validates a URL

FILTER_SANITIZE_EMAIL 517 Removes all illegal characters


from an e-mail address

FILTER_SANITIZE_ENCODED 514 Removes/Encodes special


characters

FILTER_SANITIZE_MAGIC_QUOTES 521 Apply addslashes()

FILTER_SANITIZE_NUMBER_FLOAT 520 Remove all characters, except


digits, +- and optionally .,eE

FILTER_SANITIZE_NUMBER_INT 519 Removes all characters except


digits and + -

FILTER_SANITIZE_SPECIAL_CHARS 515 Removes special characters

FILTER_SANITIZE_FULL_SPECIAL_CHARS

FILTER_SANITIZE_STRING 513 Removes tags/special


characters from a string

FILTER_SANITIZE_STRIPPED 513 Alias of


FILTER_SANITIZE_STRING

FILTER_SANITIZE_URL 518 Removes all illegal character


from s URL

FILTER_UNSAFE_RAW 516 Do nothing, optionally


strip/encode special characters

FILTER_CALLBACK 1024 Call a user-defined function to


filter data
PHP 5 FTP Functions
❮ PreviousNext ❯

PHP FTP Introduction


The FTP functions give client access to file servers through the File Transfer Protocol (FTP).

The FTP functions are used to open, login and close connections, as well as upload,
download, rename, delete, and get information on files from file servers. Not all of the FTP
functions will work with every server or return the same results. The FTP functions became
available with PHP 3.

If you only wish to read from or write to a file on an FTP server, consider using the ftp://
wrapper with the Filesystem functions which provide a simpler and more intuitive interface.

Installation
For these functions to work, you have to compile PHP with --enable-ftp.

The Windows version of PHP has built-in support for this extension.

PHP 5 FTP Functions

Function Description

ftp_alloc() Allocates space for a file to be uploaded to


the FTP server

ftp_cdup() Changes to the parent directory on the


FTP server
ftp_chdir() Changes the current directory on the FTP
server

ftp_chmod() Sets permissions on a file via FTP

ftp_close() Closes an FTP connection

ftp_connect() Opens an FTP connection

ftp_delete() Deletes a file on the FTP server

ftp_exec() Executes a command on the FTP server

ftp_fget() Downloads a file from the FTP server and


saves it into an open local file

ftp_fput() Uploads from an open file and saves it to


a file on the FTP server

ftp_get_option() Returns runtime options of the FTP


connection

ftp_get() Downloads a file from the FTP server

ftp_login() Logs in to the FTP connection

ftp_mdtm() Returns the last modified time of a


specified file
ftp_mkdir() Creates a new directory on the FTP server

ftp_nb_continue() Continues retrieving/sending a file (non-


blocking)

ftp_nb_fget() Downloads a file from the FTP server and


saves it into an open file (non-blocking)

ftp_nb_fput() Uploads from an open file and saves it to


a file on the FTP server (non-blocking)

ftp_nb_get() Downloads a file from the FTP server


(non-blocking)

ftp_nb_put() Uploads a file to the FTP server (non-


blocking)

ftp_nlist() Returns a list of files in the specified


directory on the FTP server

ftp_pasv() Turns passive mode on or off

ftp_put() Uploads a file to the FTP server

ftp_pwd() Returns the current directory name

ftp_quit() An alias of ftp_close()


ftp_raw() Sends a raw command to the FTP server

ftp_rawlist() Returns a list of files with file information


from a specified directory

ftp_rename() Renames a file or directory on the FTP


server

ftp_rmdir() Deletes an empty directory on the FTP


server

ftp_set_option() Sets runtime options for the FTP


connection

ftp_site() Sends an FTP SITE command to the FTP


server

ftp_size() Returns the size of the specified file

ftp_ssl_connect() Opens a secure SSL-FTP connection

ftp_systype() Returns the system type identifier of the


FTP server

PHP 5 Predefined FTP Constants

Constant Type PHP

FTP_ASCII Integer PHP 3


FTP_TEXT Integer PHP 3

FTP_BINARY Integer PHP 3

FTP_IMAGE Integer PHP 3

FTP_TIMEOUT_SEC Integer PHP 3

FTP_AUTOSEEK Integer PHP 4.3

FTP_AUTORESUME Integer PHP 4.3

FTP_FAILED Integer PHP 4.3

FTP_FINISHED Integer PHP 4.3

FTP_MOREDATA Integer PHP 4.3


PHP 5 HTTP Functions
❮ PreviousNext ❯

PHP HTTP Introduction


The HTTP functions let you manipulate information sent to the browser by the Web server,
before any other output has been sent.

Installation
The HTTP functions are part of the PHP core. There is no installation needed to use these
functions.

PHP 5 HTTP Functions


PHP: indicates the earliest version of PHP that supports the function.

Function Description

header() Sends a raw HTTP header to a client

headers_list() Returns a list of response headers sent (or


ready to send)

headers_sent() Checks if / where the HTTP headers have


been sent

setcookie() Defines a cookie to be sent along with the


rest of the HTTP headers
setrawcookie() Defines a cookie (without URL encoding) to
be sent along with the rest of the HTTP
headers
PHP 5 libxml Functions
❮ PreviousNext ❯

PHP libxml Introduction


The libxml functions and constants are used together with SimpleXML, XSLT and DOM
functions.

Installation
These functions require the libxml package. Download at xmlsoft.org

PHP libxml Functions


PHP: indicates the earliest version of PHP that supports the function.

Function Description

libxml_clear_errors() Clear libxml error buffer

libxml_get_errors() Retrieve array of errors

libxml_get_last_error() Retrieve last error from libxml

libxml_set_streams_context() Set the streams context for


the next libxml document load
or write
libxml_use_internal_errors() Disable libxml errors and
allow user to fetch error
information as needed

PHP 5 Predefined libxml Constants

Function Description

LIBXML_COMPACT Set small nodes allocation


optimization. This may improve
the application performance

LIBXML_DTDATTR Set default DTD attributes

LIBXML_DTDLOAD Load external subset

LIBXML_DTDVALID Validate with the DTD

LIBXML_NOBLANKS Remove blank nodes

LIBXML_NOCDATA Set CDATA as text nodes

LIBXML_NOEMPTYTAG Change empty tags (e.g. <br/>


to <br></br>), only available in
the DOMDocument->save() and
DOMDocument->saveXML()
functions

LIBXML_NOENT Substitute entities


LIBXML_NOERROR Do not show error reports

LIBXML_NONET Stop network access while


loading documents

LIBXML_NOWARNING Do not show warning reports

LIBXML_NOXMLDECL Drop the XML declaration when


saving a document

LIBXML_NSCLEAN Remove excess namespace


declarations

LIBXML_XINCLUDE Use XInclude substitution

LIBXML_ERR_ERROR Get recoverable errors

LIBXML_ERR_FATAL Get fatal errors

LIBXML_ERR_NONE Get no errors

LIBXML_ERR_WARNING Get simple warnings

LIBXML_VERSION Get libxml version (e.g. 20605


or 20617)

LIBXML_DOTTED_VERSION Get dotted libxml version (e.g.


2.6.5 or 2.6.17)
PHP 5 Mail Functions
❮ PreviousNext ❯

PHP Mail Introduction


The mail() function allows you to send emails directly from a script.

Requirements
For the mail functions to be available, PHP requires an installed and working email system.
The program to be used is defined by the configuration settings in the php.ini file.

Installation
The mail functions are part of the PHP core. There is no installation needed to use these
functions.

Runtime Configuration
The behavior of the mail functions is affected by settings in php.ini:

Name Default Description Changeable

mail.add_x_header "0" Add X-PHP- PHP_INI_PERDIR


Originating-
Script that will
include UID of
the script
followed by the
filename. For
PHP 5.3.0 and
above

mail.log NULL The path to a PHP_INI_PERDIR


log file that will
log all mail()
calls. Log
include full path
of script, line
number, To
address and
headers. For
PHP 5.3.0 and
above

SMTP "localhost" Windows only: PHP_INI_ALL


The DNS name
or IP address of
the SMTP
server

smtp_port "25" Windows only: PHP_INI_ALL


The SMTP port
number. For
PHP 4.3.0 and
above

sendmail_from NULL Windows only: PHP_INI_ALL


Specifies the
"from" address
to be used when
sending mail
from mail()

sendmail_path "/usr/sbin/sendmail Specifies where PHP_INI_SYSTEM


-t -i" the sendmail
program can be
found. This
directive works
also under
Windows. If set,
SMTP,
smtp_port and
sendmail_from
are ignored

PHP 5 Mail Functions

Function Description

ezmlm_hash() Calculates the hash value needed by EZMLM

mail() Allows you to send emails directly from a


script
PHP 5 Math Functions
❮ PreviousNext ❯

PHP Math Introduction


The math functions can handle values within the range of integer and float types.

Installation
The PHP math functions are part of the PHP core. No installation is required to use these
functions.

PHP 5 Math Functions

Function Description

abs() Returns the absolute (positive) value of a


number

acos() Returns the arc cosine of a number

acosh() Returns the inverse hyperbolic cosine of a


number

asin() Returns the arc sine of a number

asinh() Returns the inverse hyperbolic sine of a


number

atan() Returns the arc tangent of a number in


radians

atan2() Returns the arc tangent of two variables x


and y

atanh() Returns the inverse hyperbolic tangent of


a number

base_convert() Converts a number from one number base


to another

bindec() Converts a binary number to a decimal


number

ceil() Rounds a number up to the nearest


integer

cos() Returns the cosine of a number

cosh() Returns the hyperbolic cosine of a number

decbin() Converts a decimal number to a binary


number

dechex() Converts a decimal number to a


hexadecimal number
decoct() Converts a decimal number to an octal
number

deg2rad() Converts a degree value to a radian value

exp() Calculates the exponent of e

expm1() Returns exp(x) - 1

floor() Rounds a number down to the nearest


integer

fmod() Returns the remainder of x/y

getrandmax() Returns the largest possible value


returned by rand()

hexdec() Converts a hexadecimal number to a


decimal number

hypot() Calculates the hypotenuse of a right-angle


triangle

is_finite() Checks whether a value is finite or not

is_infinite() Checks whether a value is infinite or not

is_nan() Checks whether a value is 'not-a-number'


lcg_value() Returns a pseudo random number in a
range between 0 and 1

log() Returns the natural logarithm of a number

log10() Returns the base-10 logarithm of a


number

log1p() Returns log(1+number)

max() Returns the highest value in an array, or


the highest value of several specified
values

min() Returns the lowest value in an array, or


the lowest value of several specified
values

mt_getrandmax() Returns the largest possible value


returned by mt_rand()

mt_rand() Generates a random integer using


Mersenne Twister algorithm

mt_srand() Seeds the Mersenne Twister random


number generator

octdec() Converts an octal number to a decimal


number
pi() Returns the value of PI

pow() Returns x raised to the power of y

rad2deg() Converts a radian value to a degree value

rand() Generates a random integer

round() Rounds a floating-point number

sin() Returns the sine of a number

sinh() Returns the hyperbolic sine of a number

sqrt() Returns the square root of a number

srand() Seeds the random number generator

tan() Returns the tangent of a number

tanh() Returns the hyperbolic tangent of a


number

PHP 5 Predefined Math Constants


Constant Value Description PHP
Version

INF INF The infinite PHP 4

M_E 2.7182818284590452354 Returns e PHP 4

M_EULER 0.57721566490153286061 Returns PHP 4


Euler
constant

M_LNPI 1.14472988584940017414 Returns the PHP


natural 5.2
logarithm
of PI:
log_e(pi)

M_LN2 0.69314718055994530942 Returns the PHP 4


natural
logarithm
of 2: log_e
2

M_LN10 2.30258509299404568402 Returns the PHP 4


natural
logarithm
of 10: log_e
10

M_LOG2E 1.4426950408889634074 Returns the PHP 4


base-2
logarithm
of E: log_2
e

M_LOG10E 0.43429448190325182765 Returns the PHP 4


base-10
logarithm
of E:
log_10 e

M_PI 3.14159265358979323846 Returns Pi PHP 4

M_PI_2 1.57079632679489661923 Returns PHP 4


Pi/2

M_PI_4 0.78539816339744830962 Returns PHP 4


Pi/4

M_1_PI 0.31830988618379067154 Returns PHP 4


1/Pi

M_2_PI 0.63661977236758134308 Returns PHP 4


2/Pi

M_SQRTPI 1.77245385090551602729 Returns the PHP


square root 5.2
of PI:
sqrt(pi)

M_2_SQRTPI 1.12837916709551257390 Returns PHP 4


2/square
root of PI:
2/sqrt(pi)
M_SQRT1_2 0.70710678118654752440 Returns the PHP 4
square root
of 1/2:
1/sqrt(2)

M_SQRT2 1.41421356237309504880 Returns the PHP 4


square root
of 2: sqrt(2)

M_SQRT3 1.73205080756887729352 Returns the PHP


square root 5.2
of 3: sqrt(3)

NAN NAN Not A PHP 4


Number

PHP_ROUND_HALF_UP 1 Round PHP


halves up 5.3

PHP_ROUND_HALF_DOWN 2 Round PHP


halves 5.3
down

PHP_ROUND_HALF_EVEN 3 Round PHP


halves to 5.3
even
numbers

PHP_ROUND_HALF_ODD 4 Round PHP


halves to 5.3
odd
numbers
PHP 5 Misc. Functions
❮ PreviousNext ❯

PHP Miscellaneous Introduction


The misc. functions were only placed here because none of the other categories seemed to
fit.

Installation
The misc. functions are part of the PHP core. No installation is required to use these
functions.

Runtime Configuration
The behavior of the misc. functions is affected by settings in the php.ini file.

Misc. configuration options:

Name Description Default Changeable

ignore_user_abort FALSE "0" PHP_INI_ALL


indicates that
scripts will
be terminated
as soon as
they try to
output
something
after a client
has aborted
their
connection
highlight.string Color for "#DD0000" PHP_INI_ALL
highlighting
a string in
PHP syntax

highlight.comment Color for "#FF8000" PHP_INI_ALL


highlighting
PHP
comments

highlight.keyword Color for "#007700" PHP_INI_ALL


syntax
highlighting
PHP
keywords
(e.g.
parenthesis
and
semicolon)

highlight.bg Removed in "#FFFFFF" PHP_INI_ALL


PHP
5.4.0.Color
for
background

highlight.default Default color "#0000BB" PHP_INI_ALL


for PHP
syntax

highlight.html Color for "#000000" PHP_INI_ALL


HTML code

browscap Name and NULL PHP_INI_SYSTEM


location of
browser-
capabilities
file (e.g.
browscap.ini)

PHP Miscellaneous Functions

Function Description

connection_aborted() Checks whether the client has


disconnected

connection_status() Returns the current connection


status

connection_timeout() Deprecated in PHP 4.0.5. Checks


whether the script has timed out

constant() Returns the value of a constant

define() Defines a constant

defined() Checks whether a constant exists

die() Prints a message and exits the


current script
eval() Evaluates a string as PHP code

exit() Prints a message and exits the


current script

get_browser() Returns the capabilities of the user's


browser

__halt_compiler() Halts the compiler execution

highlight_file() Outputs a file with the PHP syntax


highlighted

highlight_string() Outputs a string with the PHP syntax


highlighted

ignore_user_abort() Sets whether a remote client can


abort the running of a script

pack() Packs data into a binary string

php_check_syntax() Deprecated in PHP 5.0.5

php_strip_whitespace() Returns the source code of a file


with PHP comments and whitespace
removed

show_source() Alias of highlight_file()


sleep() Delays code execution for a number
of seconds

sys_getloadavg() Gets system load average

time_nanosleep() Delays code execution for a number


of seconds and nanoseconds

time_sleep_until() Delays code execution until a


specified time

uniqid() Generates a unique ID

unpack() Unpacks data from a binary string

usleep() Delays code execution for a number


of microseconds

PHP 5 Predefined Misc. Constants


PHP: indicates the earliest version of PHP that supports the constant.

Constant Description PHP

CONNECTION_ABORTED

CONNECTION_NORMAL
CONNECTION_TIMEOUT

__COMPILER_HALT_OFFSET__ 5
PHP 5 MySQLi Functions
❮ PreviousNext ❯

PHP MySQLi Introduction


PHP MySQLi = PHP MySQL Improved!

The MySQLi functions allows you to access MySQL database servers.

Note: The MySQLi extension is designed to work with MySQL version 4.1.13 or newer.

Installation / Runtime Configuration


For the MySQLi functions to be available, you must compile PHP with support for the MySQLi
extension.

The MySQLi extension was introduced with PHP version 5.0.0. The MySQL Native Driver was
included in PHP version 5.3.0.

For installation details, go to:http://php.net/manual/en/mysqli.installation.php

For runtime configuration details, go to:http://php.net/manual/en/mysqli.configuration.php

PHP 5 MySQLi Functions

Function Description

mysqli_affected_rows() Returns the number of


affected rows in the previous
MySQL operation

mysqli_autocommit() Turns on or off auto-


committing database
modifications

mysqli_change_user() Changes the user of the


specified database
connection

mysqli_character_set_name() Returns the default character


set for the database
connection

mysqli_close() Closes a previously opened


database connection

mysqli_commit() Commits the current


transaction

mysqli_connect_errno() Returns the error code from


the last connection error

mysqli_connect_error() Returns the error description


from the last connection error

mysqli_connect() Opens a new connection to


the MySQL server

mysqli_data_seek() Adjusts the result pointer to


an arbitrary row in the result-
set

mysqli_debug() Performs debugging


operations

mysqli_dump_debug_info() Dumps debugging info into


the log

mysqli_errno() Returns the last error code


for the most recent function
call

mysqli_error_list() Returns a list of errors for the


most recent function call

mysqli_error() Returns the last error


description for the most
recent function call

mysqli_fetch_all() Fetches all result rows as an


associative array, a numeric
array, or both

mysqli_fetch_array() Fetches a result row as an


associative, a numeric array,
or both

mysqli_fetch_assoc() Fetches a result row as an


associative array

mysqli_fetch_field_direct() Returns meta-data for a


single field in the result set,
as an object
mysqli_fetch_field() Returns the next field in the
result set, as an object

mysqli_fetch_fields() Returns an array of objects


that represent the fields in a
result set

mysqli_fetch_lengths() Returns the lengths of the


columns of the current row in
the result set

mysqli_fetch_object() Returns the current row of a


result set, as an object

mysqli_fetch_row() Fetches one row from a


result-set and returns it as an
enumerated array

mysqli_field_count() Returns the number of


columns for the most recent
query

mysqli_field_seek() Sets the field cursor to the


given field offset

mysqli_field_tell() Returns the position of the


field cursor

mysqli_free_result() Frees the memory associated


with a result
mysqli_get_charset() Returns a character set object

mysqli_get_client_info() Returns the MySQL client


library version

mysqli_get_client_stats() Returns statistics about client


per-process

mysqli_get_client_version() Returns the MySQL client


library version as an integer

mysqli_get_connection_stats() Returns statistics about the


client connection

mysqli_get_host_info() Returns the MySQL server


hostname and the connection
type

mysqli_get_proto_info() Returns the MySQL protocol


version

mysqli_get_server_info() Returns the MySQL server


version

mysqli_get_server_version() Returns the MySQL server


version as an integer

mysqli_info() Returns information about


the most recently executed
query

mysqli_init() Initializes MySQLi and


returns a resource for use
with mysqli_real_connect()

mysqli_insert_id() Returns the auto-generated id


used in the last query

mysqli_kill() Asks the server to kill a


MySQL thread

mysqli_more_results() Checks if there are more


results from a multi query

mysqli_multi_query() Performs one or more queries


on the database

mysqli_next_result() Prepares the next result set


from mysqli_multi_query()

mysqli_num_fields() Returns the number of fields


in a result set

mysqli_num_rows() Returns the number of rows


in a result set

mysqli_options() Sets extra connect options


and affect behavior for a
connection
mysqli_ping() Pings a server connection, or
tries to reconnect if the
connection has gone down

mysqli_prepare() Prepares an SQL statement


for execution

mysqli_query() Performs a query against the


database

mysqli_real_connect() Opens a new connection to


the MySQL server

mysqli_real_escape_string() Escapes special characters in


a string for use in an SQL
statement

mysqli_real_query() Executes an SQL query

mysqli_reap_async_query() Returns the result from async


query

mysqli_refresh() Refreshes tables or caches, or


resets the replication server
information

mysqli_rollback() Rolls back the current


transaction for the database
mysqli_select_db() Changes the default database
for the connection

mysqli_set_charset() Sets the default client


character set

mysqli_set_local_infile_default() Unsets user defined handler


for load local infile command

mysqli_set_local_infile_handler() Set callback function for


LOAD DATA LOCAL
INFILE command

mysqli_sqlstate() Returns the SQLSTATE


error code for the last
MySQL operation

mysqli_ssl_set() Used to establish secure


connections using SSL

mysqli_stat() Returns the current system


status

mysqli_stmt_init() Initializes a statement and


returns an object for use with
mysqli_stmt_prepare()

mysqli_store_result() Transfers a result set from


the last query
mysqli_thread_id() Returns the thread ID for the
current connection

mysqli_thread_safe() Returns whether the client


library is compiled as thread-
safe

mysqli_use_result() Initiates the retrieval of a


result set from the last query
executed using the
mysqli_real_query()

mysqli_warning_count() Returns the number of


warnings from the last query
in the connection
PHP 5 SimpleXML Functions
❮ PreviousNext ❯

PHP SimpleXML Introduction


SimpleXML is an extension that allows us to easily manipulate and get XML data.

SimpleXML provides an easy way of getting an element's name, attributes and textual
content if you know the XML document's structure or layout.

SimpleXML turns an XML document into a data structure you can iterate through like a
collection of arrays and objects.

Installation
As of PHP 5, the SimpleXML functions are part of the PHP core. No installation is required to
use these functions.

PHP 5 SimpleXML Functions

Function Description

__construct() Creates a new SimpleXMLElement


object

addAttribute() Adds an attribute to the


SimpleXML element

addChild() Adds a child element the


SimpleXML element
asXML() Returns a well-formed XML string
(XML version 1.0) from a
SimpleXML object

attributes() Returns the attributes/values of an


element

children() Returns the children of a specified


node

count() Counts the children of a specified


node

getDocNamespaces() Returns the namespaces


DECLARED in document

getName() Returns the name of the XML tag


referenced by the SimpleXML
element

getNamespaces() Returns the namespaces USED in


document

registerXPathNamespace() Creates a namespace context for the


next XPath query

saveXML() Alias of asXML()

simplexml_import_dom() Returns a SimpleXMLElement


object from a DOM node

simplexml_load_file() Converts an XML file into a


SimpleXMLElement object

simplexml_load_string() Converts an XML string into a


SimpleXMLElement object

xpath() Runs an XPath query on XML data

PHP 5 SimpleXML Iteration Functions

Function Description

current() Returns the current element

getChildren() Returns the child elements of the current


element

hasChildren() Checks whether the current element has


children

key() Return the current key

next() Moves to the next element


PHP 5 String Functions
❮ PreviousNext ❯

PHP 5 String Functions


The PHP string functions are part of the PHP core. No installation is required to use these
functions.

Function Description

addcslashes() Returns a string with backslashes


in front of the specified characters

addslashes() Returns a string with backslashes


in front of predefined characters

bin2hex() Converts a string of ASCII


characters to hexadecimal values

chop() Removes whitespace or other


characters from the right end of a
string

chr() Returns a character from a


specified ASCII value

chunk_split() Splits a string into a series of


smaller parts
convert_cyr_string() Converts a string from one
Cyrillic character-set to another

convert_uudecode() Decodes a uuencoded string

convert_uuencode() Encodes a string using the


uuencode algorithm

count_chars() Returns information about


characters used in a string

crc32() Calculates a 32-bit CRC for a


string

crypt() One-way string hashing

echo() Outputs one or more strings

explode() Breaks a string into an array

fprintf() Writes a formatted string to a


specified output stream

get_html_translation_table() Returns the translation table used


by htmlspecialchars() and
htmlentities()
hebrev() Converts Hebrew text to visual
text

hebrevc() Converts Hebrew text to visual


text and new lines (\n) into <br>

hex2bin() Converts a string of hexadecimal


values to ASCII characters

html_entity_decode() Converts HTML entities to


characters

htmlentities() Converts characters to HTML


entities

htmlspecialchars_decode() Converts some predefined HTML


entities to characters

htmlspecialchars() Converts some predefined


characters to HTML entities

implode() Returns a string from the elements


of an array

join() Alias of implode()

lcfirst() Converts the first character of a


string to lowercase
levenshtein() Returns the Levenshtein distance
between two strings

localeconv() Returns locale numeric and


monetary formatting information

ltrim() Removes whitespace or other


characters from the left side of a
string

md5() Calculates the MD5 hash of a


string

md5_file() Calculates the MD5 hash of a file

metaphone() Calculates the metaphone key of a


string

money_format() Returns a string formatted as a


currency string

nl_langinfo() Returns specific local information

nl2br() Inserts HTML line breaks in front


of each newline in a string

number_format() Formats a number with grouped


thousands
ord() Returns the ASCII value of the
first character of a string

parse_str() Parses a query string into variables

print() Outputs one or more strings

printf() Outputs a formatted string

quoted_printable_decode() Converts a quoted-printable string


to an 8-bit string

quoted_printable_encode() Converts an 8-bit string to a


quoted printable string

quotemeta() Quotes meta characters

rtrim() Removes whitespace or other


characters from the right side of a
string

setlocale() Sets locale information

sha1() Calculates the SHA-1 hash of a


string

sha1_file() Calculates the SHA-1 hash of a


file

similar_text() Calculates the similarity between


two strings

soundex() Calculates the soundex key of a


string

sprintf() Writes a formatted string to a


variable

sscanf() Parses input from a string


according to a format

str_getcsv() Parses a CSV string into an array

str_ireplace() Replaces some characters in a


string (case-insensitive)

str_pad() Pads a string to a new length

str_repeat() Repeats a string a specified


number of times

str_replace() Replaces some characters in a


string (case-sensitive)

str_rot13() Performs the ROT13 encoding on


a string

str_shuffle() Randomly shuffles all characters


in a string

str_split() Splits a string into an array

str_word_count() Count the number of words in a


string

strcasecmp() Compares two strings (case-


insensitive)

strchr() Finds the first occurrence of a


string inside another string (alias
of strstr())

strcmp() Compares two strings (case-


sensitive)

strcoll() Compares two strings (locale


based string comparison)

strcspn() Returns the number of characters


found in a string before any part of
some specified characters are
found

strip_tags() Strips HTML and PHP tags from a


string
stripcslashes() Unquotes a string quoted with
addcslashes()

stripslashes() Unquotes a string quoted with


addslashes()

stripos() Returns the position of the first


occurrence of a string inside
another string (case-insensitive)

stristr() Finds the first occurrence of a


string inside another string (case-
insensitive)

strlen() Returns the length of a string

strnatcasecmp() Compares two strings using a


"natural order" algorithm (case-
insensitive)

strnatcmp() Compares two strings using a


"natural order" algorithm (case-
sensitive)

strncasecmp() String comparison of the first n


characters (case-insensitive)

strncmp() String comparison of the first n


characters (case-sensitive)
strpbrk() Searches a string for any of a set
of characters

strpos() Returns the position of the first


occurrence of a string inside
another string (case-sensitive)

strrchr() Finds the last occurrence of a


string inside another string

strrev() Reverses a string

strripos() Finds the position of the last


occurrence of a string inside
another string (case-insensitive)

strrpos() Finds the position of the last


occurrence of a string inside
another string (case-sensitive)

strspn() Returns the number of characters


found in a string that contains only
characters from a specified
charlist

strstr() Finds the first occurrence of a


string inside another string (case-
sensitive)

strtok() Splits a string into smaller strings


strtolower() Converts a string to lowercase
letters

strtoupper() Converts a string to uppercase


letters

strtr() Translates certain characters in a


string

substr() Returns a part of a string

substr_compare() Compares two strings from a


specified start position (binary
safe and optionally case-sensitive)

substr_count() Counts the number of times a


substring occurs in a string

substr_replace() Replaces a part of a string with


another string

trim() Removes whitespace or other


characters from both sides of a
string

ucfirst() Converts the first character of a


string to uppercase

ucwords() Converts the first character of


each word in a string to uppercase

vfprintf() Writes a formatted string to a


specified output stream

vprintf() Outputs a formatted string

vsprintf() Writes a formatted string to a


variable

wordwrap() Wraps a string to a given number


of characters
PHP XML Parser Functions
❮ PreviousNext ❯

PHP XML Parser Introduction


The XML functions lets you parse, but not validate, XML documents.

XML is a data format for standardized structured document exchange. More information on
XML can be found in our XML Tutorial.

This extension uses the Expat XML parser.

Expat is an event-based parser, it views an XML document as a series of events. When an


event occurs, it calls a specified function to handle it.

Expat is a non-validating parser, and ignores any DTDs linked to a document. However, if
the document is not well formed it will end with an error message.

Because it is an event-based, non validating parser, Expat is fast and well suited for web
applications.

The XML parser functions lets you create XML parsers and define handlers for XML events.

Installation
The XML functions are part of the PHP core. There is no installation needed to use these
functions.

PHP XML Parser Functions


PHP: indicates the earliest version of PHP that supports the function.

Function Description PHP


utf8_decode() Decodes an 3
UTF-8 string
to ISO-8859-
1

utf8_encode() Encodes an 3
ISO-8859-1
string to
UTF-8

xml_error_string() Gets an error 3


string from
the XML
parser

xml_get_current_byte_index() Gets the 3


current byte
index from
the XML
parser

xml_get_current_column_number() Gets the 3


current
column
number from
the XML
parser

xml_get_current_line_number() Gets the 3


current line
number from
the XML
parser
xml_get_error_code() Gets an error 3
code from
the XML
parser

xml_parse() Parses an 3
XML
document

xml_parse_into_struct() Parse XML 3


data into an
array

xml_parser_create_ns() Create an 4
XML parser
with
namespace
support

xml_parser_create() Create an 3
XML parser

xml_parser_free() Free an 3
XML parser

xml_parser_get_option() Get options 3


from an
XML parser

xml_parser_set_option() Set options 3


in an XML
parser
xml_set_character_data_handler() Set handler 3
function for
character
data

xml_set_default_handler() Set default 3


handler
function

xml_set_element_handler() Set handler 3


function for
start and end
element of
elements

xml_set_end_namespace_decl_handler() Set handler 4


function for
the end of
namespace
declarations

xml_set_external_entity_ref_handler() Set handler 3


function for
external
entities

xml_set_notation_decl_handler() Set handler 3


function for
notation
declarations

xml_set_object() Use XML 4


Parser within
an object
xml_set_processing_instruction_handler() Set handler 3
function for
processing
instruction

xml_set_start_namespace_decl_handler() Set handler 4


function for
the start of
namespace
declarations

xml_set_unparsed_entity_decl_handler() Set handler 3


function for
unparsed
entity
declarations

PHP XML Parser Constants

Constant

XML_ERROR_NONE (integer)

XML_ERROR_NO_MEMORY (integer)

XML_ERROR_SYNTAX (integer)
XML_ERROR_NO_ELEMENTS (integer)

XML_ERROR_INVALID_TOKEN (integer)

XML_ERROR_UNCLOSED_TOKEN (integer)

XML_ERROR_PARTIAL_CHAR (integer)

XML_ERROR_TAG_MISMATCH (integer)

XML_ERROR_DUPLICATE_ATTRIBUTE (integer)

XML_ERROR_JUNK_AFTER_DOC_ELEMENT (integer)

XML_ERROR_PARAM_ENTITY_REF (integer)

XML_ERROR_UNDEFINED_ENTITY (integer)

XML_ERROR_RECURSIVE_ENTITY_REF (integer)

XML_ERROR_ASYNC_ENTITY (integer)

XML_ERROR_BAD_CHAR_REF (integer)
XML_ERROR_BINARY_ENTITY_REF (integer)

XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF
(integer)

XML_ERROR_MISPLACED_XML_PI (integer)

XML_ERROR_UNKNOWN_ENCODING (integer)

XML_ERROR_INCORRECT_ENCODING (integer)

XML_ERROR_UNCLOSED_CDATA_SECTION (integer)

XML_ERROR_EXTERNAL_ENTITY_HANDLING (integer)

XML_OPTION_CASE_FOLDING (integer)

XML_OPTION_TARGET_ENCODING (integer)

XML_OPTION_SKIP_TAGSTART (integer)

XML_OPTION_SKIP_WHITE (integer)
PHP Zip File Functions
❮ PreviousNext ❯

PHP Zip File Introduction


The Zip files functions allows you to read ZIP files.

Installation
For the Zip file functions to work on your server, these libraries must be installed:

 The ZZIPlib library by Guido Draheim: Download the ZZIPlib library


 The Zip PECL extension: Download the Zip PECL extension

Installation on Linux Systems

PHP 5+: Zip functions and the Zip library is not enabled by default and must be
downloaded from the links above. Use the --with-zip=DIR configure option to include Zip
support.

Installation on Windows Systems

PHP 5+: Zip functions is not enabled by default, so the php_zip.dll and the ZZIPlib library
must be downloaded from the link above. php_zip.dll must be enabled inside of php.ini.

To enable any PHP extension, the PHP extension_dir setting (in the php.ini file) should be
set to the directory where the PHP extensions are located. An example extension_dir value
is c:\php\ext.

PHP Zip File Functions


PHP: indicates the earliest version of PHP that supports the function.

Function Description PHP


zip_close() Closes a ZIP file 4

zip_entry_close() Closes an entry in the 4


ZIP file

zip_entry_compressedsize() Returns the compressed 4


size of an entry in the
ZIP file

zip_entry_compressionmethod() Returns the 4


compression method of
an entry in the ZIP file

zip_entry_filesize() Returns the actual file 4


size of an entry in the
ZIP file

zip_entry_name() Returns the name of an 4


entry in the ZIP file

zip_entry_open() Opens an entry in the 4


ZIP file for reading

zip_entry_read() Reads from an open 4


entry in the ZIP file

zip_open() Opens a ZIP file 4

zip_read() Reads the next entry in 4


a ZIP file
PHP 5 Timezones
❮ PreviousNext ❯

PHP Supported Timezones


Below is a complete list of the timezones supported by PHP, which are useful with several
PHP date functions.

 Africa
 America
 Antarctica
 Arctic
 Asia
 Atlantic
 Australia
 Europe
 Indian
 Pacific

Africa

Africa/Abidjan Africa/Accra Africa/Addis_Ababa Africa/Algiers Africa/Asmara

Africa/Asmera Africa/Bamako Africa/Bangui Africa/Banjul Africa/Bissau

Africa/Blantyre Africa/Brazzaville Africa/Bujumbura Africa/Cairo Africa/Casablanca

Africa/Ceuta Africa/Conakry Africa/Dakar Africa/Dar_es_Salaam Africa/Djibouti

Africa/Douala Africa/El_Aaiun Africa/Freetown Africa/Gaborone Africa/Harare


Africa/Johannesburg Africa/Juba Africa/Kampala Africa/Khartoum Africa/Kigali

Africa/Kinshasa Africa/Lagos Africa/Libreville Africa/Lome Africa/Luanda

Africa/Lubumbashi Africa/Lusaka Africa/Malabo Africa/Maputo Africa/Maseru

Africa/Mbabane Africa/Mogadishu Africa/Monrovia Africa/Nairobi Africa/Ndjamena

Africa/Niamey Africa/Nouakchott Africa/Ouagadougou Africa/Porto-Novo Africa/Sao_Tome

Africa/Timbuktu Africa/Tripoli Africa/Tunis Africa/Windhoek

America

America/Adak America/Anchorage America/Anguilla

America/Antigua America/Araguaina America/Argentina/Buenos_Aires

America/Argentina/Catamarca America/Argentina/ComodRivadavia America/Argentina/Cordoba

America/Argentina/Jujuy America/Argentina/La_Rioja America/Argentina/Mendoza


America/Argentina/Rio_Gallegos America/Argentina/Salta America/Argentina/San_Juan

America/Argentina/San_Luis America/Argentina/Tucuman America/Argentina/Ushuaia

America/Aruba America/Asuncion America/Atikokan

America/Atka America/Bahia America/Bahia_Banderas

America/Barbados America/Belem America/Belize

America/Blanc-Sablon America/Boa_Vista America/Bogota

America/Boise America/Buenos_Aires America/Cambridge_Bay

America/Campo_Grande America/Cancun America/Caracas

America/Catamarca America/Cayenne America/Cayman

America/Chicago America/Chihuahua America/Coral_Harbour

America/Cordoba America/Costa_Rica America/Creston

America/Cuiaba America/Curacao America/Danmarkshavn


America/Dawson America/Dawson_Creek America/Denver

America/Detroit America/Dominica America/Edmonton

America/Eirunepe America/El_Salvador America/Ensenada

America/Fort_Wayne America/Fortaleza America/Glace_Bay

America/Godthab America/Goose_Bay America/Grand_Turk

America/Grenada America/Guadeloupe America/Guatemala

America/Guayaquil America/Guyana America/Halifax

America/Havana America/Hermosillo America/Indiana/Indianapolis

America/Indiana/Knox America/Indiana/Marengo America/Indiana/Petersburg

America/Indiana/Tell_City America/Indiana/Vevay America/Indiana/Vincennes

America/Indiana/Winamac America/Indianapolis America/Inuvik

America/Iqaluit America/Jamaica America/Jujuy


America/Juneau America/Kentucky/Louisville America/Kentucky/Monticello

America/Knox_IN America/Kralendijk America/La_Paz

America/Lima America/Los_Angeles America/Louisville

America/Lower_Princes America/Maceio America/Managua

America/Manaus America/Marigot America/Martinique

America/Matamoros America/Mazatlan America/Mendoza

America/Menominee America/Merida America/Metlakatla

America/Mexico_City America/Miquelon America/Moncton

America/Monterrey America/Montevideo America/Montreal

America/Montserrat America/Nassau America/New_York

America/Nipigon America/Nome America/Noronha

America/North_Dakota/Beulah America/North_Dakota/Center America/North_Dakota/New_Salem


America/Ojinaga America/Panama America/Pangnirtung

America/Paramaribo America/Phoenix America/Port-au-Prince

America/Port_of_Spain America/Porto_Acre America/Porto_Velho

America/Puerto_Rico America/Rainy_River America/Rankin_Inlet

America/Recife America/Regina America/Resolute

America/Rio_Branco America/Rosario America/Santa_Isabel

America/Santarem America/Santiago America/Santo_Domingo

America/Sao_Paulo America/Scoresbysund America/Shiprock

America/Sitka America/St_Barthelemy America/St_Johns

America/St_Kitts America/St_Lucia America/St_Thomas

America/St_Vincent America/Swift_Current America/Tegucigalpa

America/Thule America/Thunder_Bay America/Tijuana


America/Toronto America/Tortola America/Vancouver

America/Virgin America/Whitehorse America/Winnipeg

America/Yakutat America/Yellowknife

Antarctica

Antarctica/Casey Antarctica/Davis Antarctica/DumontDUrville Antarctica/Macquarie Antarctica/Maw

Antarctica/McMurdo Antarctica/Palmer Antarctica/Rothera Antarctica/South_Pole Antarctica/Syow

Antarctica/Vostok

Arctic

Arctic/Longyearbyen

Asia

Asia/Aden Asia/Almaty Asia/Amman Asia/Anadyr Asia/Aqtau

Asia/Aqtobe Asia/Ashgabat Asia/Ashkhabad Asia/Baghdad Asia/Bahrain

Asia/Baku Asia/Bangkok Asia/Beirut Asia/Bishkek Asia/Brunei


Asia/Calcutta Asia/Choibalsan Asia/Chongqing Asia/Chungking Asia/Colombo

Asia/Dacca Asia/Damascus Asia/Dhaka Asia/Dili Asia/Dubai

Asia/Dushanbe Asia/Gaza Asia/Harbin Asia/Hebron Asia/Ho_Chi_Minh

Asia/Hong_Kong Asia/Hovd Asia/Irkutsk Asia/Istanbul Asia/Jakarta

Asia/Jayapura Asia/Jerusalem Asia/Kabul Asia/Kamchatka Asia/Karachi

Asia/Kashgar Asia/Kathmandu Asia/Katmandu Asia/Khandyga Asia/Kolkata

Asia/Krasnoyarsk Asia/Kuala_Lumpur Asia/Kuching Asia/Kuwait Asia/Macao

Asia/Macau Asia/Magadan Asia/Makassar Asia/Manila Asia/Muscat

Asia/Nicosia Asia/Novokuznetsk Asia/Novosibirsk Asia/Omsk Asia/Oral

Asia/Phnom_Penh Asia/Pontianak Asia/Pyongyang Asia/Qatar Asia/Qyzylorda

Asia/Rangoon Asia/Riyadh Asia/Saigon Asia/Sakhalin Asia/Samarkand

Asia/Seoul Asia/Shanghai Asia/Singapore Asia/Taipei Asia/Tashkent


Asia/Tbilisi Asia/Tehran Asia/Tel_Aviv Asia/Thimbu Asia/Thimphu

Asia/Tokyo Asia/Ujung_Pandang Asia/Ulaanbaatar Asia/Ulan_Bator Asia/Urumqi

Asia/Ust-Nera Asia/Vientiane Asia/Vladivostok Asia/Yakutsk Asia/Yekaterinburg

Asia/Yerevan

Atlantic

Atlantic/Azores Atlantic/Bermuda Atlantic/Canary Atlantic/Cape_Verde Atlantic/Faeroe

Atlantic/Faroe Atlantic/Jan_Mayen Atlantic/Madeira Atlantic/Reykjavik Atlantic/South_Georgia

Atlantic/St_Helena Atlantic/Stanley

Australia

Australia/ACT Australia/Adelaide Australia/Brisbane Australia/Broken_Hill Australia/Canberra

Australia/Currie Australia/Darwin Australia/Eucla Australia/Hobart Australia/LHI

Australia/Lindeman Australia/Lord_Howe Australia/Melbourne Australia/North Australia/NSW

Australia/Perth Australia/Queensland Australia/South Australia/Sydney Australia/Tasmania


Australia/Victoria Australia/West Australia/Yancowinna

Europe

Europe/Amsterdam Europe/Andorra Europe/Athens Europe/Belfast Europe/Belgrade

Europe/Berlin Europe/Bratislava Europe/Brussels Europe/Bucharest Europe/Budapest

Europe/Busingen Europe/Chisinau Europe/Copenhagen Europe/Dublin Europe/Gibraltar

Europe/Guernsey Europe/Helsinki Europe/Isle_of_Man Europe/Istanbul Europe/Jersey

Europe/Kaliningrad Europe/Kiev Europe/Lisbon Europe/Ljubljana Europe/London

Europe/Luxembourg Europe/Madrid Europe/Malta Europe/Mariehamn Europe/Minsk

Europe/Monaco Europe/Moscow Europe/Nicosia Europe/Oslo Europe/Paris

Europe/Podgorica Europe/Prague Europe/Riga Europe/Rome Europe/Samara

Europe/San_Marino Europe/Sarajevo Europe/Simferopol Europe/Skopje Europe/Sofia

Europe/Stockholm Europe/Tallinn Europe/Tirane Europe/Tiraspol Europe/Uzhgorod

Europe/Vaduz Europe/Vatican Europe/Vienna Europe/Vilnius Europe/Volgograd


Europe/Warsaw Europe/Zagreb Europe/Zaporozhye Europe/Zurich

Indian

Indian/Antananarivo Indian/Chagos Indian/Christmas Indian/Cocos Indian/Comoro

Indian/Kerguelen Indian/Mahe Indian/Maldives Indian/Mauritius Indian/Mayotte

Indian/Reunion

Pacific

Pacific/Apia Pacific/Auckland Pacific/Chatham Pacific/Chuuk Pacific/Easter

Pacific/Efate Pacific/Enderbury Pacific/Fakaofo Pacific/Fiji Pacific/Funafuti

Pacific/Galapagos Pacific/Gambier Pacific/Guadalcanal Pacific/Guam Pacific/Honolulu

Pacific/Johnston Pacific/Kiritimati Pacific/Kosrae Pacific/Kwajalein Pacific/Majuro

Pacific/Marquesas Pacific/Midway Pacific/Nauru Pacific/Niue Pacific/Norfolk

Pacific/Noumea Pacific/Pago_Pago Pacific/Palau Pacific/Pitcairn Pacific/Pohnpei

Pacific/Ponape Pacific/Port_Moresby Pacific/Rarotonga Pacific/Saipan Pacific/Samoa


Pacific/Tahiti Pacific/Tarawa Pacific/Tongatapu Pacific/Truk Pacific/Wake

Pacific/Wallis Pacific/Yap

Potrebbero piacerti anche