(PHP 4, PHP 5, PHP 7)
La sentencia include_once incluye y evalúa
el fichero especificado durante la ejecución del script.
Tiene un comportamiento similar al de la sentencia include,
siendo la única diferencia de que si el código del fichero ya ha
sido incluido, no se volverá a incluir, e include_once devolverá TRUE. Como su nombre indica,
el fichero será incluido solamente una vez.
include_once se puede utilizar en casos donde el mismo fichero podría ser incluido y evaluado más de una vez durante una ejecución particular de un script, así que en este caso, puede ser de ayuda para evitar problemas como la redefinición de funciones, reasignación de valores de variables, etc.
Véase la documentación de include para más información sobre cómo funciona esta función.
Nota:
Con PHP 4, la funcionalidad de _once difiere entre sistemas operativos que ignoran las mayúsculas/minúsculas (como Windows). Por ejemplo:
Ejemplo #1 include_once con un SO que no distinque mayúsculas de minúsculas en PHP 4
<?php
include_once "a.php"; // esto incluirá a.php
include_once "A.php"; // esto incluirá a.php ¡otra vez! (sólo PHP 4)
?>Este comportamiento cambió en PHP 5, así que, por ejemplo con Windows primero se normaliza la ruta para que C:\PROGRA~1\A.php sea identificado con C:\Program Files\a.php y el fichero sea incluido sólo una vez.