documentation updates and newly translated files by Kirill P.

(with some modifications by me)


git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@227316 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Antony Dovgal
2007-01-15 18:10:33 +00:00
parent e759c9636f
commit ce946f23e6
13 changed files with 796 additions and 325 deletions

View File

@ -1,60 +1,70 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.4 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.20 -->
<refentry id="function.apache-child-terminate">
<refnamediv>
<refname>apache_child_terminate</refname>
<refpurpose>Завершить процесс Apache по окончании текущего запроса</refpurpose>
</refnamediv>
<refsect1>
<title>Описание</title>
<methodsynopsis>
<type>bool</type><methodname>apache_child_terminate</methodname>
<void/>
</methodsynopsis>
<para>
Функция <function>apache_child_terminate</function> регистрирует процесс Apache,
обслуживающий текущий запрос PHP с тем, чтобы завершить его по окончании
выполнения PHP скрипта. Эта функция может быть использована для
завершения процесса, для работы которого понадобилось значительное
количество оперативной памяти, не возвращенной операционной системе
по завершении работы PHP скрипта.
</para>
<note>
<simpara>
Доступность использования этой функции определяется опцией
<option>apache.child_terminate</option> в файле &php.ini;, которая по умолчанию
установлена в <literal>off</literal>.
</simpara>
<simpara>
Эта функция также недоступна на многопоточных версиях Apache, например,
для платформ Windows.
</simpara>
</note>
<para>
Также ознакомьтесь с функцией <function>exit</function>.
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.6 $ -->
<refentry id="function.apache-child-terminate">
<refnamediv>
<refname>apache_child_terminate</refname>
<refpurpose>Завершить процесс Apache по окончании текущего запроса</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>apache_child_terminate</methodname>
<void/>
</methodsynopsis>
<para>
Функция <function>apache_child_terminate</function> регистрирует процесс Apache,
обслуживающий текущий запрос PHP с тем, чтобы завершить его по окончании
выполнения PHP скрипта. Эта функция может быть использована для
завершения процесса, для работы которого понадобилось значительное
количество оперативной памяти, не возвращенной операционной системе
по завершении работы PHP скрипта.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает &true;, если PHP работает в качестве Apache 1 модуля, версия Apache не является
многопоточной и параметр конфигурации PHP
<link linkend="ini.child-terminate">child_terminate</link> установлен в <literal>on</literal>
(по-умолчанию <literal>off</literal>). В противном случае функция возвратит &false;
и сгенерирует ошибку уровня <constant>E_WARNING</constant>.
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&note.no-windows;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>exit</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->

View File

@ -0,0 +1,103 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.apache-get-modules">
<refnamediv>
<refname>apache_get_modules</refname>
<refpurpose>Получить список загруженных модулей сервера Apache</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>apache_get_modules</methodname>
<void/>
</methodsynopsis>
<para>
Получить список загруженных модулей сервера Apache.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает массив загруженных модулей сервера Apache.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.0.0</entry>
<entry>
Стала доступна при использовании PHP в качестве как Apache 1, так и Apache 2
<emphasis>filter</emphasis> API. Ранее это было возможно только для Apache 2
<emphasis>handler</emphasis> API.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>apache_get_modules</function></title>
<programlisting role="php">
<![CDATA[
<?php
print_r(apache_get_modules());
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Array
(
[0] => core
[1] => http_core
[2] => mod_so
[3] => sapi_apache2
[4] => mod_mime
[5] => mod_rewrite
)
]]>
</screen>
</example>
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->

View File

