Skip to main content

require ()

La funció require() a PHP és un constructe del llenguatge que inclou i executa el contingut d'un fitxer especificat en l'script actual.

A diferència d'include(), si el fitxer especificat a require() no es pot trobar, PHP detindrà l'execució de l'script immediatament i generarà un error fatal. Aquest comportament és ideal per a fitxers que són imprescindibles per al correcte funcionament de l'aplicació, com ara arxius de configuració, classes o llibreries de funcions essencials.

Exemples i casos d'ús

require() s'utilitza habitualment per a:

  • Fitxers de configuració: Per carregar les dades de connexió a la base de dades o les credencials de l'API. L'aplicació no podria funcionar sense aquestes dades, per tant, un error fatal és el comportament desitjat.

  • Classes i llibreries: Per incloure arxius que contenen definicions de classes o funcions que es faran servir més endavant a l'script. Sense ells, l'aplicació fallaria.

  • Maquetes i plantilles: Per carregar parts del disseny de la pàgina que són obligatòries, com una capçalera o un menú de navegació.

Require configuració

 

Arxiu: config.php

<?php
// fitxer: 'config.php'
define('DB_HOST', 'localhost');
define('DB_USER', 'root');
define('DB_PASS', 'password');

Arxiu: index.php

 

<?php
// fitxer: 'index.php'
// Si 'config.php' no existeix, l'script s'aturarà
require 'config.php';

// Ara podem usar les constants que hem definit
echo "Connectant a la base de dades en: " . DB_HOST;

En aquest cas, si config.php no es troba, l'script index.php s'aturarà, evitant que el codi s'executi sense la configuració necessària. Per a la majoria d'aplicacions, require_once() és la millor opció, ja que evita errors de redefinició si un mateix fitxer es crida accidentalment més d'una vegada.

Back to top