Per connectar un fitxer addicional a un script PHP, utilitzeu la funció especial include. Després de connectar un document extern, el programador té l'oportunitat d'utilitzar el codi escrit o qualsevol altre contingut de l'aplicació actual.
Inclou la funció
Inclou té la sintaxi següent:
incloure "nom del fitxer";
El nom és un camí d'accés relatiu o absolut amb l'extensió del document inclòs. Si no s'especifica cap ubicació, PHP comprovarà automàticament el contingut de la configuració php.ini, que especifica include_path: un directori on es poden col·locar biblioteques addicionals. Si la directiva està buida o el fitxer requerit no es troba al camí especificat, s'ignorarà l'expressió d'inclusió.
Un cop activat, podeu utilitzar el contingut que vulgueu a l'script, assignar variables, utilitzar construccions declarades, etc. Per exemple, hi ha 2 fitxers 1.php i 2.php. El contingut de 1.php té aquest aspecte:
<? php
$ primer = "variable del primer fitxer";
$ segon = "valor importat";
?>
Per incloure les variables anteriors a 2.php, podeu realitzar l'operació següent:
<? php
Incloeu "1.php";
ressò $ primer;
$ emerge = "$ segon";
echo $ emergir; ?>
En aquest script del segon fitxer, l'ordre include inclou el contingut del primer document, després del qual s'utilitzen les variables declarades a 1.php per mostrar els valors necessaris a la pantalla.
Incloure es pot utilitzar tant al principi del fitxer com dins de la funció declarada a qualsevol part del document. No és desitjable utilitzar la funció per connectar fitxers ubicats en un servidor remot. Si voleu implementar aquesta característica, haureu d'activar l'opció allow_url_fopen al fitxer php.ini al vostre servidor local o remot.
Requerir
La funció require és similar a la d’incloure. Les ordres no difereixen en sintaxi i tecnologia d'execució. L'única diferència és que si falta el fitxer especificat, requereix que finalitzi l'script, mentre que include continuarà executant l'script i mostrarà l'advertiment E_WARNING corresponent, que es pot suprimir mitjançant el caràcter especial @. Per exemple:
<? php
requereixen "1q.php";
eco "Script deixa de funcionar"; ?>
En aquest exemple, s'especifica el camí d'accés al document inexistent 1q.php. Si falta el fitxer, l'script no executarà l'ordre echo i la pantalla de l'usuari mostrarà un full en blanc o un missatge d'error (segons la configuració de php.ini). Si introduïu un codi similar fent servir include:
<? php
incloure "1q.php";
ressò "Script continua"; ?>
L'ordre echo s'executarà i el text corresponent apareixerà a la pantalla.
