svn: /phpdoc/bg/trunk/language/control-structures/ include-once.xml
[email protected] (Stanislav Yordanov) Thu, 07 Jan 2016 13:12:19 +0000
| Newsgroups | php.doc.bg |
|---|---|
| Message-ID | <[email protected]> |
stanprog Thu, 07 Jan 2016 13:12:19 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=338420
Log:
sync to EN
Changed paths:
U phpdoc/bg/trunk/language/control-structures/include-once.xml
Modified: phpdoc/bg/trunk/language/control-structures/include-once.xml
===================================================================
--- phpdoc/bg/trunk/language/control-structures/include-once.xml 2016-01-07 13:03:06 UTC (rev 338419)
+++ phpdoc/bg/trunk/language/control-structures/include-once.xml 2016-01-07 13:12:19 UTC (rev 338420)
@@ -1,9 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: kouber Status: ready -->
-
+<!-- EN-Revision: 337130 Maintainer: stanprog Status: ready -->
+<!-- Reviewed: no Maintainer: stanprog -->
+<!-- CREDITS: kouber -->
<sect1 xml:id="function.include-once" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title><function>include_once</function></title>
+ <title>include_once</title>
+ <?phpdoc print-version-for="include_once"?>
<para>
Инструкцията <function>include_once</function> включва и изпълнява
даден файл по време на изпълнението на скрипт.
@@ -13,17 +15,15 @@
включен точно веднъж (once).
</para>
<para>
- <function>include_once</function> би трябвало да бъде използвана на места, където
+ <literal>include_once</literal> би трябвало да бъде използвана на места, където
е възможно един и същи файл да бъде включен и изпълнен повече от веднъж
по време на специфично изпълнение на скрипт, и когато искате да сте сигурни,
че файлът ще бъде включен точно един път, за да се избегнат проблеми с повторно
дефиниране на функции, повторно присвояване на променливи, и т.н.
</para>
<para>
- За повече примери, показващи употребата на <function>require_once</function> и
- <function>include_once</function>, разгледайте
- <link xlink:href="&url.php.pear;">PEAR</link> кода, включен в последната дистрибуция
- на PHP.
+ За повече примери, показващи употребата на <function>require_once</function>,
+ разгледайте <function>include</function>.
</para>
<para>
Връщаните стойности са същите както при <function>include</function>. Ако файлът вече е бил
@@ -32,26 +32,18 @@
<para>
<note>
<para>
- <function>include_once</function> е добавена в PHP 4.0.1
- </para>
- </note>
- </para>
- <para>
- <note>
- <para>
- Отбележете, че поведението на <function>include_once</function>
- и <function>require_once</function> може да бъде различно от очакваното
- на операционни системи нечувствителни към регистъра (като Windows).
- <example>
- <title><function>include_once</function> е нечувствителна към регистъра под Windows</title>
- <programlisting role="php">
+ От PHP 4 функционалността <literal>_once</literal> се различава, при
+ операционни системи нечувствителни към регистъра (като Windows), например:
+ <example>
+ <title><function>include_once</function> е нечувствителна към регистъра под Windows</title>
+ <programlisting role="php">
<![CDATA[
<?php
include_once "a.php"; // това ще включи a.php
include_once "A.php"; // това отново ще включи a.php под Windows! (само в PHP 4)
?>
]]>
- </programlisting>
+ </programlisting>
</example>
Поведението се промени в PHP 5 - пътят първо се нормализира така, че
<filename>C:\PROGRA~1\A.php</filename> да стане
@@ -59,14 +51,6 @@
</para>
</note>
</para>
- &warn.no-win32-fopen-wrapper;
- <para>
- Вж. също <function>include</function>,
- <function>require</function>, <function>require_once</function>,
- <function>get_required_files</function>,
- <function>get_included_files</function>, <function>readfile</function>
- и <function>virtual</function>.
- </para>
</sect1>
<!-- Keep this comment at the end of the file