@ -0,0 +1,116 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.apache-getenv">
<refnamediv>
<refname>apache_getenv</refname>
<refpurpose>Получить переменную окружения подпроцесса сервера Apache</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>apache_getenv</methodname>
<methodparam><type>string</type><parameter>variable</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>walk_to_top</parameter></methodparam>
</methodsynopsis>
<para>
Получить переменную окружения сервера Apache, указанную параметром
<parameter>variable</parameter>.
</para>
<para>
Эта функция требует Apache 2, в противном случае она неопределена.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>variable</parameter></term>
<listitem>
<para>
Переменная окружения сервера Apache
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>walk_to_top</parameter></term>
<listitem>
<para>
Пробовать ли получить переменную вержнего уровня, доступную для всех
уровней сервера Apache.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Значение переменной окружения сервера Apache в случае успеха или &false;
при неудаче.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>apache_getenv</function> example</title>
<para>
Приведенный ниже пример показывает, как можно получить значение переменной окружения сервера Apache
<varname>SERVER_ADDR</varname>.
</para>
<programlisting role="php">
<![CDATA[
<?php
$ret = apache_getenv("SERVER_ADDR");
echo $ret;
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
42.24.42.240
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>apache_setenv</function></member>
<member><function>getenv</function></member>
<member><link linkend="language.variables.superglobals">Суперглобальные переменные</link></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->

View File

@ -1,75 +1,139 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.2 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -->
<refentry id="function.apache-lookup-uri">
<refnamediv>
<refname>apache_lookup_uri</refname>
<refpurpose>
Осуществить частичный запрос на указанный URI и вернуть
все полученные сведения
</refpurpose>
</refnamediv>
<refsect1>
<title>Описание</title>
<methodsynopsis>
<type>object</type><methodname>apache_lookup_uri</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Эта функция осущестслвяет частичный запрос на указанный URI
и, проведя анализ полученных данных, возвращает их в классе.
Свойствами возвращаемого класса являются:
<simplelist>
<member>status</member>
<member>the_request</member>
<member>status_line</member>
<member>method</member>
<member>content_type</member>
<member>handler</member>
<member>uri</member>
<member>filename</member>
<member>path_info</member>
<member>args</member>
<member>boundary</member>
<member>no_cache</member>
<member>no_local_copy</member>
<member>allowed</member>
<member>send_bodyct</member>
<member>bytes_sent</member>
<member>byterange</member>
<member>clength</member>
<member>unparsed_uri</member>
<member>mtime</member>
<member>request_time</member>
</simplelist>
</para>
<note>
<simpara>
Функция <function>apache_lookup_uri</function> доступна только в том случае,
если PHP работает в качестве модуля Apache.
</simpara>
</note>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.6 $ -->
<refentry id="function.apache-lookup-uri">
<refnamediv>
<refname>apache_lookup_uri</refname>
<refpurpose>Осуществить частичный запрос на указанный URI и вернуть все полученные сведения</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>object</type><methodname>apache_lookup_uri</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Эта функция осуществляет частичный запрос на указанный URI.
Этого достаточно для получения всей важной информации
о переданном функцию ресурсе.
</para>
&apache.req.module;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Имя файла (URI), который запрашивается.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Объект содержащий информацию о переданном URI. Свойствами
данного объекта являются:
</para>
<para>
<simplelist>
<member>status</member>
<member>the_request</member>
<member>status_line</member>
<member>method</member>
<member>content_type</member>
<member>handler</member>
<member>uri</member>
<member>filename</member>
<member>path_info</member>
<member>args</member>
<member>boundary</member>
<member>no_cache</member>
<member>no_local_copy</member>
<member>allowed</member>
<member>send_bodyct</member>
<member>bytes_sent</member>
<member>byterange</member>
<member>clength</member>
<member>unparsed_uri</member>
<member>mtime</member>
<member>request_time</member>
</simplelist>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>apache_lookup_uri</function></title>
<programlisting role="php">
<![CDATA[
<?php
$info = apache_lookup_uri('index.php?var=value');
print_r($info);
if (file_exists($info->filename)) {
echo 'file exists!';
}
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
stdClass Object
(
[status] => 200
[the_request] => GET /dir/file.php HTTP/1.1
[method] => GET
[mtime] => 0
[clength] => 0
[chunked] => 0
[content_type] => application/x-httpd-php
[no_cache] => 0
[no_local_copy] => 1
[unparsed_uri] => /dir/index.php?var=value
[uri] => /dir/index.php
[filename] => /home/htdocs/dir/index.php
[args] => var=value
[allowed] => 0
[sent_bodyct] => 0
[bytes_sent] => 0
[request_time] => 1074282764
)
file exists!
]]>
</screen>
</example>
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->

View File

@ -1,50 +1,79 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.2 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -->
<refentry id="function.apache-note">
<refnamediv>
<refname>apache_note</refname>
<refpurpose>Установить и получить аннотации к запросу Apache</refpurpose>
</refnamediv>
<refsect1>
<title>Описание</title>
<methodsynopsis>
<type>string</type><methodname>apache_note</methodname>
<methodparam><type>string</type><parameter>note_name</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>note_value</parameter></methodparam>
</methodsynopsis>
<para>
Функция <function>apache_note</function> является функцией, предназначенной
для работы в среде сервера Apache. Ее действиями является установка и чтение
значений из таблицы <literal>аннотаций</literal> к запросам. Если
функция вызывается с одним параметром, она возвращает текущее значение
аннотации <literal>наименование_аннотации</literal>. Если функция
вызывается с двумя параметрами, она устанавливает аннотацию
<literal>наименование_аннотации</literal> в
<literal>содержание_аннотации</literal> и возвращает предыдущее значение
<literal>наименование_аннотации</literal>.
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.6 $ -->
<refentry id="function.apache-note">
<refnamediv>
<refname>apache_note</refname>
<refpurpose>Установить и получить аннотации к запросу Apache</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>apache_note</methodname>
<methodparam><type>string</type><parameter>note_name</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>note_value</parameter></methodparam>
</methodsynopsis>
<para>
Функция <function>apache_note</function> является специфичной для сервера Apache,
которая получает и устанавливает значения в таблице
<literal>notes</literal> запроса.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>note_name</parameter></term>
<listitem>
<para>
Название аннотации.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>note_value</parameter></term>
<listitem>
<para>
Значение аннотации.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Если функция вызывается с одним аргументом, она возвращает текущее значение
аннотации <literal>note_name</literal>. Если функция
вызывается с двумя аргументами, она устанавливает значение аннотации
<literal>note_name</literal> в <literal>note_value</literal>
и возвращает предыдущее значение аннотации <literal>note_name</literal>.
Если значение аннотации не может быть получено, будет возвращено &false;.
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->

View File

@ -1,11 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.1 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -->
<!-- $Revision: 1.6 $ -->
<refentry id="function.apache-request-headers">
<refnamediv>
<refname>apache_request_headers</refname>
<refpurpose>Осуществить выборку всех заголовков HTTP запросов</refpurpose>
<refpurpose>Получить список всех заголовков HTTP запроса</refpurpose>
</refnamediv>
<refsect1>
<title>Описание</title>
@ -21,7 +19,7 @@
</para>
<note>
<para>
В версиях PHP, более ранних, чем 4.3.0, функция
В версиях PHP до 4.3.0, функция
<function>apache_request_headers</function> имела наименование
<function>getallheaders</function>. В PHP версии 4.3.0 и последующих
версиях, имя <function>getallheaders</function> является псевдонимом

View File

@ -0,0 +1,59 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.apache-reset-timeout">
<refnamediv>
<refname>apache_reset_timeout</refname>
<refpurpose>Сбросить таймер сервера Apache</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>apache_reset_timeout</methodname>
<void/>
</methodsynopsis>
<para>
<function>apache_reset_timeout</function> сбрасывает таймер сервера Apache,
который по-умолчанию установлен в 300 секунд. При <literal>set_time_limit(0);
ignore_user_abort(true)</literal> и периодических вызовах
<function>apache_reset_timeout</function>, Apache теоретически может
работать вечно.
</para>
<para>
Эта функция требует Apache 1.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&note.sm.disabled;
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->

View File

@ -1,12 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.2 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -->
<!-- $Revision: 1.7 $ -->
<refentry id="function.apache-response-headers">
<refnamediv>
<refname>apache_response_headers</refname>
<refpurpose>
Осуществить выборку всех заголовков HTTP ответа
Получить список всех заголовков HTTP ответа
</refpurpose>
</refnamediv>
<refsect1>
@ -17,12 +15,11 @@
</methodsynopsis>
<para>
Возвращает массив, содержащий все заголовки ответа Apache.
Эта функция
доступна только для версий PHP >= 4.3.0.
Эта функция доступна только для версий PHP >= 4.3.0.
</para>
<para>
Также ознакомьтесь с функцией <function>getallheaders</function> и
функцией <function>headers_sent</function>.
См. также <function>getallheaders</function> и
<function>headers_sent</function>.
</para>
</refsect1>
</refentry>

View File

@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.2 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.7 -->
<!-- $Revision: 1.5 $ -->
<refentry id="function.apache-setenv">
<refnamediv>
<refname>apache_setenv</refname>

View File

@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.2 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.10 -->
<!-- $Revision: 1.5 $ -->
<refentry id="function.ascii2ebcdic">
<refnamediv>
<refname>ascii2ebcdic</refname>
@ -22,7 +20,7 @@
данными) и возвращает резальтат.
</para>
<para>
Также ознакомьтесь с обратной функцией <function>ebcdic2ascii</function>
Также ознакомьтесь с обратной функцией <function>ebcdic2ascii</function>.
</para>
</refsect1>
</refentry>

View File

@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.2 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.10 -->
<!-- $Revision: 1.5 $ -->
<refentry id="function.ebcdic2ascii">
<refnamediv>
<refname>ebcdic2ascii</refname>
@ -22,7 +20,7 @@
использования с двоичными данными) и возвращает результат.
</para>
<para>
Также ознакомьтесь с обратной функцией <function>ascii2ebcdic</function>
Также ознакомьтесь с обратной функцией <function>ascii2ebcdic</function>.
</para>
</refsect1>
</refentry>

