cvs: phpdoc-ru /reference/url .cvsignore /reference/url/functions get-meta-tags.xml

tony2001 Tue Feb 26 08:34:18 2008 UTC Added files: /phpdoc-ru/reference/url .cvsignore /phpdoc-ru/reference/url/functions get-meta-tags.xml Log: add new translation by idler http://cvs.php.net/viewvc.cgi/phpdoc-ru/reference/url/.cvsignore?view=markup&rev=1.1 Index: phpdoc-ru/reference/url/.cvsignore +++ phpdoc-ru/reference/url/.cvsignore entities.*.xml http://cvs.php.net/viewvc.cgi/phpdoc-ru/reference/url/functions/get-meta-tags.xml?view=markup&rev=1.1 Index: phpdoc-ru/reference/url/functions/get-meta-tags.xml +++ phpdoc-ru/reference/url/functions/get-meta-tags.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <refentry xml:id="function.get-meta-tags" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>get_meta_tags</refname> <refpurpose>Извлекает из файла содержание атрибута content всех мета-тегов и возвращает как ассоциативный массив</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>get_meta_tags</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>use_include_path</parameter></methodparam> </methodsynopsis> <para> Открывает <parameter>filename</parameter> и разбирает его строка за строкой в поисках тегов &lt;meta&gt;. Разбор файла останавливается на теге <literal>&lt;/head&gt;</literal>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>filename</parameter></term> <listitem> <para> Путь к HTML файлу. Может быть как локальным файлом, так и <acronym>URL</acronym>. </para> <para> <example> <title>Что обрабатывает функция <function>get_meta_tags</function></title> <programlisting role="html"> <![CDATA[ <meta name="author" content="name"> <meta name="keywords" content="php documentation"> <meta name="DESCRIPTION" content="a php manual"> <meta name="geo.position" content="49.33;-86.59"> </head> <!-- разбор файла будет остановлен здесь --> ]]> </programlisting> </example> (обратите внимание на символы конца строки - PHP использует для разбора строк функции, встроенные в операционную систему, поэтому файлы, созданные в MacOS не будут правильно обрабатываться на Unix). </para> </listitem> </varlistentry> <varlistentry> <term><parameter>use_include_path</parameter></term> <listitem> <para> Если <parameter>use_include_path</parameter> равен &true;, PHP будет искать файл используя стандартные пути поиска из директивы &php.ini; <link linkend="ini.include-path">include_path</link>. Это актуально только для локальных файлов, но не для URL. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Возвращает ассоциативный массив со значениями разобранных мета-тегов. </para> <para> Значение атрибута name становится ключом массива, а значение атрибута content - значением этого элемента. Вы можете использовать стандартные функции работы с массивам для доступа к конкретным значениям. Специальные символы в именах (ключах массива) заменяются на '_', и ключи приводятся к нижнему регистру. Если два мета-тега имеют одинаковые имена, будет возвращен только последний. </para> </refsect1> <refsect1 role="changelog"> &reftitle.changelog; <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>&Version;</entry> <entry>&Description;</entry> </row> </thead> <tbody> <row> <entry>4.0.5</entry> <entry> Добавлена поддержка HTML-атрибутов не заключенных в кавычки. </entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Что возвращает функция <function>get_meta_tags</function></title> <programlisting role="php"> <![CDATA[ <?php // Предположим, что указанные выше мета-теги расположены на www.example.com $tags = get_meta_tags('http://www.example.com/'); // Заметьте, что ключи приведены к нижнему регистру, а // точки ('.') в ключах заменены на '_' echo $tags['author']; // name echo $tags['keywords']; // php documentation echo $tags['description']; // a php manual echo $tags['geo_position']; // 49.33;-86.59 ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>htmlentities</function></member> <member><function>urlencode</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->