mirror of
https://github.com/php/doc-ru.git
synced 2025-08-02 00:21:51 +00:00
7 new by anon
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@340650 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Andrey Gromov
245
appendices/migration70/constants.xml
Normal file
245
appendices/migration70/constants.xml
Normal file
@ -0,0 +1,245 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 5f177879f0e84765c01d2b76e05aa01454a67fa4 Maintainer: rjhdby Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<!-- $Revision$ -->
|
||||
<sect1 xml:id="migration70.constants" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<title>Новые глобальные константы</title>
|
||||
|
||||
<sect2 xml:id="migration70.constants.core">
|
||||
<title><link linkend="reserved.constants">Константы предопределенные в ядре PHP</link></title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>PHP_INT_MIN</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="migration70.constants.gd">
|
||||
<title><link linkend="book.image">GD</link></title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>IMG_WEBP</constant> (с PHP 7.0.10)
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="migration70.constants.libxml">
|
||||
<title><link linkend="book.libxml">LibXML</link></title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>LIBXML_BIGLINES</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="migration70.constants.pcre">
|
||||
<title><link linkend="book.pcre">PCRE</link></title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>PREG_JIT_STACKLIMIT_ERROR</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="migration70.constants.posix">
|
||||
<title><link linkend="book.posix">POSIX</link></title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_AS</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_CORE</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_CPU</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_DATA</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_FSIZE</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_LOCKS</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_MEMLOCK</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_MSGQUEUE</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_NICE</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_NOFILE</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_NPROC</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_RSS</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_RTPRIO</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_RTTIME</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_SIGPENDING</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_STACK</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>POSIX_RLIMIT_INFINITY</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="migration70.constants.zlib">
|
||||
<title><link linkend="book.zlib">Zlib</link></title>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_ENCODING_RAW</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_ENCODING_DEFLATE</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_ENCODING_GZIP</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_FILTERED</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_HUFFMAN_ONLY</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_FIXED</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_RLE</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_DEFAULT_STRATEGY</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_BLOCK</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_FINISH</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_FULL_FLUSH</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_NO_FLUSH</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_PARTIAL_FLUSH</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
<constant>ZLIB_SYNC_FLUSH</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
</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
|
||||
-->
|
||||
67
install/macos/packages.xml
Normal file
67
install/macos/packages.xml
Normal file
@ -0,0 +1,67 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 97e6a27891cb2ab0b1c57f24628b74b7cc7c7021 Maintainer: rjhdby Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<!-- $Revision$ -->
|
||||
<sect1 xml:id="install.macosx.packages" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<title>Using Packages</title>
|
||||
<simpara>
|
||||
Существуют несколько предварительно упакованных и предварительно скомпилированных
|
||||
версий PHP для Mac OS X. Это может помочь в создании стандартных конфигураций, но если
|
||||
вам нужены специфические функции (например, безопасный сервер, или другой драйвер базы
|
||||
данных), вы можете установить PHP и/или веб-сервер самостоятельно. Если вы не знакомы
|
||||
с процессом сборки и компиляции программного обеспечения, стоит
|
||||
проверить, может кто-то уже собрал версию PHP с функциями, которые вам необходимы. </simpara>
|
||||
<simpara>
|
||||
Следующие ресурсы позволяют легко устанавливать пакеты и
|
||||
скомпилировать двоичные файлы для PHP на Mac OS:
|
||||
</simpara>
|
||||
<para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
MacPorts:
|
||||
<link xlink:href="&url.mac.macports;">&url.mac.macports;</link>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Entropy:
|
||||
<link xlink:href="&url.mac.entropy;">&url.mac.entropy;</link>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Fink:
|
||||
<link xlink:href="&url.mac.fink;">&url.mac.fink;</link>
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Homebrew:
|
||||
<link xlink:href="&url.mac.homebrew;">&url.mac.homebrew;</link>
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</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
|
||||
-->
|
||||
53
reference/gmagick/examples.xml
Normal file
53
reference/gmagick/examples.xml
Normal file
@ -0,0 +1,53 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: rjhdby Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<!-- $Revision$ -->
|
||||
<chapter xml:id="gmagick.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
&reftitle.examples;
|
||||
<para>
|
||||
Следующий код демонстрирует часто используемые операции Gmagick над изображениями.
|
||||
</para>
|
||||
<example>
|
||||
<title>Примеры Gmagick</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
// Создаем новый объект Gmagick
|
||||
$image = new Gmagick('example.jpg');
|
||||
|
||||
// Создаем уменьшенную копию изображения. 0 для сохранения пропорций.
|
||||
$image->thumbnailImage(100, 0);
|
||||
|
||||
// Создаем рамку вокруг изображения, после чего накладываем эффект масляной краски
|
||||
// Обратите внимание на цепочки преобразующих методов, поддерживаемых в gmagick
|
||||
$image->borderImage("yellow", 8, 8)->oilPaintImage(0.3);
|
||||
|
||||
// Записываем полученное изображение в файл
|
||||
$image->write('example_thumbnail.jpg');
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
</chapter>
|
||||
|
||||
<!-- 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
|
||||
-->
|
||||
|
||||
104
reference/gnupg/functions/gnupg-adddecryptkey.xml
Normal file
104
reference/gnupg/functions/gnupg-adddecryptkey.xml
Normal file
@ -0,0 +1,104 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<!-- $Revision$ -->
|
||||
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.gnupg-adddecryptkey">
|
||||
<refnamediv>
|
||||
<refname>gnupg_adddecryptkey</refname>
|
||||
<refpurpose>Добавить ключ для расшифровки</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
&reftitle.description;
|
||||
<methodsynopsis>
|
||||
<type>bool</type><methodname>gnupg_adddecryptkey</methodname>
|
||||
<methodparam><type>resource</type><parameter>identifier</parameter></methodparam>
|
||||
<methodparam><type>string</type><parameter>fingerprint</parameter></methodparam>
|
||||
<methodparam><type>string</type><parameter>passphrase</parameter></methodparam>
|
||||
</methodsynopsis>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
&reftitle.parameters;
|
||||
<para>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><parameter>identifier</parameter></term>
|
||||
<listitem>
|
||||
&gnupg.identifier;
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>fingerprint</parameter></term>
|
||||
<listitem>
|
||||
&gnupg.fingerprint;
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>passphrase</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Кодовое слово.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<para>
|
||||
&return.success;
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="examples">
|
||||
&reftitle.examples;
|
||||
<para>
|
||||
<example>
|
||||
<title>Процедурный пример <function>gnupg_adddecryptkey</function></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$res = gnupg_init();
|
||||
gnupg_adddecryptkey($res,"8660281B6051D071D94B5B230549F9DC851566DC","test");
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
</example>
|
||||
<example>
|
||||
<title>Объектно ориентированный пример <function>gnupg_adddecryptkey</function></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$gpg = new gnupg();
|
||||
$gpg -> adddecryptkey("8660281B6051D071D94B5B230549F9DC851566DC","test");
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
</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:"~/.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
|
||||
-->
|
||||
31
reference/libevent/reference.xml
Normal file
31
reference/libevent/reference.xml
Normal file
@ -0,0 +1,31 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: rjhdby Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<!-- $Revision$ -->
|
||||
<reference xml:id="ref.libevent" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<title>&Functions; Libevent</title>
|
||||
|
||||
&reference.libevent.entities.functions;
|
||||
|
||||
</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:"~/.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
|
||||
-->
|
||||
|
||||
48
reference/opcache/book.xml
Normal file
48
reference/opcache/book.xml
Normal file
@ -0,0 +1,48 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 237b3170a48b84e20a756b9462f79c8d04ee3b78 Maintainer: rjhdby Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<!-- $Revision$ -->
|
||||
<book xml:id="book.opcache" xmlns="http://docbook.org/ns/docbook">
|
||||
<?phpdoc extension-membership="core" ?>
|
||||
<title>OPcache</title>
|
||||
|
||||
<preface xml:id="intro.opcache">
|
||||
&reftitle.intro;
|
||||
<para>
|
||||
OPcache улучшает производительность PHP путём сохранения скомпилированного байт-кода
|
||||
скриптов в разделяемой памяти, тем самым избавляя PHP от необходимости загружать и
|
||||
анализировать скрипты при каждом запросе.
|
||||
</para>
|
||||
<para>
|
||||
Это расширение доступно по умолчанию с PHP 5.5.0 и
|
||||
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl.package;ZendOpcache">доступно в PECL</link>
|
||||
для версия 5.2, 5.3 и 5.4.
|
||||
</para>
|
||||
</preface>
|
||||
|
||||
&reference.opcache.setup;
|
||||
&reference.opcache.reference;
|
||||
|
||||
</book>
|
||||
|
||||
<!-- 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
|
||||
-->
|
||||
|
||||
251
reference/yaml/functions/yaml-parse.xml
Normal file
251
reference/yaml/functions/yaml-parse.xml
Normal file
@ -0,0 +1,251 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: a305c183e2595da8c49102b96b6577df3ca167ca Maintainer: rjhdby Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<!-- $Revision$ -->
|
||||
<refentry xml:id="function.yaml-parse" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refnamediv>
|
||||
<refname>yaml_parse</refname>
|
||||
<refpurpose>Разбирает поток YAML</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
&reftitle.description;
|
||||
<methodsynopsis>
|
||||
<type>mixed</type><methodname>yaml_parse</methodname>
|
||||
<methodparam><type>string</type><parameter>input</parameter></methodparam>
|
||||
<methodparam choice="opt"><type>int</type><parameter>pos</parameter><initializer>0</initializer></methodparam>
|
||||
<methodparam choice="opt"><type>int</type><parameter role="reference">ndocs</parameter></methodparam>
|
||||
<methodparam choice="opt"><type>array</type><parameter>callbacks</parameter><initializer>null</initializer></methodparam>
|
||||
</methodsynopsis>
|
||||
<para>
|
||||
Конвертирует весь поток YAML или его часть и записывает в переменную.
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
&reftitle.parameters;
|
||||
<para>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><parameter>input</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
<type>Строка</type> для парсинга как поток YAML.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>pos</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Документ для разбора (<literal>-1</literal> для всех документов, <literal>0</literal> для первого документа, ...).
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>ndocs</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Если <parameter>ndocs</parameter> найден, тогда он будет заменен на количество
|
||||
документов в потоке YAML.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>callbacks</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Обработчик контент для узлов YAML. Ассоциативный массив, ключи которого являются
|
||||
тегами YAML, а значения callback-функциями, которые будут их обрабатывать.
|
||||
Более подробно этот механизм описан в разделе
|
||||
<link linkend="yaml.callbacks.parse">callback-функции разбора</link>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<para>
|
||||
Возвращает закодированое в <parameter>input</parameter> значение как соответствующий
|
||||
тип PHP&return.falseforfailure;. Если параметр <parameter>pos</parameter> равен
|
||||
<literal>-1</literal>, будет возвращен массив, содержащий по одной записи для каждого
|
||||
документа, найденого в потоке.
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="examples">
|
||||
&reftitle.examples;
|
||||
<para>
|
||||
<example>
|
||||
<title>Пример использования <function>yaml_parse</function></title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$yaml = <<<EOD
|
||||
---
|
||||
invoice: 34843
|
||||
date: "2001-01-23"
|
||||
bill-to: &id001
|
||||
given: Chris
|
||||
family: Dumars
|
||||
address:
|
||||
lines: |-
|
||||
458 Walkman Dr.
|
||||
Suite #292
|
||||
city: Royal Oak
|
||||
state: MI
|
||||
postal: 48046
|
||||
site: zxibit.esy.es
|
||||
ship-to: *id001
|
||||
product:
|
||||
- sku: BL394D
|
||||
quantity: 4
|
||||
description: Basketball
|
||||
price: 450
|
||||
- sku: BL4438H
|
||||
quantity: 1
|
||||
description: Super Hoop
|
||||
price: 2392
|
||||
tax: 251.420000
|
||||
total: 4443.520000
|
||||
comments: Late afternoon is best. Backup contact is Nancy Billsmer @ 338-4338.
|
||||
...
|
||||
EOD;
|
||||
|
||||
$parsed = yaml_parse($yaml);
|
||||
var_dump($parsed);
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
&example.outputs.similar;
|
||||
<screen>
|
||||
<![CDATA[
|
||||
array(8) {
|
||||
["invoice"]=>
|
||||
int(34843)
|
||||
["date"]=>
|
||||
string(10) "2001-01-23"
|
||||
["bill-to"]=>
|
||||
&array(3) {
|
||||
["given"]=>
|
||||
string(5) "Chris"
|
||||
["family"]=>
|
||||
string(6) "Dumars"
|
||||
["address"]=>
|
||||
array(4) {
|
||||
["lines"]=>
|
||||
string(34) "458 Walkman Dr.
|
||||
Suite #292"
|
||||
["city"]=>
|
||||
string(9) "Royal Oak"
|
||||
["state"]=>
|
||||
string(2) "MI"
|
||||
["postal"]=>
|
||||
int(48046)
|
||||
}
|
||||
}
|
||||
["ship-to"]=>
|
||||
&array(3) {
|
||||
["given"]=>
|
||||
string(5) "Chris"
|
||||
["family"]=>
|
||||
string(6) "Dumars"
|
||||
["address"]=>
|
||||
array(4) {
|
||||
["lines"]=>
|
||||
string(34) "458 Walkman Dr.
|
||||
Suite #292"
|
||||
["city"]=>
|
||||
string(9) "Royal Oak"
|
||||
["state"]=>
|
||||
string(2) "MI"
|
||||
["postal"]=>
|
||||
int(48046)
|
||||
}
|
||||
}
|
||||
["product"]=>
|
||||
array(2) {
|
||||
[0]=>
|
||||
array(4) {
|
||||
["sku"]=>
|
||||
string(6) "BL394D"
|
||||
["quantity"]=>
|
||||
int(4)
|
||||
["description"]=>
|
||||
string(10) "Basketball"
|
||||
["price"]=>
|
||||
int(450)
|
||||
}
|
||||
[1]=>
|
||||
array(4) {
|
||||
["sku"]=>
|
||||
string(7) "BL4438H"
|
||||
["quantity"]=>
|
||||
int(1)
|
||||
["description"]=>
|
||||
string(10) "Super Hoop"
|
||||
["price"]=>
|
||||
int(2392)
|
||||
}
|
||||
}
|
||||
["tax"]=>
|
||||
float(251.42)
|
||||
["total"]=>
|
||||
float(4443.52)
|
||||
["comments"]=>
|
||||
string(68) "Late afternoon is best. Backup contact is Nancy Billsmer @ 338-4338."
|
||||
}
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="notes">
|
||||
&reftitle.notes;
|
||||
<warning>
|
||||
<para>
|
||||
Обрабатывать не доверенный пользовательский ввод, в случае когда для узлов YAML,
|
||||
использующих тег <literal>!php/object</literal>, разрешено использование функции <function
|
||||
>unserialize</function>, крайне опасно. Это поведение можно отключить с помощью
|
||||
ini-настройки <literal>yaml.decode_php</literal>.
|
||||
</para>
|
||||
</warning>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="seealso">
|
||||
&reftitle.seealso;
|
||||
<para>
|
||||
<simplelist>
|
||||
<member><function>yaml_parse_file</function></member>
|
||||
<member><function>yaml_parse_url</function></member>
|
||||
<member><function>yaml_emit</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:"~/.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
|
||||
-->
|
||||
Reference in New Issue
Block a user