View File

@ -1,58 +1,95 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.4 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -->
<refentry id="function.getallheaders">
<refnamediv>
<refname>getallheaders</refname>
<refpurpose>Получить все заголовки HTTP-запроса</refpurpose>
</refnamediv>
<refsect1>
<title>Описание</title>
<methodsynopsis>
<type>array</type><methodname>getallheaders</methodname>
<void/>
</methodsynopsis>
<para>
Функция <function>getallheaders</function> является псевдонимом
для функции <function>apache_request_headers</function>. Эта
функция возвращает ассоциативный массив, содержащий все
заголовки текущего HTTP-запроса. Для получения более подробных
сведений о работе этой функции обратитесь к описанию
функции <function>apache_request_headers</function>.
</para>
<note>
<para>
В PHP 4.3.0 функция <function>getallheaders</function> стала
псевдонимом для функции <function>apache_request_headers</function>.
Соответствующим образом, она была переименована. Это связано
с тем, что эта функция работоспособна только в том случае,
если PHP был собран в качестве модуля <productname>Apache</productname>.
</para>
</note>
<para>
См.также <function>apache_request_headers</function>.
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.5 $ -->
<refentry id="function.getallheaders">
<refnamediv>
<refname>getallheaders</refname>
<refpurpose>Получить все заголовки HTTP-запроса</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>getallheaders</methodname>
<void/>
</methodsynopsis>
<para>
Получить все заголовки для данного HTTP-запроса.
</para>
<para>
Эта функция является псевдонимом функции <function>apache_request_headers</function>.
Пожалуйста, обратитесь к описанию функции <function>apache_request_headers</function>
для получения детальной информации о данной функции.
</para>
&apache.req.module;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Ассоциативный массив, содержащий все HTTP-заголовки для данного запроса или
&false; при неудаче.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>4.3.0</entry>
<entry>
Функция стала псефдонимом для <function>apache_request_headers</function>.
Соответствующим образом, она была переименована. Это связано
с тем, что эта функция работоспособна только в том случае,
если PHP был собран в качестве модуля Apache.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&note.apache.nsapi-module;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>apache_response_headers</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->

