Files
php-doc-ru/reference/geoip/functions/geoip-db-get-all-info.xml
Sergey Panteleev daef8df962 Обнуление тега Reviewed (#364)
[skip-lint]
[skip-spellcheck]
2021-11-16 13:03:53 +03:00

160 lines
4.1 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cbac1ecf71d754707d69bdc344c4031c157eaa54 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.geoip-db-get-all-info" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>geoip_db_get_all_info</refname>
<refpurpose>Возвращает подробную информацию обо всех типах базы GeoIP</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>geoip_db_get_all_info</methodname>
<void />
</methodsynopsis>
<para>
Функция <function>geoip_db_get_all_info</function> возвращает
подробную информацию обо всех типах базы GeoIP в виде
многомерного массива.
</para>
<para>
Эта функция доступна даже при отсутствии установленных базы данных.
При этом типы будут перечислены и отмечены как недоступные.
</para>
<para>
Имена различных ключей возвращаемого ассоциативного массива:
</para>
<para>
<itemizedlist>
<listitem>
<simpara>
"available" -- Логический тип, указывает доступна ли база (смотрите
<function>geoip_db_avail</function>)
</simpara>
</listitem>
<listitem>
<simpara>
"description" -- Описание базы данных
</simpara>
</listitem>
<listitem>
<simpara>
"filename" -- Имя файла базы данных на диске (смотрите
<function>geoip_db_filename</function>)
</simpara>
</listitem>
</itemizedlist>
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает ассоциативный массив.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>geoip_db_get_all_info</function></title>
<para>
Выводит массив содержащий всю информацию о базе данных.
</para>
<programlisting role="php">
<![CDATA[
<?php
$infos = geoip_db_get_all_info();
if (is_array($infos)) {
var_dump($infos);
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
array(11) {
[1]=>
array(3) {
["available"]=>
bool(true)
["description"]=>
string(21) "GeoIP Country Edition"
["filename"]=>
string(32) "/usr/share/GeoIP/GeoIP.dat"
}
[ ... ]
[11]=>
array(3) {
["available"]=>
bool(false)
["description"]=>
string(25) "GeoIP Domain Name Edition"
["filename"]=>
string(38) "/usr/share/GeoIP/GeoIPDomain.dat"
}
}
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Пример использования <function>geoip_db_get_all_info</function></title>
<para>
Вы можете использовать разнообразные константы как ключи для получения только конкретной части информации.
</para>
<programlisting role="php">
<![CDATA[
<?php
$infos = geoip_db_get_all_info();
if ($infos[GEOIP_COUNTRY_EDITION]['available']) {
echo $infos[GEOIP_COUNTRY_EDITION]['description'];
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
GeoIP Country Edition
]]>
</screen>
</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
-->