cvs: phpdoc-ru /appendices aliases.xml ini.xml /faq general.xml migration4.xml using.xml /language variables.xml /language/predefined
errorexception.xml exception.xml exceptions.xml variables.xml /language/predefined/variables request.xml superglobals.xml /reference/filesystem
ini.xml /reference/oci8 book.xml

From: Date: Mon, 21 Apr 2008 09:38:49 +0000
Subject: cvs: phpdoc-ru /appendices aliases.xml ini.xml /faq general.xml migration4.xml using.xml /language variables.xml /language/predefined
errorexception.xml exception.xml exceptions.xml variables.xml /language/predefined/variables request.xml superglobals.xml /reference/filesystem
ini.xml /reference/oci8 book.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-929@lists.php.net to get a copy of this message
tony2001 Mon Apr 21 09:38:49 2008 UTC Added files: /phpdoc-ru/language/predefined errorexception.xml exception.xml exceptions.xml variables.xml /phpdoc-ru/language/predefined/variables request.xml superglobals.xml Removed files: /phpdoc-ru/faq migration4.xml Modified files: /phpdoc-ru/appendices aliases.xml ini.xml /phpdoc-ru/faq general.xml using.xml /phpdoc-ru/language variables.xml /phpdoc-ru/reference/filesystem ini.xml /phpdoc-ru/reference/oci8 book.xml Log: add new files and fix the old ones this patch is required to make it build again