View File

@ -1,58 +1,122 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.3 Maintainer: tronic Status: ready -->
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/apache.xml, last change in rev 1.20 -->
<refentry id="function.virtual">
<refnamediv>
<refname>virtual</refname>
<refpurpose>Выполнить подзапрос Apache</refpurpose>
</refnamediv>
<refsect1>
<title>Описание</title>
<methodsynopsis>
<type>integer</type><methodname>virtual</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Функция <function>virtual</function> предназначена для работы в среде
сервера Apache и является эквивалентом конструкции
&lt;!--#include virtual...--&gt;, используемой в mod_include.
Эта функция выполняет подзапрос Apache. Она бывает полезной
в тех случаях, когда вам нужно включить в свой скрипт результат
выполнения других CGI программ или скриптов или обработки сервером
Apache .shtml файлов. Имейте в виду, что CGI скрипты должны
создавать корректные CGI заголовки. Как минимум, CGI скрипт
должен создавать заголовок Content-type. Если вы хотите
включить в скрипт PHP файлы, используйте функцию
<function>include</function> или функцию <function>require</function>;
функция <function>virtual</function> не должна использоваться для
включения файлов, которые сами по себе являются PHP скриптами.
</para>
<para>
Перед тем, как осуществится выполнение подзапроса, все буферы
сбрасываются и выдаются в броузер, также отсылаются заголовки,
помещенные в буфер.
</para>
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.6 $ -->
<refentry id="function.virtual">
<refnamediv>
<refname>virtual</refname>
<refpurpose>Выполнить подзапрос Apache</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>virtual</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Функция <function>virtual</function> специфична для сервера Apache
и является эквивалентом конструкции <literal>&lt;!--#include virtual...--&gt;</literal>,
используемой в mod_include.
Эта функция выполняет подзапрос Apache. Она бывает полезной
в тех случаях, когда вам нужно включить в свой скрипт результат
выполнения других CGI программ или скриптов, обработки сервером
Apache .shtml файлов или чего-либо иного, что должно быть обработано Apache.
Имейте в виду, что CGI скрипты должны создавать корректные CGI заголовки.
Как минимум, CGI скрипт должен создавать заголовок Content-type.
</para>
<para>
Перед тем, как осуществится выполнение подзапроса, все буферы
сбрасываются и выдаются в броузер, также отсылаются заголовки,
помещенные в буфер.
</para>
&apache.req.module;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Имя файла, для которого будет выполнен подзапрос.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Результат выполнения подзапроса в случае успеха, или &false; при неудаче.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>4.0.6</entry>
<entry>
Эту функцию стало возможным использовать для файлов PHP. Тем не менее, чаще всего
для файлов PHP лучше использовать функции <function>include</function> или
<function>require</function>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<warning>
<para>
Строка запроса может быть передана вызываемому файлу, однако значение переменной
<varname>$_GET</varname> будет скопирована из родительского скрипта. Лишь
<varname>$_SERVER['QUERY_STRING']</varname> будет содержать переданную
строку запроса. Строка запроса может быть передана только при использовании Apache 2.
Запрошенный файл не будет отражен в журнале доступа (access log) Apache.
</para>
</warning>
<note>
<para>
Переменные окружения, установленные в запрошенном файле, не видимы из
вызвавшего его скрипта.
</para>
</note>
&note.apache.nsapi-module;
</refsect1>
</refentry>
<!-- 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:"../../../../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
-->