mirror of
https://github.com/php/doc-es.git
synced 2026-03-25 16:02:13 +01:00
9766dde380
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@337136 c90b9560-bf6c-de11-be94-00142212c4b1
73 lines
2.6 KiB
XML
73 lines
2.6 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 3efd70fb909c4c97fb07dc6708a0a10ace8414fb Maintainer: seros Status: ready -->
|
|
<!-- Reviewed: yes Maintainer: seros -->
|
|
|
|
<sect1 xml:id="function.include-once" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<title>include_once</title>
|
|
<?phpdoc print-version-for="include_once"?>
|
|
<para>
|
|
La sentencia <literal>include_once</literal> incluye y evalúa
|
|
el fichero especificado durante la ejecución del script.
|
|
Tiene un comportamiento similar al de la sentencia <function>include</function>,
|
|
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.
|
|
</para>
|
|
<para>
|
|
<literal>include_once</literal> 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.
|
|
</para>
|
|
<para>
|
|
Véase la documentación de <function>include</function> para más información sobre
|
|
cómo funciona esta función.
|
|
</para>
|
|
<para>
|
|
<note>
|
|
<para>
|
|
Con PHP 4, la funcionalidad de <literal>_once</literal> difiere entre sistemas operativos
|
|
que ignoran las mayúsculas/minúsculas (como Windows). Por ejemplo:
|
|
<example>
|
|
<title><literal>include_once</literal> con un SO que no distinque mayúsculas de minúsculas en PHP 4</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
include_once "a.php"; // esto incluirá a.php
|
|
include_once "A.php"; // esto incluirá a.php ¡otra vez! (sólo PHP 4)
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
<para>
|
|
Este comportamiento cambió en PHP 5, así que, por ejemplo con Windows primero se normaliza la ruta para que
|
|
<filename>C:\PROGRA~1\A.php</filename> sea identificado con
|
|
<filename>C:\Program Files\a.php</filename> y el fichero sea incluido sólo una vez.
|
|
</para>
|
|
</note>
|
|
</para>
|
|
</sect1>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|