reference/geoip/functions/geoip-domain-by-name.xml
4754397753fd79f1c846868b66a2448babab1c54
...
...
@@ -1,100 +1,100 @@
1
-
<?xml version="1.0" encoding="utf-8"?>
2
-
<!-- $Revision$ -->
3
-
<refentry xml:id="function.geoip-domain-by-name" xmlns="http://docbook.org/ns/docbook">
4
-
<refnamediv>
5
-
<refname>geoip_domain_by_name</refname>
6
-
<refpurpose>Get the second level domain name</refpurpose>
7
-
</refnamediv>
8
-
<refsect1 role="description">
9
-
&reftitle.description;
10
-
<methodsynopsis>
11
-
<type>string</type><methodname>geoip_domain_by_name</methodname>
12
-
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
13
-
</methodsynopsis>
14
-
15
-
<para>
16
-
The <function>geoip_domain_by_name</function> function will return the second level
17
-
domain names associated with a hostname or an IP address.
18
-
</para>
19
-
<para>
20
-
This function is currently only available to users who have bought a commercial
21
-
GeoIP Domain Edition. A warning will be issued if the proper database cannot be
22
-
located.
23
-
</para>
24
-
25
-
</refsect1>
26
-
<refsect1 role="parameters">
27
-
&reftitle.parameters;
28
-
<para>
29
-
<variablelist>
30
-
<varlistentry>
31
-
<term><parameter>hostname</parameter></term>
32
-
<listitem>
33
-
<para>
34
-
The hostname or IP address.
35
-
</para>
36
-
</listitem>
37
-
</varlistentry>
38
-
</variablelist>
39
-
</para>
40
-
</refsect1>
41
-
<refsect1 role="returnvalues">
42
-
&reftitle.returnvalues;
43
-
<para>
44
-
Returns the domain name on success, or &false; if the address
45
-
cannot be found in the database.
46
-
</para>
47
-
</refsect1>
48
-
49
-
<refsect1 role="examples">
50
-
&reftitle.examples;
51
-
<para>
52
-
<example>
53
-
<title>A <function>geoip_domain_by_name</function> example</title>
54
-
<para>
55
-
This will output the domain associated with IP 61.106.139.1.
56
-
</para>
57
-
<programlisting role="php">
58
-
<![CDATA[
59
-
<?php
60
-
$domain = geoip_domain_by_name('61.106.139.1');
61
-
62
-
if ($domain) {
63
-
echo 'The domain is: '. $domain;
64
-
}
65
-
66
-
?>
67
-
]]>
68
-
</programlisting>
69
-
&example.outputs;
70
-
<screen>
71
-
<![CDATA[
72
-
The domain is: von.co.kr
73
-
]]>
74
-
</screen>
75
-
</example>
76
-
</para>
77
-
</refsect1>
78
-
79
-
</refentry>
80
-
81
-
<!-- Keep this comment at the end of the file
82
-
Local variables:
83
-
mode: sgml
84
-
sgml-omittag:t
85
-
sgml-shorttag:t
86
-
sgml-minimize-attributes:nil
87
-
sgml-always-quote-attributes:t
88
-
sgml-indent-step:1
89
-
sgml-indent-data:t
90
-
indent-tabs-mode:nil
91
-
sgml-parent-document:nil
92
-
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
93
-
sgml-exposed-tags:nil
94
-
sgml-local-catalogs:nil
95
-
sgml-local-ecat-files:nil
96
-
End:
97
-
vim600: syn=xml fen fdm=syntax fdl=2 si
98
-
vim: et tw=78 syn=sgml
99
-
vi: ts=1 sw=1
100
-
-->
1
+
<?xml version="1.0" encoding="utf-8"?>
2
+
<!-- $Revision$ -->
3
+
<refentry xml:id="function.geoip-domain-by-name" xmlns="http://docbook.org/ns/docbook">
4
+
<refnamediv>
5
+
<refname>geoip_domain_by_name</refname>
6
+
<refpurpose>Get the second level domain name</refpurpose>
7
+
</refnamediv>
8
+
<refsect1 role="description">
9
+
&reftitle.description;
10
+
<methodsynopsis>
11
+
<type>string</type><methodname>geoip_domain_by_name</methodname>
12
+
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
13
+
</methodsynopsis>
14
+

15
+
<para>
16
+
The <function>geoip_domain_by_name</function> function will return the second level
17
+
domain names associated with a hostname or an IP address.
18
+
</para>
19
+
<para>
20
+
This function is currently only available to users who have bought a commercial
21
+
GeoIP Domain Edition. A warning will be issued if the proper database cannot be
22
+
located.
23
+
</para>
24
+
25
+
</refsect1>
26
+
<refsect1 role="parameters">
27
+
&reftitle.parameters;
28
+
<para>
29
+
<variablelist>
30
+
<varlistentry>
31
+
<term><parameter>hostname</parameter></term>
32
+
<listitem>
33
+
<para>
34
+
The hostname or IP address.
35
+
</para>
36
+
</listitem>
37
+
</varlistentry>
38
+
</variablelist>
39
+
</para>
40
+
</refsect1>
41
+
<refsect1 role="returnvalues">
42
+
&reftitle.returnvalues;
43
+
<para>
44
+
Returns the domain name on success, or &false; if the address
45
+
cannot be found in the database.
46
+
</para>
47
+
</refsect1>
48
+

49
+
<refsect1 role="examples">
50
+
&reftitle.examples;
51
+
<para>
52
+
<example>
53
+
<title>A <function>geoip_domain_by_name</function> example</title>
54
+
<para>
55
+
This will output the domain associated with IP 61.106.139.1.
56
+
</para>
57
+
<programlisting role="php">
58
+
<![CDATA[
59
+
<?php
60
+
$domain = geoip_domain_by_name('61.106.139.1');
61
+

62
+
if ($domain) {
63
+
echo 'The domain is: '. $domain;
64
+
}
65
+

66
+
?>
67
+
]]>
68
+
</programlisting>
69
+
&example.outputs;
70
+
<screen>
71
+
<![CDATA[
72
+
The domain is: von.co.kr
73
+
]]>
74
+
</screen>
75
+
</example>
76
+
</para>
77
+
</refsect1>
78
+

79
+
</refentry>
80
+

81
+
<!-- Keep this comment at the end of the file
82
+
Local variables:
83
+
mode: sgml
84
+
sgml-omittag:t
85
+
sgml-shorttag:t
86
+
sgml-minimize-attributes:nil
87
+
sgml-always-quote-attributes:t
88
+
sgml-indent-step:1
89
+
sgml-indent-data:t
90
+
indent-tabs-mode:nil
91
+
sgml-parent-document:nil
92
+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
93
+
sgml-exposed-tags:nil
94
+
sgml-local-catalogs:nil
95
+
sgml-local-ecat-files:nil
96
+
End:
97
+
vim600: syn=xml fen fdm=syntax fdl=2 si
98
+
vim: et tw=78 syn=sgml
99
+
vi: ts=1 sw=1
100
+
-->
101
101