PHP includes are a great way to make editing sites easier. By creating a template and replacing the content with this PHP script, it will allow the page to get separate content files, with only the content in them. This is helpful as only one file needs to be changed when the template is edited.
PHP is generally better than SSI (server-side includes) since it allows for much more to happen. The below script has error-checking, default pages, and other features which SSI is not as well suited for.
The first thing to understand is how we get the content. The three main functions I like to use are
include,
require, and
file_get_contents. There are other ways, but these three are the most common and appropriate for what we are doing.
include
The include function is used to take the exact code from a file. The code is parsed (which means any PHP code in the file will be run), and then placed exactly where the include is (in PHP's memory, this will not change your file.)
require
The require function is identical to include. The only difference is that it stops the script's execution if the file does not exist.
file_get_contents
The file_get_contents function is most similar to an include. This function does not parse the specified file, making it ideal for scripts only including text. It is also much faster than an include.
For the following examples, I will be using file_get_contents, since it is more efficient than include, and most cases will not involve files using PHP. I would also like to note that the files may be of any type, so you can include a .dat, .php, .txt, or any file wanted.
Code so far:
PHP Code:
<?php
file_get_contents('file.txt');
?>
Next, we will check if the file being included exists. This eliminates the need to use require, and allows the specification of a default page. The function used is
file_exists.
Code so far:
PHP Code:
<?php
$file = 'file.txt';
$default = 'default.txt';
if(file_exists($file))
{
file_get_contents($file);
}
elseif(file_exists($default))
{
file_get_contents($default);
}
else
{
echo 'Could not find any files!';
}
?>
With the above code, you will notice two file_exists. These check to make sure both the requested and default file exist, and allow for an error message if neither is found.
Most instances for using this code will require a file to be included based on a variable. We will assume that variable is stored in $_GET['page']. (The URL would look like: index.php?page=info)
The problem with the above method, is that someone could specify the path to a file containing your passwords, and effectively gain access to your system. To prevent this, I append the file type to the $_GET variable.
Final Code:
PHP Code:
<?php
$ext = '.txt';
$file = $_GET['page'].$ext;
$default = 'default'.$ext;
if(file_exists($file))
{
file_get_contents($file);
}
elseif(file_exists($default))
{
file_get_contents($default);
}
else
{
echo 'Could not find any files!';
}
?>
Believe it or not, that is all there is to it. This code can safely and efficiently include any file, and allows for a default file if none other if found.
Linear Mode
