? Include in PHP

The include statement in PHP is used to insert the contents of one PHP file into another PHP file. This is very useful for including common elements in multiple pages, such as headers, footers, or database connection files.

1. Basic include Statement

The include statement allows you to include a file and run the code inside it. If the file is not found, PHP will generate a warning but the script will continue executing.

Syntax:

include 'filename.php';

Example: Basic Usage of include

<?php// Including another fileinclude 'header.php';?><h1>Welcome to My Website</h1><?php// Including footer fileinclude 'footer.php';?>

In this example:

• The header.php file is included at the top of the page, which might contain a navigation bar or other common elements.

• The footer.php file is included at the bottom of the page, which could contain a footer or copyright notice.

2. include_once Statement

The include_once statement ensures that a file is included only once, even if it is called multiple times. This prevents issues such as functions being redefined or variables being overwritten.

Syntax:

include_once 'filename.php';

Example: Using include_once

<?php// Including the file only onceinclude_once 'header.php';include_once 'header.php';  // This will be ignored?>

In this example, header.php will only be included once, even if the include_once is called multiple times.

3. require vs include

• include: If the file cannot be found or is missing, it generates a warning, but the script will continue executing.

• require: If the file cannot be found or is missing, it generates a fatal error and stops script execution.

Example: Using require

<?php// This will stop the script if the file is not foundrequire 'header.php';?>

require is typically used for essential files (like configuration files or important libraries) because it stops the script if the file is missing, whereas include can be used for non-essential files.

4. require_once vs include_once

• require_once: This works the same as require, but it ensures that the file is included only once, even if it's included multiple times.

• include_once: This works the same as include, but it ensures that the file is included only once.

Example: Using require_once

<?php// Ensures the file is included only once and halts if not foundrequire_once 'config.php';?>

5. File Paths in include and require

You can specify file paths when including files. You can use relative or absolute paths.

Example: Including Files with Relative Path

<?phpinclude 'includes/header.php';  // Relative path?>

Example: Including Files with Absolute Path

<?phpinclude '/var/www/html/includes/header.php';  // Absolute path?>

6. Error Handling for include

To avoid warnings when including a missing file, you can use error control operators like @.

Example: Error Control with @ Operator

<?php// Suppresses error if the file is missing@include 'nonexistent-file.php';?>

Using @ will suppress warnings, but it's generally not recommended for production code because it hides potential issues.

Summary of include, include_once, require, require_once:

• include: Includes and runs a file. Generates a warning if the file is missing but continues executing.

• include_once: Includes a file only once, even if called multiple times.

• require: Includes a file and halts the script if the file is missing (fatal error).

• require_once: Includes a file only once and halts the script if the file is missing.