-
Notifications
You must be signed in to change notification settings - Fork 70
/
get-meta-tags.xml
147 lines (139 loc) · 5.32 KB
/
get-meta-tags.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6ecb3d252204d4f7077eb5221209b4eab0216c18 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.get-meta-tags" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>get_meta_tags</refname>
<refpurpose>Извлекает содержимое всех метатегов из файла и возвращает массив</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>array</type><type>false</type></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><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
Открывает <parameter>filename</parameter> и разбирает его по строкам
в поисках тегов <meta>. Разбор файла останавливается на теге
<literal></head></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>
</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>
<para>
Возвращает &false; в случае возникновения ошибки.
</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="notes">
&reftitle.notes;
<note>
<para>
Обрабатываются только метатеги с атрибутом name. Кавычки не требуются.
</para>
</note>
</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:"~/.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
-->