include ()

Les funcions include, require i les seves variants include_once i require_once són constructes del llenguatge PHP que permeten incloure i executar el contingut d'un fitxer en un altre. Són essencials per organitzar el codi, reutilitzar components i mantenir una estructura modular en les aplicacions web.

La funció include() llegeix el codi d'un fitxer i l'executa dins de l'script actual.

• Comportament: Si el fitxer no es pot trobar o hi ha un error en l'execució, include() genera un advertiment (warning), però l'script continua la seva execució.

• Casos d'ús: S'utilitza per a fitxers que no són crítics per al funcionament de la pàgina, com ara plantilles de capçaleres, peus de pàgina o blocs de contingut secundari.

<?php
include 'capcalera.php'; // Si 'capcalera.php' no existeix, l'script continua
echo "Això és el contingut principal.";

És molt habitual fer servir include per modularitzar una aplicació web, ja que permet reutilitzar codi i mantenir una estructura de fitxers ordenada. Aquí tens exemples pràctics d'ús tant per a elements HTML com per a funcions PHP.

Incloure elements HTML

Imaginem que volem tenir una capçalera i un peu de pàgina que es repeteixen a totes les teves pàgines.

Arxiu: header.php

<!DOCTYPE html>
<html lang="ca">
<head>
    <meta charset="UTF-8">
    <title>La Meva Web</title>
    <link rel="stylesheet" href="estils.css">
</head>
<body>
<header>
    <h1>Benvingut a la meva pàgina</h1>
    <nav>
        <a href="index.php">Inici</a>
        <a href="productes.php">Productes</a>
        <a href="contacte.php">Contacte</a>
    </nav>
</header>

Arxiu: footer.php

<footer>
    <p>&copy; <?php echo date("Y"); ?> La Meva Web. Tots els drets reservats.</p>
</footer>
</body>
</html>

Arxiu: index.php

<?php
// Inclou la capçalera
include 'header.php';
?>

<main>
    <h2>Pàgina d'inici</h2>
    <p>Aquest és el contingut principal de la pàgina. Aquí pots afegir text, imatges i altres elements.</p>
</main>

<?php
// Inclou el peu de pàgina
include 'footer.php';
?>

D'aquesta forma si volem canviar un enllaç al menú de navegació o l'any del copyright, només cal modificar els fitxers header.php o footer.php, i els canvis es reflectiran automàticament a totes les pàgines que els inclouen.

Incloure funcions PHP

Imaginem que tenim un conjunt de funcions útils que volem poder utilitzar en diferents scripts.

Arxiu: utils.php

<?php
// Aquest fitxer conté funcions reutilitzables
function sumar($a, $b) {
    return $a + $b;
}

function multiplicar($a, $b) {
    return $a * $b;
}

function format_data($data) {
    return date('d/m/Y', strtotime($data));
}

Arxiu: calculs.php

<?php
// Inclou el fitxer amb les funcions
// S'utilitza 'require_once' per assegurar-nos que només es carrega una vegada
include 'utils.php';

// Ara ja podem fer servir les funcions
$resultat_suma = sumar(10, 5);
echo "La suma de 10 i 5 és: " . $resultat_suma . "<br>";

$resultat_multiplicacio = multiplicar(4, 8);
echo "La multiplicació de 4 i 8 és: " . $resultat_multiplicacio . "<br>";

$data_actual = format_data('now');
echo "La data d'avui és: " . $data_actual;

Atenció! Al utilitzar include 'utils.php' podem provocar que aquestes funcions s'incorporessin al codi més d'una vegada, en aquests casos es preferible utilitzar la variant once