http://cvs.php.net/viewvc.cgi/phpdoc-ru/appendices/aliases.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-ru/appendices/aliases.xml diff -u phpdoc-ru/appendices/aliases.xml:1.9 phpdoc-ru/appendices/aliases.xml:1.10 --- phpdoc-ru/appendices/aliases.xml:1.9 Thu Jan 24 14:29:01 2008 +++ phpdoc-ru/appendices/aliases.xml Mon Apr 21 09:38:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.20 Maintainer: tronic Status: ready --> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <appendix xml:id="aliases" xmlns="http://docbook.org/ns/docbook"> <title>Список псевдонимов функций</title> <para> @@ -126,86 +126,6 @@ <entry><link linkend="ref.com">COM</link></entry> </row> <row> - <entry>cv_add</entry> - <entry><function>ccvs_add</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_auth</entry> - <entry><function>ccvs_auth</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_command</entry> - <entry><function>ccvs_command</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_count</entry> - <entry><function>ccvs_count</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_delete</entry> - <entry><function>ccvs_delete</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_done</entry> - <entry><function>ccvs_done</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_init</entry> - <entry><function>ccvs_init</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_lookup</entry> - <entry><function>ccvs_lookup</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_new</entry> - <entry><function>ccvs_new</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_report</entry> - <entry><function>ccvs_report</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_return</entry> - <entry><function>ccvs_return</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_reverse</entry> - <entry><function>ccvs_reverse</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_sale</entry> - <entry><function>ccvs_sale</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_status</entry> - <entry><function>ccvs_status</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_textvalue</entry> - <entry><function>ccvs_textvalue</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> - <entry>cv_void</entry> - <entry><function>ccvs_void</function></entry> - <entry><link linkend="ref.ccvs">CCVS</link></entry> -</row> -<row> <entry>die</entry> <entry><function>exit</function></entry> <entry><link linkend="ref.misc">Неклассифицированные функции</link></entry> http://cvs.php.net/viewvc.cgi/phpdoc-ru/appendices/ini.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-ru/appendices/ini.xml diff -u phpdoc-ru/appendices/ini.xml:1.10 phpdoc-ru/appendices/ini.xml:1.11 --- phpdoc-ru/appendices/ini.xml:1.10 Sun Jun 24 20:47:21 2007 +++ phpdoc-ru/appendices/ini.xml Mon Apr 21 09:38:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.13 Maintainer: freespace Status: ready --> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <appendix xml:id="ini" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Директивы &php.ini;</title> @@ -1975,6 +1975,12 @@ <entry></entry> </row> <row> + <entry><link linkend="ini.request-order">request_order</link></entry> + <entry>""</entry> + <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> + <entry>Added in PHP 5.3.0</entry> + </row> + <row> <entry><link linkend="ini.xbithack">xbithack</link></entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> @@ -2457,6 +2463,12 @@ <entry></entry> </row> <row> + <entry>request_order</entry> + <entry>""</entry> + <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> + <entry>Доступна с версии PHP 5.3.0</entry> + </row> + <row> <entry>register_globals</entry> <entry>"0"</entry> <entry>PHP_INI_PERDIR</entry> @@ -2605,6 +2617,24 @@ </listitem> </varlistentry> + <varlistentry xml:id="ini.request-order"> + <term> + <parameter>request_order</parameter> + <type>string</type> + </term> + <listitem> + <para> + Эта директива регулирует порядок, в котором PHP добавляет переменные GET, POST + и Cookie в массив _REQUEST. Добавление производится слева направо, + новые значения перезаписывают старые. + </para> + <para> + Если значение этой директива не установлено, используется значение + директивы variables_order. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.auto-globals-jit"> <term> <parameter>auto_globals_jit</parameter> http://cvs.php.net/viewvc.cgi/phpdoc-ru/faq/general.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-ru/faq/general.xml diff -u phpdoc-ru/faq/general.xml:1.6 phpdoc-ru/faq/general.xml:1.7 --- phpdoc-ru/faq/general.xml:1.6 Fri Jun 29 13:15:08 2007 +++ phpdoc-ru/faq/general.xml Mon Apr 21 09:38:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.21 Maintainer: irinagoble Status: ready --> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <chapter xml:id="faq.general" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Общая Информация</title> <titleabbrev>Общая Информация</titleabbrev> @@ -82,11 +82,8 @@ </question> <answer> <para> - Да. Смотрите файл <filename>INSTALL</filename> из дистрибутива -исходников - PHP 4. Также читайте соответствующее <link -linkend="migration4.php4.with.php3"> - приложение</link>. + Да. Смотрите файл <filename>INSTALL</filename> из дистрибутива + исходников PHP. </para> </answer> </qandaentry> @@ -129,12 +126,8 @@ <simpara>Подсчёт ссылок</simpara> </listitem> </itemizedlist> - Пожалуйста, смотрите обзор <link xlink:href="&url.zend.new;">Что нового в -PHP 4 - </link> для детального объяснения этих возможностей и прочего. Если -вы - переходите из PHP 3 в PHP 4, также читайте соответствующее - <link linkend="migration4">приложение</link>. + Смотрите обзор <link xlink:href="&url.zend.new;">Что нового в PHP 4 + </link> для детального объяснения этих возможностей и прочего. </para> </answer> </qandaentry> http://cvs.php.net/viewvc.cgi/phpdoc-ru/faq/using.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-ru/faq/using.xml diff -u phpdoc-ru/faq/using.xml:1.3 phpdoc-ru/faq/using.xml:1.4 --- phpdoc-ru/faq/using.xml:1.3 Sat Jun 23 13:31:20 2007 +++ phpdoc-ru/faq/using.xml Mon Apr 21 09:38:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.34 Maintainer: irinagoble Status: ready --> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <chapter xml:id="faq.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Использование PHP</title> <titleabbrev>Использование PHP</titleabbrev> @@ -102,6 +102,68 @@ </answer> </qandaentry> + <qandaentry xml:id="faq.register-globals"> + <question> + <para> + Как директива PHP register_globals касается меня? + </para> + </question> + <answer> + <para> + Во-первых, следует объяснить что делает эта директива. + Скажем, используется вот такой URL: + <literal>http://example.com/foo.php?animal=cat</literal> + и в <filename>foo.php</filename> у нас находится следующий PHP-код: + </para> + <para> + <programlisting role="php"> +<![CDATA[ +<?php +// Использование $_GET в данном случае более предпочтительно +echo $_GET['animal']; + +// Чтобы переменная $animal была определена, директива register_globals должна +// быть включена. +// НЕ ДЕЛАЙТЕ ЭТОГО! +echo $animal; + +// Это касается всех переменных, включая $_SERVER +echo $_SERVER['PHP_SELF']; + +// Опять-таки, чтобы $PHP_SELF была определена, надо включить register_globals +// НЕ ДЕЛАЙТЕ ЭТОГО! +echo $PHP_SELF; +?> +]]> + </programlisting> + </para> + <para> + Код выше демонстрирует как register_globals создаёт множество переменных. + Годами такой стиль написания не одобрялся и годами register_globals была + выключена по умолчанию. В PHP 6 директива register_globals наконец + удалена. Несмотря на то, что большинство хостингов отключает + register_globals, осталось еще много устаревших статей, руководств и + книг, которые требуют включения этой директивы. + </para> + <para> + См. также следующие источники за дополнительной информацией: + <simplelist> + <member>Директива <link linkend="ini.register-globals">register_globals</link></member> + <member><link linkend="security.globals">Глава о безопасности и register_globals</link></member> + <member><link linkend="language.variables.external">Работа с внешними данными</link></member> + <member><link linkend="language.variables.superglobals">Суперглобальные переменные</link></member> + </simplelist> + </para> + <note> + <para> + В примере выше мы использовали <acronym>URL</acronym>, который содержал + QUERY_STRING. Передача информации подобным образом происходит с помощью + метода HTTP GET, вот почему мы использовали суперглобальный массив <varname>$_GET</varname>. + </para> + </note> + </answer> + </qandaentry> + <qandaentry xml:id="faq.using.wrong-order"> <question> <para> @@ -361,9 +423,8 @@ <question> <para> Как я могу генерировать PDF файлы без использования платных или - коммерческих библиотек <link linkend="ref.cpdf">ClibPDF</link> и - <link linkend="ref.pdf">PDFLib</link>? Я бы хотел что-нибудь - бесплатное и не требующее внешних библиотек PDF. + коммерческих библиотек, как <link linkend="ref.pdf">PDFLib</link>? + Я бы хотел что-нибудь бесплатное и не требующее внешних библиотек PDF. </para> </question> <answer> http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/variables.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-ru/language/variables.xml diff -u phpdoc-ru/language/variables.xml:1.6 phpdoc-ru/language/variables.xml:1.7 --- phpdoc-ru/language/variables.xml:1.6 Tue Mar 11 13:26:52 2008 +++ phpdoc-ru/language/variables.xml Mon Apr 21 09:38:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.74 Maintainer: Kai Status: ready --> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <chapter xml:id="language.variables" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Переменные</title> @@ -122,7 +122,7 @@ могут быть полностью задокументированы, поскольку они зависят от запущенного сервера, его версии и настроек, а также других факторов. Некоторые из этих переменных не доступны, когда PHP запущен из - <link linkend="features.commandline">командной строки</link>. +еменные <link linkend="features.commandline">командной строки</link>. Перечень этих переменных смотрите в разделе <link linkend="reserved.variables">Зарезервированные предопределенные переменные</link>. @@ -172,7 +172,7 @@ предопределенных переменных PHP и их сути смотрите в разделе <link linkend="reserved.variables">Зарезервированные предопределенные переменные</link>. Также вы заметите, что старые - предопределенные переменные (<varname>$HTTP_*_VARS</varname>) все + предопределенные переменные (<varname>$HTTP_*_VARS</varname>) всё еще существуют. &avail.register-long-arrays; @@ -192,125 +192,6 @@ соответствующие им предопределенные массивы также останутся пустыми. </para> - <variablelist xml:id="language.variables.superglobals"> - <title>Суперглобальные переменные PHP</title> - <varlistentry> - <term><link linkend="reserved.variables.globals">$GLOBALS</link></term> - <listitem> - <simpara> - Содержит ссылку на каждую переменную, доступную в данный момент - в глобальной области видимости скрипта. Ключами этого массива - являются имена глобальны переменных. - <varname>$GLOBALS</varname> существует, начиная с PHP 3. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.server">$_SERVER</link></term> - <listitem> - <simpara> - Переменные, установленные web-сервером либо напрямую связанные - с окружением выполнения текущего скрипта. Аналог старого - массива <varname>$HTTP_SERVER_VARS</varname> (который по-прежнему - доступен, но не рекомендуется). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.get">$_GET</link></term> - <listitem> - <simpara> - Переменные, передаваемые скрипту через HTTP GET. Аналог старого - массива <varname>$HTTP_GET_VARS</varname> (который по-прежнему - доступен, но не рекомендуется). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.post">$_POST</link></term> - <listitem> - <simpara> - Переменные, передаваемые скрипту через HTTP POST. Аналог старого - массива <varname>$HTTP_POST_VARS</varname> (который по-прежнему - доступен, но не рекомендуется). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.cookies">$_COOKIE</link></term> - <listitem> - <simpara> - Переменные, передаваемые скрипту через HTTP cookies. Аналог старого - массива <varname>$HTTP_COOKIE_VARS</varname> (который - по-прежнему доступен, но не рекомендуется). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.files">$_FILES</link></term> - <listitem> - <simpara> - Переменные, передаваемые скрипту через HTTP post-загрузку файлов. - Аналог старого массива <varname>$HTTP_POST_FILES</varname> (который - по-прежнему доступен, но не рекомендуется). Для дополнительной - информации смотрите <link - linkend="features.file-upload.post-method">Загрузка методом - POST</link>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.environment">$_ENV</link></term> - <listitem> - <simpara> - Переменные, передаваемые скрипту через окружение. Аналог старого - массива <varname>$HTTP_ENV_VARS</varname> (который по-прежнему - доступен, но не рекомендуется). - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.request">$_REQUEST</link></term> - <listitem> - <simpara> - Переменные, передаваемые скрипту через механизмы ввода GET, POST и - COOKIE, и которым, следовательно, нельзя доверять. Наличие и порядок - включения переменных в этот массив определяется в соответствии с - директивой конфигурации PHP - <link linkend="ini.variables-order">variables_order</link>. Этот массив - не имеет прямых аналогов в версиях PHP до 4.1.0. Смотрите также - <function>import_request_variables</function>. - </simpara> - <caution> - <simpara> - Начиная с PHP 4.3.0, информация о файле из <varname>$_FILES</varname> - больше не существует в <varname>$_REQUEST</varname>. - </simpara> - </caution> - <note> - <simpara> - При запуске из <link linkend="features.commandline">командной строки - </link>, этот массив <emphasis>не</emphasis> будет содержать записей - <varname>argv</varname> и <varname>argc</varname>; они находятся в - массиве <varname>$_SERVER</varname>. - </simpara> - </note> - </listitem> - </varlistentry> - <varlistentry> - <term><link linkend="reserved.variables.session">$_SESSION</link></term> - <listitem> - <simpara> - Переменные, зарегистрированные на данный момент в сессии скрипта. - Аналог старого массива <varname>$HTTP_SESSION_VARS</varname> (который - по-прежнему доступен, но не рекомендуется). Дополнительную - информацию смотрите в разделе <link - linkend="ref.session">Функции обработки сессии</link>. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect1> @@ -809,7 +690,7 @@ </sect1> <sect1 xml:id="language.variables.external"> - <title>Переменные вне PHP</title> + <title>Переменные извне PHP</title> <sect2 xml:id="language.variables.external.form"> <title>HTML-формы (GET и POST)</title> http://cvs.php.net/viewvc.cgi/phpdoc-ru/reference/filesystem/ini.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-ru/reference/filesystem/ini.xml diff -u phpdoc-ru/reference/filesystem/ini.xml:1.5 phpdoc-ru/reference/filesystem/ini.xml:1.6 --- phpdoc-ru/reference/filesystem/ini.xml:1.5 Sat Jun 23 13:31:22 2007 +++ phpdoc-ru/reference/filesystem/ini.xml Mon Apr 21 09:38:48 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.9 Maintainer: tronic Status: ready --> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <section xml:id="filesystem.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; @@ -91,6 +91,26 @@ </listitem> </varlistentry> + <varlistentry xml:id="ini.allow-url-include"> + <term> + <parameter>allow_url_include</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Эта опция позволяет использование врапперов fopen, которые поддерживают + работу с URL, в функциях <function>include</function>, <function>include_once</function>, + <function>require</function>, <function>require_once</function>. + </para> + <note> + <para> + Эта опция требует включения опции allow_url_fopen. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.user-agent"> <term> <parameter>user_agent</parameter> http://cvs.php.net/viewvc.cgi/phpdoc-ru/reference/oci8/book.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-ru/reference/oci8/book.xml diff -u phpdoc-ru/reference/oci8/book.xml:1.1 phpdoc-ru/reference/oci8/book.xml:1.2 --- phpdoc-ru/reference/oci8/book.xml:1.1 Thu Jan 24 14:29:02 2008 +++ phpdoc-ru/reference/oci8/book.xml Mon Apr 21 09:38:48 2008 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- Purpose: database.vendors --> <!-- Membership: bundled, external --> @@ -10,12 +10,9 @@ <preface xml:id="intro.oci8"> &reftitle.intro; <para> - Эти функции позволяют вам работать с Oracle версий 10/9/8/7. - Для этого используется библиотека Oracle Call Interface (OCI). - </para> - <para> - Данный модуль много гибче <link linkend="ref.oracle">прежнего</link>. - Он содержит функции привязки переменных PHP к соответствующим + Эти функции позволяют вам работать с Oracle версий 10/9/8с помощью + библиотеки Oracle Call Interface (OCI). + Они поддерживают привязку переменных PHP к соответствующим меткам Oracle, расширенную поддержку LOB, FILE и ROWID. </para> </preface> http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/predefined/errorexception.xml?view=markup&rev=1.1 Index: phpdoc-ru/language/predefined/errorexception.xml +++ phpdoc-ru/language/predefined/errorexception.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.1 Status: ready $ --> <!-- $Revision: 1.1 $ --> <reference xml:id="class.errorexception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>ErrorException</title> <partintro> <!-- {{{ ErrorException intro --> <section xml:id="errorexception.intro"> &reftitle.intro; <para> Исключение в случае ошибки. </para> </section> <!-- }}} --> <section xml:id="errorexception.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>ErrorException</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>ErrorException</classname> </ooclass> <ooclass> <modifier>extends</modifier> <classname>Exception</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Свойства</classsynopsisinfo> <fieldsynopsis> <modifier>protected</modifier> <type>int</type> <varname linkend="errorexception.props.severity">severity</varname> </fieldsynopsis> <classsynopsisinfo role="comment">Методы</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.errorexception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" /> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.errorexception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> <classsynopsisinfo role="comment">Унаследованные методы</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> </classsynopsis> <!-- }}} --> </section> <!-- {{{ ErrorException properties --> <section xml:id="errorexception.props"> &reftitle.properties; <variablelist> <varlistentry xml:id="errorexception.props.severity"> <term><varname>severity</varname></term> <listitem> <para>Важность ошибки</para> </listitem> </varlistentry> </variablelist> </section> <!-- }}} --> <!-- {{{ Example --> <section xml:id="errorexception.examples"> &reftitle.examples; <para> <example xml:id="errorexception.example.error-handler"><!-- {{{ --> <title>Пример использования <classname>ErrorException</classname></title> <para> Превращаем все ошибки в <classname>ErrorException</classname>. </para> <programlisting role="php"> <![CDATA[ <?php function exception_error_handler($errno, $errstr, $errfile, $errline ) { throw new ErrorException($errstr, 0, $errno, $errfile, $errline); } set_error_handler("exception_error_handler"); /* вызываем ошибку */ strpos(); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Fatal error: Uncaught exception 'ErrorException' with message 'Wrong parameter count for strpos()' in /home/bjori/tmp/ex.php:8 Stack trace: #0 [internal function]: exception_error_handler(2, 'Wrong parameter...', '/home/bjori/php...', 8, Array) #1 /home/bjori/php/cleandocs/test.php(8): strpos() #2 {main} thrown in /home/bjori/tmp/ex.php on line 8 ]]> </screen> </example><!-- }}} --> </para> </section> </partintro> &language.predefined.errorexception.construct; &language.predefined.errorexception.getseverity; </reference> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/predefined/exception.xml?view=markup&rev=1.1 Index: phpdoc-ru/language/predefined/exception.xml +++ phpdoc-ru/language/predefined/exception.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.2 Status: ready $ --> <!-- $Revision: 1.1 $ --> <reference xml:id="class.exception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> <title>Exception</title> <partintro> <!-- {{{ Exception intro --> <section xml:id="exception.intro"> &reftitle.intro; <para> <ooclass><classname>Exception</classname></ooclass> - это базовый класс для всех исключений. </para> </section> <!-- }}} --> <section xml:id="exception.synopsis"> &reftitle.classsynopsis; <!-- {{{ Synopsis --> <classsynopsis> <ooclass><classname>Exception</classname></ooclass> <!-- {{{ Class synopsis --> <classsynopsisinfo> <ooclass> <classname>Exception</classname> </ooclass> </classsynopsisinfo> <!-- }}} --> <classsynopsisinfo role="comment">Свойства</classsynopsisinfo> <fieldsynopsis> <modifier>protected</modifier> <type>string</type> <varname linkend="exception.props.message">message</varname> </fieldsynopsis> <fieldsynopsis> <modifier>private</modifier> <type>string</type> <varname linkend="exception.props.string">string</varname> </fieldsynopsis> <fieldsynopsis> <modifier>protected</modifier> <type>int</type> <varname linkend="exception.props.code">code</varname> </fieldsynopsis> <fieldsynopsis> <modifier>protected</modifier> <type>string</type> <varname linkend="exception.props.file">file</varname> </fieldsynopsis> <fieldsynopsis> <modifier>protected</modifier> <type>int</type> <varname linkend="exception.props.line">line</varname> </fieldsynopsis> <fieldsynopsis> <modifier>private</modifier> <type>array</type> <varname linkend="exception.props.trace">trace</varname> </fieldsynopsis> <classsynopsisinfo role="comment">Методы</classsynopsisinfo> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[1])" /> <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" /> </classsynopsis> <!-- }}} --> </section> <!-- {{{ Exception properties --> <section xml:id="exception.props"> &reftitle.properties; <variablelist> <varlistentry xml:id="exception.props.message"> <term><varname>message</varname></term> <listitem> <para>Текст исключения</para> </listitem> </varlistentry> <varlistentry xml:id="exception.props.string"> <term><varname>string</varname></term> <listitem> <para>Имя исключения</para> </listitem> </varlistentry> <varlistentry xml:id="exception.props.code"> <term><varname>code</varname></term> <listitem> <para>Код исключения</para> </listitem> </varlistentry> <varlistentry xml:id="exception.props.file"> <term><varname>file</varname></term> <listitem> <para>Имя файла, где было вызвано исключение</para> </listitem> </varlistentry> <varlistentry xml:id="exception.props.line"> <term><varname>line</varname></term> <listitem> <para>Номер строки, где было вызвано исключение</para> </listitem> </varlistentry> <varlistentry xml:id="exception.props.trace"> <term><varname>trace</varname></term> <listitem> <para>Стэк трэйс</para> </listitem> </varlistentry> </variablelist> </section> <!-- }}} --> </partintro> &language.predefined.exception.construct; &language.predefined.exception.getmessage; &language.predefined.exception.getcode; &language.predefined.exception.getfile; &language.predefined.exception.getline; &language.predefined.exception.gettrace; &language.predefined.exception.gettraceasstring; &language.predefined.exception.tostring; &language.predefined.exception.clone; </reference> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/predefined/exceptions.xml?view=markup&rev=1.1 Index: phpdoc-ru/language/predefined/exceptions.xml +++ phpdoc-ru/language/predefined/exceptions.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.1 Status: ready $ --> <!-- $Revision: 1.1 $ --> <part xml:id="reserved.exceptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Предопределённые исключения</title> &language.predefined.exception; &language.predefined.errorexception; </part> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/predefined/variables.xml?view=markup&rev=1.1 Index: phpdoc-ru/language/predefined/variables.xml +++ phpdoc-ru/language/predefined/variables.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.3 Status: ready $ --> <!-- $Revision: 1.1 $ --> <reference xml:id="reserved.variables" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Предопределённые переменные</title> <partintro> <para> PHP предоставляет всем скриптам большое количество предопределённых переменных. Эти переменные содержат всё, от <link linkend="language.variables.external">внешних данных</link> до переменных среды окружения, от текста сообщений об ошибках до последних полученных заголовков. </para> <para> См. также ЧАВО под названием "<link linkend="faq.register-globals">Как register_globals касаются меня?</link>" </para> </partintro> &language.predefined.variables.superglobals; &language.predefined.variables.globals; &language.predefined.variables.server; &language.predefined.variables.get; &language.predefined.variables.post; &language.predefined.variables.files; &language.predefined.variables.request; &language.predefined.variables.session; &language.predefined.variables.env; &language.predefined.variables.cookie; &language.predefined.variables.phperrormsg; &language.predefined.variables.httprawpostdata; &language.predefined.variables.httpresponseheader; &language.predefined.variables.argc; &language.predefined.variables.argv; </reference> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/predefined/variables/request.xml?view=markup&rev=1.1 Index: phpdoc-ru/language/predefined/variables/request.xml +++ phpdoc-ru/language/predefined/variables/request.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.3 Status: ready $ --> <!-- $Revision: 1.1 $ --> <refentry xml:id="reserved.variables.request" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>$_REQUEST</refname> <refpurpose>Данные HTTP-запроса</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Ассоциативный массив, который по умолчанию содержит данные переменных <link linkend="reserved.variables.get">$_GET</link>, <link linkend="reserved.variables.post">$_POST</link>&listendand; <link linkend="reserved.variables.cookies">$_COOKIE</link>. </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.3.0</entry> <entry> Добавлена директива <link linkend="ini.request-order">request_order</link>. Она позволяет контролировать содержимое переменной <varname>$_REQUEST</varname>. </entry> </row> <row> <entry>4.3.0</entry> <entry> Данные переменной <link linkend="reserved.variables.files">$_FILES</link> более не включаются в <varname>$_REQUEST</varname>. </entry> </row> <row> <entry>4.1.0</entry> <entry> Добавлена переменная <varname>$_REQUEST</varname>. </entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> <refsect1 role="notes"> &reftitle.notes; &note.is-superglobal; <note> <para> При работе в <link linkend="features.commandline">командной строке</link>, переменные <link linkend="reserved.variables.argv">argv</link> и <link linkend="reserved.variables.argc">argc</link> <emphasis>не</emphasis> включаются в <varname>$_REQUEST</varname>, они присутствуют в массиве <link linkend="reserved.variables.server">$_SERVER</link>. </para> </note> <note> <para> Данным, которые были переданы в скрипт посредством методов GET, POST или в COOKIE нельзя доверять. Их наличие и порядок добавления данных в соответствующие массивы контролируется директивой <link linkend="ini.variables-order">variables_order</link>. </para> </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <simplelist> <member><function>import_request_variables</function></member> <member><link linkend="language.variables.external">Работа с внешними данными</link></member> <member><link linkend="book.filter">Функции фильтрации данных</link></member> </simplelist> </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 --> http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/predefined/variables/superglobals.xml?view=markup&rev=1.1 Index: phpdoc-ru/language/predefined/variables/superglobals.xml +++ phpdoc-ru/language/predefined/variables/superglobals.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.1 Status: ready $ --> <!-- $Revision: 1.1 $ --> <refentry xml:id="language.variables.superglobals" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Суперглобальные переменные</refname> <refpurpose>Суперглобальные переменные - это встроенные переменные, которые доступны по всех областях видимости</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para> Некоторые предопределённые переменные в PHP являются "суперглобальными", что означает, что они доступны в любом месте скрипта. Нет необходимости использовать синтаксис <command>global $variable;</command> для доступа к ним в функциях и методах. </para> <para> Суперглобальными переменными являются: <simplelist> <member><link linkend="reserved.variables.globals">$GLOBALS</link></member> <member><link linkend="reserved.variables.server">$_SERVER</link></member> <member><link linkend="reserved.variables.get">$_GET</link></member> <member><link linkend="reserved.variables.post">$_POST</link></member> <member><link linkend="reserved.variables.files">$_FILES</link></member> <member><link linkend="reserved.variables.cookies">$_COOKIE</link></member> <member><link linkend="reserved.variables.session">$_SESSION</link></member> <member><link linkend="reserved.variables.request">$_REQUEST</link></member> <member><link linkend="reserved.variables.environment">$_ENV</link></member> </simplelist> </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.1.0</entry> <entry> Суперглобальные переменные впервые появились в PHP. </entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> <refsect1 role="notes"> &reftitle.notes; <note> <title>Доступность переменных</title> <para> По умолчанию все суперглобальные переменные всегда доступны, однако существуют настройки, которые могут на это влиять. За дальнейшей информацией смотрите описание директивы <link linkend="ini.variables-order">variables_order</link>. </para> </note> <note> <title>Работа с register_globals</title> <para> В том случае, если устаревшая директива <link linkend="ini.register-globals">register_globals</link> включена, содержание суперглобальных массивов становится доступно в виде отдельных переменных. Например, <varname>$_POST['foo']</varname> будет также доступна в виде <varname>$foo</varname>. </para> <para> За дополнительной информацией смотрите ЧАВО под названием "<link linkend="faq.register-globals">Как register_globals касаются меня?</link>" </para> </note> <note> <title>Переменные переменных</title> <para> Суперглобальные переменные не могут быть использованы как <link linkend="language.variables.variable">переменные переменных</link> внутри функций и методов. </para> </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="language.variables.scope">variable scope</link></member> <member>Директива <link linkend="ini.variables-order">variables_order</link></member> <member><link linkend="book.filter">Функции фильтрации данных</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 -->
« previous php.doc.ru (#929) next »