mirror of
https://github.com/php/doc-ru.git
synced 2025-07-24 09:59:46 +00:00
Sergey Panteleev
@ -1,5 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 61c8d3872997a4825e7ed401eb6edbc3251231f9 Maintainer: aur Status: ready -->
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: aur Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<chapter xml:id="dom.constants" xmlns="http://docbook.org/ns/docbook">
|
||||
&reftitle.constants;
|
||||
@ -253,9 +253,9 @@
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
<row xml:id="constant.dom-no-default-ns">
|
||||
<row xml:id="constant.dom-html-no-default-ns">
|
||||
<entry>
|
||||
<constant>Dom\NO_DEFAULT_NS</constant>
|
||||
<constant>Dom\HTML_NO_DEFAULT_NS</constant>
|
||||
(<type>int</type>)
|
||||
</entry>
|
||||
<entry>
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: ebbc5bb97c8c063d31309725c0bb93d21213993b Maintainer: sergey Status: ready -->
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: sergey Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<reference xml:id="class.dom-htmldocument" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
|
||||
<title>Класс Dom\HTMLDocument</title>
|
||||
@ -10,7 +10,7 @@
|
||||
<section xml:id="dom-htmldocument.intro">
|
||||
&reftitle.intro;
|
||||
<simpara>
|
||||
Представляет документ <acronym>HTML</acronym>.
|
||||
Класс представляет <acronym>HTML</acronym>-документ.
|
||||
</simpara>
|
||||
</section>
|
||||
|
||||
@ -42,10 +42,12 @@
|
||||
</xi:include>
|
||||
|
||||
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
|
||||
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
|
||||
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-htmldocument')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\HTMLDocument'])">
|
||||
<xi:fallback/>
|
||||
</xi:include>
|
||||
|
||||
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
|
||||
<classsynopsisinfo role="comment">Пока не документировано</classsynopsisinfo>
|
||||
<classsynopsisinfo role="comment">Пока не задокументировали</classsynopsisinfo>
|
||||
</classsynopsis>
|
||||
</section>
|
||||
|
||||
@ -56,4 +58,6 @@
|
||||
|
||||
</partintro>
|
||||
|
||||
&reference.dom.dom.entities.htmldocument;
|
||||
|
||||
</reference>
|
||||
|
||||
95
reference/dom/dom/htmldocument/createempty.xml
Normal file
95
reference/dom/dom/htmldocument/createempty.xml
Normal file
@ -0,0 +1,95 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: malferov Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xml:id="dom-htmldocument.createempty" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refnamediv>
|
||||
<refname>Dom\HTMLDocument::createEmpty</refname>
|
||||
<refpurpose>Создает пустой <acronym>HTML</acronym>-документ</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
&reftitle.description;
|
||||
<methodsynopsis role="Dom\\HTMLDocument">
|
||||
<modifier>public</modifier> <modifier>static</modifier> <type>Dom\HTMLDocument</type><methodname>Dom\HTMLDocument::createEmpty</methodname>
|
||||
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>"UTF-8"</initializer></methodparam>
|
||||
</methodsynopsis>
|
||||
<simpara>
|
||||
Метод создаёт пустой <acronym>HTML</acronym>-документ, без элементов.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
&reftitle.parameters;
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><parameter>encoding</parameter></term>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Кодировка символов документа для сериализации
|
||||
при вызове методов сохранения.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<simpara>
|
||||
Метод возвращает пустой <acronym>HTML</acronym>-документ.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="examples">
|
||||
&reftitle.examples;
|
||||
<example xml:id="dom-htmldocument.createempty.example.basic">
|
||||
<title>Пример создания пустого HTML-документа методом <methodname>Dom\HTMLDocument::createEmpty</methodname></title>
|
||||
<simpara>
|
||||
Пример создаёт пустой документ и сериализует его.
|
||||
</simpara>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$dom = Dom\HTMLDocument::createEmpty();
|
||||
var_dump($dom->saveHtml());
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
&example.outputs;
|
||||
<screen>
|
||||
<![CDATA[
|
||||
string(0) ""
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="seealso">
|
||||
&reftitle.seealso;
|
||||
<simplelist>
|
||||
<member><methodname>Dom\HTMLDocument::createFromString</methodname></member>
|
||||
<member><methodname>Dom\HTMLDocument::createFromFile</methodname></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:"~/.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
|
||||
-->
|
||||
107
reference/dom/dom/htmldocument/createfromfile.xml
Normal file
107
reference/dom/dom/htmldocument/createfromfile.xml
Normal file
@ -0,0 +1,107 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: malferov Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xml:id="dom-htmldocument.createfromfile" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refnamediv>
|
||||
<refname>Dom\HTMLDocument::createFromFile</refname>
|
||||
<refpurpose>Разбирает содержимое файла как <acronym>HTML</acronym>-документ</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
&reftitle.description;
|
||||
<methodsynopsis role="Dom\\HTMLDocument">
|
||||
<modifier>public</modifier> <modifier>static</modifier> <type>Dom\HTMLDocument</type><methodname>Dom\HTMLDocument::createFromFile</methodname>
|
||||
<methodparam><type>string</type><parameter>path</parameter></methodparam>
|
||||
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
|
||||
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>overrideEncoding</parameter><initializer>&null;</initializer></methodparam>
|
||||
</methodsynopsis>
|
||||
<simpara>
|
||||
Метод разбирает <acronym>HTML</acronym>-документ из файла
|
||||
в соответствии со стандартом.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
&reftitle.parameters;
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><parameter>path</parameter></term>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Путь к файлу, который требуется разобрать.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>options</parameter></term>
|
||||
<listitem>
|
||||
&dom.parameter.compliant.options;
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>overrideEncoding</parameter></term>
|
||||
<listitem>
|
||||
&dom.parameter.compliant.encoding;
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<simpara>
|
||||
Метод возвращает разобранный документ как экземпляр класса <classname>Dom\HTMLDocument</classname>.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="errors">
|
||||
&reftitle.errors;
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Метод выбрасывает ошибку <exceptionname>ValueError</exceptionname>,
|
||||
если аргумент <parameter>path</parameter> содержит нулевые байты или последовательность символов
|
||||
<literal>"%00"</literal>.
|
||||
</simpara>
|
||||
</listitem>
|
||||
&dom.errors.compliant.common;
|
||||
<listitem>
|
||||
<simpara>
|
||||
Метод выбрасывает исключение <exceptionname>Exception</exceptionname>,
|
||||
если файл невозможно открыть.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</refsect1>
|
||||
|
||||
&dom.parser.compliant.note.whitespace;
|
||||
|
||||
<refsect1 role="seealso">
|
||||
&reftitle.seealso;
|
||||
<simplelist>
|
||||
<member><methodname>Dom\HTMLDocument::createEmpty</methodname></member>
|
||||
<member><methodname>Dom\HTMLDocument::createFromString</methodname></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:"~/.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
|
||||
-->
|
||||
127
reference/dom/dom/htmldocument/createfromstring.xml
Normal file
127
reference/dom/dom/htmldocument/createfromstring.xml
Normal file
@ -0,0 +1,127 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: malferov Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xml:id="dom-htmldocument.createfromstring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refnamediv>
|
||||
<refname>Dom\HTMLDocument::createFromString</refname>
|
||||
<refpurpose>Разбирает содержимое строки как <acronym>HTML</acronym>-документ</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
&reftitle.description;
|
||||
<methodsynopsis role="Dom\\HTMLDocument">
|
||||
<modifier>public</modifier> <modifier>static</modifier> <type>Dom\HTMLDocument</type><methodname>Dom\HTMLDocument::createFromString</methodname>
|
||||
<methodparam><type>string</type><parameter>source</parameter></methodparam>
|
||||
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
|
||||
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>overrideEncoding</parameter><initializer>&null;</initializer></methodparam>
|
||||
</methodsynopsis>
|
||||
<simpara>
|
||||
Разбирает <acronym>HTML</acronym>-документ из строки
|
||||
в соответствии со стандартом.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
&reftitle.parameters;
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><parameter>source</parameter></term>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Строка с <acronym>HTML</acronym>-разметкой для разбора.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>options</parameter></term>
|
||||
<listitem>
|
||||
&dom.parameter.compliant.options;
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>overrideEncoding</parameter></term>
|
||||
<listitem>
|
||||
&dom.parameter.compliant.encoding;
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<simpara>
|
||||
Метод возвращает разобранный документ как экземпляр класса <classname>Dom\HTMLDocument</classname>.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="errors">
|
||||
&reftitle.errors;
|
||||
<itemizedlist>
|
||||
&dom.errors.compliant.common;
|
||||
</itemizedlist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="examples">
|
||||
&reftitle.examples;
|
||||
<example xml:id="dom-htmldocument.createfromstring.example.basic">
|
||||
<title>Пример разбора строки методом <methodname>Dom\HTMLDocument::createFromString</methodname></title>
|
||||
<simpara>
|
||||
Пример разбирает образец строки.
|
||||
</simpara>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
<?php
|
||||
$dom = Dom\HTMLDocument::createFromString(<<<'HTML'
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<body>
|
||||
<p>Привет, мир!</p>
|
||||
</body>
|
||||
</html>
|
||||
HTML);
|
||||
echo $dom->saveHtml();
|
||||
?>
|
||||
]]>
|
||||
</programlisting>
|
||||
&example.outputs;
|
||||
<screen>
|
||||
<![CDATA[
|
||||
<!DOCTYPE html><html><head></head><body>
|
||||
<p>Привет, мир!</p>
|
||||
</body></html>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
</refsect1>
|
||||
|
||||
&dom.parser.compliant.note.whitespace;
|
||||
|
||||
<refsect1 role="seealso">
|
||||
&reftitle.seealso;
|
||||
<simplelist>
|
||||
<member><methodname>Dom\HTMLDocument::createEmpty</methodname></member>
|
||||
<member><methodname>Dom\HTMLDocument::createFromFile</methodname></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:"~/.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
|
||||
-->
|
||||
79
reference/dom/dom/htmldocument/savehtml.xml
Normal file
79
reference/dom/dom/htmldocument/savehtml.xml
Normal file
@ -0,0 +1,79 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: malferov Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xml:id="dom-htmldocument.savehtml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refnamediv>
|
||||
<refname>Dom\HTMLDocument::saveHtml</refname>
|
||||
<refpurpose>Сериализует документ как <acronym>HTML</acronym>-строку</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
&reftitle.description;
|
||||
<methodsynopsis role="Dom\\HTMLDocument">
|
||||
<modifier>public</modifier> <type>string</type><methodname>Dom\HTMLDocument::saveHtml</methodname>
|
||||
<methodparam choice="opt"><type class="union"><type>Dom\Node</type><type>null</type></type><parameter>node</parameter><initializer>&null;</initializer></methodparam>
|
||||
</methodsynopsis>
|
||||
<simpara>
|
||||
Метод сериализует объект HTML-документа и возвращает результат как строку с <acronym>HTML</acronym>-разметкой.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
&reftitle.parameters;
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><parameter>node</parameter></term>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Узел, который требуется сериализовать.
|
||||
Метод сериализует весь документ, если узел не указали.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<simpara>
|
||||
Метод возвращает <acronym>HTML</acronym>-строку, которую получил путём сериализации документа.
|
||||
Метод сохраняет строку в текущей кодировке документа.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="errors">
|
||||
&reftitle.errors;
|
||||
<itemizedlist>
|
||||
&dom.errors.compliant.wrong_document;
|
||||
</itemizedlist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="seealso">
|
||||
&reftitle.seealso;
|
||||
<simplelist>
|
||||
<member><methodname>Dom\HTMLDocument::saveHtmlFile</methodname></member>
|
||||
<member><methodname>Dom\HTMLDocument::saveXml</methodname></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:"~/.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
|
||||
-->
|
||||
83
reference/dom/dom/htmldocument/savehtmlfile.xml
Normal file
83
reference/dom/dom/htmldocument/savehtmlfile.xml
Normal file
@ -0,0 +1,83 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: malferov Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xml:id="dom-htmldocument.savehtmlfile" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refnamediv>
|
||||
<refname>Dom\HTMLDocument::saveHtmlFile</refname>
|
||||
<refpurpose>Сериализует документ как <acronym>HTML</acronym>-файл</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
&reftitle.description;
|
||||
<methodsynopsis role="Dom\\HTMLDocument">
|
||||
<modifier>public</modifier> <type class="union"><type>int</type><type>false</type></type><methodname>Dom\HTMLDocument::saveHtmlFile</methodname>
|
||||
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
|
||||
</methodsynopsis>
|
||||
<simpara>
|
||||
Метод сериализует объект HTML-документа и сохраняет результат в файл как строку с <acronym>HTML</acronym>-разметкой.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
&reftitle.parameters;
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><parameter>filename</parameter></term>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Путь к файлу, в который требуется сохранить данные.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<simpara>
|
||||
Метод возвращает количество байтов, которые записал в файл, если выполнился успешно, или &false;, если возникла ошибка.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="errors">
|
||||
&reftitle.errors;
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Метод выбрасывает ошибку <exceptionname>ValueError</exceptionname>,
|
||||
если в аргументе <parameter>filename</parameter> передали пустую строку или аргумент содержит
|
||||
нулевые байты.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="seealso">
|
||||
&reftitle.seealso;
|
||||
<simplelist>
|
||||
<member><methodname>Dom\HTMLDocument::saveHtml</methodname></member>
|
||||
<member><methodname>Dom\HTMLDocument::saveXmlFile</methodname></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:"~/.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
|
||||
-->
|
||||
87
reference/dom/dom/htmldocument/savexml.xml
Normal file
87
reference/dom/dom/htmldocument/savexml.xml
Normal file
@ -0,0 +1,87 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: malferov Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xml:id="dom-htmldocument.savexml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refnamediv>
|
||||
<refname>Dom\HTMLDocument::saveXml</refname>
|
||||
<refpurpose>Сериализует документ как <acronym>XML</acronym>-строку</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
&reftitle.description;
|
||||
<methodsynopsis role="Dom\\HTMLDocument">
|
||||
<modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>Dom\HTMLDocument::saveXml</methodname>
|
||||
<methodparam choice="opt"><type class="union"><type>Dom\Node</type><type>null</type></type><parameter>node</parameter><initializer>&null;</initializer></methodparam>
|
||||
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
|
||||
</methodsynopsis>
|
||||
<simpara>
|
||||
Метод сериализует объект HTML-документа и возвращает результат как строку в формате <acronym>XML</acronym>.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
&reftitle.parameters;
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><parameter>node</parameter></term>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Узел, который требуется сериализовать.
|
||||
Метод сериализует весь документ, если узел не указали.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>options</parameter></term>
|
||||
<listitem>
|
||||
&dom.parameters.serialize.options;
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<simpara>
|
||||
Метод возвращает <acronym>XML</acronym>-строку, которую получил путём сериализации документа,
|
||||
или &false;, если возникла ошибка.
|
||||
Метод сохраняет строку в текущей кодировке документа.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="errors">
|
||||
&reftitle.errors;
|
||||
<itemizedlist>
|
||||
&dom.errors.compliant.wrong_document;
|
||||
</itemizedlist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="seealso">
|
||||
&reftitle.seealso;
|
||||
<simplelist>
|
||||
<member><methodname>Dom\HTMLDocument::saveXmlFile</methodname></member>
|
||||
<member><methodname>Dom\XMLDocument::saveHtml</methodname></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:"~/.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
|
||||
-->
|
||||
90
reference/dom/dom/htmldocument/savexmlfile.xml
Normal file
90
reference/dom/dom/htmldocument/savexmlfile.xml
Normal file
@ -0,0 +1,90 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: malferov Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xml:id="dom-htmldocument.savexmlfile" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<refnamediv>
|
||||
<refname>Dom\HTMLDocument::saveXmlFile</refname>
|
||||
<refpurpose>Сериализует документ как <acronym>XML</acronym>-файл</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<refsect1 role="description">
|
||||
&reftitle.description;
|
||||
<methodsynopsis role="Dom\\HTMLDocument">
|
||||
<modifier>public</modifier> <type class="union"><type>int</type><type>false</type></type><methodname>Dom\HTMLDocument::saveXmlFile</methodname>
|
||||
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
|
||||
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
|
||||
</methodsynopsis>
|
||||
<simpara>
|
||||
Метод сериализует объект HTML-документа и сохраняет результат в файл как строку в формате <acronym>XML</acronym>.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="parameters">
|
||||
&reftitle.parameters;
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><parameter>filename</parameter></term>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Путь к файлу, в который требуется сохранить данные.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>options</parameter></term>
|
||||
<listitem>
|
||||
&dom.parameters.serialize.options;
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<simpara>
|
||||
Метод возвращает количество байтов, которые записал в файл, если выполнился успешно, или &false;, если возникла ошибка.
|
||||
</simpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="errors">
|
||||
&reftitle.errors;
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Метод выбрасывает ошибку <exceptionname>ValueError</exceptionname>,
|
||||
если в аргументе <parameter>filename</parameter> передали пустую строку или аргумент содержит
|
||||
нулевые байты.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 role="seealso">
|
||||
&reftitle.seealso;
|
||||
<simplelist>
|
||||
<member><methodname>Dom\HTMLDocument::saveXml</methodname></member>
|
||||
<member><methodname>Dom\HTMLDocument::saveHtmlFile</methodname></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:"~/.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
|
||||
-->
|
||||
@ -1,5 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 40476b2960f884b088d77f38b6bef2c43b662d10 Maintainer: tmn Status: ready -->
|
||||
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: tmn Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<refentry xml:id="domdocument.savexml" xmlns="http://docbook.org/ns/docbook">
|
||||
<refnamediv>
|
||||
@ -16,8 +16,8 @@
|
||||
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
|
||||
</methodsynopsis>
|
||||
<para>
|
||||
Создаёт XML-документ из представления DOM. Эту функцию обычно вызывают
|
||||
после построения нового DOM-документа, как показано в примере ниже.
|
||||
Метод создаёт XML-документ из DOM-представления. Эту функцию часто вызывают
|
||||
после построения нового DOM-документа, как показывает пример на этой странице.
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
@ -29,20 +29,15 @@
|
||||
<term><parameter>node</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Этот аргумент используют для вывода только определённого узла без
|
||||
объявления XML, а не всего документа целиком.
|
||||
Аргумент передают, чтобы вывести только конкретный узел
|
||||
без XML-объявления, а не всего документа.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><parameter>options</parameter></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Дополнительные настройки.
|
||||
Поддерживаются константы <link linkend="libxml.constants">LIBXML_NOEMPTYTAG</link>
|
||||
и <link linkend="libxml.constants">LIBXML_NOXMLDECL</link>.
|
||||
До версии PHP 8.3.0 поддерживалась только константа <link linkend="libxml.constants">LIBXML_NOEMPTYTAG</link>.
|
||||
</para>
|
||||
&dom.parameters.serialize.options;
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
@ -52,7 +47,7 @@
|
||||
<refsect1 role="returnvalues">
|
||||
&reftitle.returnvalues;
|
||||
<para>
|
||||
Возвращает XML или &false; в случае возникновения ошибки.
|
||||
Метод возвращает XML-строку или &false;, если возникла ошибка.
|
||||
</para>
|
||||
</refsect1>
|
||||
<refsect1 role="errors">
|
||||
@ -63,8 +58,7 @@
|
||||
<term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Возникает, если <parameter>node</parameter> принадлежит другому
|
||||
документу.
|
||||
Ошибка возникает, если узел <parameter>node</parameter> принадлежит другому
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@ -86,7 +80,7 @@
|
||||
<row>
|
||||
<entry>8.3.0</entry>
|
||||
<entry>
|
||||
Теперь поддерживается константа <link linkend="libxml.constants">LIBXML_NOXMLDECL</link>.
|
||||
Параметры метода теперь поддерживают константу <link linkend="libxml.constants">LIBXML_NOXMLDECL</link>.
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
@ -99,7 +93,7 @@
|
||||
<para>
|
||||
<example>
|
||||
<title>
|
||||
Сохранение DOM-дерева в виде строки
|
||||
Пример сохранения DOM-дерева в виде строки
|
||||
</title>
|
||||
<programlisting role="php">
|
||||
<![CDATA[
|
||||
@ -115,7 +109,7 @@ $root = $doc->appendChild($root);
|
||||
$title = $doc->createElement('title');
|
||||
$title = $root->appendChild($title);
|
||||
|
||||
$text = $doc->createTextNode('Это заголовок');
|
||||
$text = $doc->createTextNode('Заголовок');
|
||||
$text = $title->appendChild($text);
|
||||
|
||||
echo "Сохранение всего документа:\n";
|
||||
@ -133,11 +127,11 @@ echo $doc->saveXML($title);
|
||||
Сохранение всего документа:
|
||||
<?xml version="1.0"?>
|
||||
<book>
|
||||
<title>Это заголовок</title>
|
||||
<title>Заголовок</title>
|
||||
</book>
|
||||
|
||||
Сохранение только заголовка:
|
||||
<title>Это заголовок</title>
|
||||
<title>Заголовок</title>
|
||||
]]>
|
||||
</screen>
|
||||
</example>
|
||||
|
||||
Reference in New Issue
Block a user