1
0
mirror of https://github.com/php/doc-ja.git synced 2026-03-23 22:52:11 +01:00

geoip: fix XML by converting para to simpara tags via script

This commit is contained in:
Gina Peter Banyard
2026-01-18 20:05:13 +00:00
parent d7a2786f86
commit 66b081d205
23 changed files with 253 additions and 258 deletions

View File

@@ -1,24 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: takagi Status: ready -->
<book xml:id="book.geoip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.geoip">
<?phpdoc extension-membership="pecl" ?>
<title>Geo IP ロケーション</title>
<titleabbrev>GeoIP</titleabbrev>
<preface xml:id="intro.geoip">
&reftitle.intro;
<para>
<simpara>
GeoIP 拡張モジュールを使用すると、IP アドレスの場所を探すことができます。
市、州、国、経度、緯度そして ISP や接続方式などの情報が
GeoIP を用いて取得できます。
</para>
</simpara>
<warning>
<para>
<simpara>
この拡張モジュールは、MaxMind の現在の "GeoIP2" データベースをサポートしません。
"GeoIP legacy" データベース・ファイルのみサポートします。
</para>
</simpara>
</warning>
</preface>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: takagi Status: ready -->
<appendix xml:id="geoip.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="geoip.constants">
&reftitle.constants;
&extension.constants;
<variablelist>
@@ -127,9 +127,9 @@
</listitem>
</varlistentry>
</variablelist>
<para>
<simpara>
以下の定数は、ネット接続のスピードを表します。
</para>
</simpara>
<variablelist>
<varlistentry xml:id="constant.geoip-unknown-speed">
<term>
@@ -137,7 +137,7 @@
(<type>int</type>)
</term>
<listitem>
<simpara></simpara>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.geoip-dialup-speed">
@@ -146,7 +146,7 @@
(<type>int</type>)
</term>
<listitem>
<simpara></simpara>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.geoip-cabledsl-speed">
@@ -155,7 +155,7 @@
(<type>int</type>)
</term>
<listitem>
<simpara></simpara>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.geoip-corporate-speed">
@@ -164,12 +164,11 @@
(<type>int</type>)
</term>
<listitem>
<simpara></simpara>
<simpara/>
</listitem>
</varlistentry>
</variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: mumumu Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: mumumu Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-asnum-by-name">
<refnamediv>
<refname>geoip_asnum_by_name</refname>
@@ -13,10 +13,10 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_asnum_by_name</function> 関数は、
IPアドレスに関連付けられたAS番号(ASN)を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,28 +25,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
ホスト名またはIPアドレス
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功時にはAS番号を返します。
アドレスがデータベースに見つからなかった場合は &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_asnum_by_name</function> の例</title>
<para>
<simpara>
この例は、www.example.com のAS番号を出力します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-continent-code-by-name">
<refnamediv>
<refname>geoip_continent_code_by_name</refname>
@@ -13,10 +13,10 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_continent_code_by_name</function> 関数は、
ホスト名あるいは IP アドレスに対応する二文字の大陸コードを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,19 +25,19 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
場所を探す対象となるホスト名あるいは IP アドレス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合には二文字の大陸コード、
アドレスがデータベースで見つからない場合には &false; を返します。
</para>
</simpara>
<table>
<title>大陸コード</title>
<tgroup cols="2">
@@ -85,9 +85,9 @@
&reftitle.examples;
<example>
<title><function>geoip_continent_code_by_name</function> の例</title>
<para>
<simpara>
これは、ホスト example.com がどこにあるのかを表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.geoip-country-code-by-name">
<refnamediv>
<refname>geoip_country_code_by_name</refname>
@@ -13,10 +13,10 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_country_code_by_name</function> 関数は、
ホスト名あるいは IP アドレスに対応する二文字の国コードを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,28 +25,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
場所を探す対象となるホスト名あるいは IP アドレス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合には二文字の ISO 国コード、
アドレスがデータベースで見つからない場合には &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_country_code_by_name</function> の例</title>
<para>
<simpara>
これは、ホスト example.com がどこにあるのかを表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -69,11 +69,11 @@ This host is located in: US
<refsect1 role="notes">
&reftitle.notes;
<caution>
<para>
<simpara>
戻り値の完全なリストは
<link xlink:href="&url.maxmind.iso3166;">&url.maxmind.iso3166;</link>
を参照ください。ここには特別なコードも含まれています。
</para>
</simpara>
</caution>
</refsect1>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-country-code3-by-name">
<refnamediv>
<refname>geoip_country_code3_by_name</refname>
@@ -13,10 +13,10 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_country_code3_by_name</function> 関数は、
ホスト名あるいは IP アドレスに対応する三文字の国コードを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,28 +25,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
場所を探す対象となるホスト名あるいは IP アドレス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合には三文字の国コード、
アドレスがデータベースで見つからない場合には &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_country_code3_by_name</function> の例</title>
<para>
<simpara>
これは、ホスト example.com がどこにあるのかを表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-country-name-by-name">
<refnamediv>
<refname>geoip_country_name_by_name</refname>
@@ -13,10 +13,10 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_country_name_by_name</function> 関数は、
ホスト名あるいは IP アドレスに対応する完全な国名を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,28 +25,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
場所を探す対象となるホスト名あるいは IP アドレス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合には国名、
アドレスがデータベースで見つからない場合には &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_country_name_by_name</function> の例</title>
<para>
<simpara>
これは、ホスト example.com がどこにあるのかを表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-database-info">
<refnamediv>
<refname>geoip_database_info</refname>
@@ -13,16 +13,16 @@
<methodparam choice="opt"><type>int</type><parameter>database</parameter><initializer>GEOIP_COUNTRY_EDITION</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_database_info</function> 関数は、
GeoIP データベースのバージョンを返します。
このバージョンはバイナリファイルの内部で定義されています。
</para>
</simpara>
<para>
<simpara>
この関数を引数なしでコールすると、GeoIP Free Country Edition
のバージョンを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,11 +31,11 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
データベースの型を整数値で指定します。この拡張モジュールで定義されている
<link linkend="geoip.constants">さまざまな定数</link>
(例: GEOIP_*_EDITION) を使用することができます。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -43,18 +43,18 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
対応するデータベースのバージョン、あるいはエラー時に &null; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_database_info</function> の例</title>
<para>
<simpara>
これは、データベースに関する情報を出力します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-db-avail">
<refnamediv>
<refname>geoip_db_avail</refname>
@@ -13,15 +13,15 @@
<methodparam><type>int</type><parameter>database</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_db_avail</function> 関数は、対応する
GeoIP データベースが存在し、ディスク上にオープンできるかどうかを調べます。
</para>
</simpara>
<para>
<simpara>
これは、そのファイルが適切なデータベース形式かどうかを調べるものではありません。
単にそのファイルが読み込み可能かどうかを調べるだけです。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,11 +30,11 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
データベースの形式を表す整数値。この拡張モジュールで定義している
<link linkend="geoip.constants">さまざまな定数</link>
(GEOIP_*_EDITION) を使用することができます。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -42,19 +42,19 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
データベースが存在する場合に &true;、存在しない場合に &false;
エラー時に &null; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_db_avail</function> の例</title>
<para>
<simpara>
これは、現在のデータベースのバージョンを文字列で出力します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-db-filename">
<refnamediv>
<refname>geoip_db_filename</refname>
@@ -13,15 +13,15 @@
<methodparam><type>int</type><parameter>database</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_db_filename</function> 関数は、
対応する GeoIP データベースのファイル名を返します。
</para>
</simpara>
<para>
<simpara>
これは、そのファイルが存在するかどうかを表すものではありません。
単に、ライブラリがデータベースを探す先を返すだけのものです。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,11 +30,11 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
データベースの形式を表す整数値。この拡張モジュールで定義している
<link linkend="geoip.constants">さまざまな定数</link>
(GEOIP_*_EDITION) を使用することができます。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -42,18 +42,18 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
対応するデータベースのファイル名、あるいはエラー時に &null; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_db_filename</function> の例</title>
<para>
<simpara>
これは、対応するデータベースのファイル名を出力します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-db-get-all-info">
<refnamediv>
<refname>geoip_db_get_all_info</refname>
@@ -13,17 +13,17 @@
<void/>
</methodsynopsis>
<para>
<simpara>
<function>geoip_db_get_all_info</function> 関数は、
すべての GeoIP データベース形式についての詳細情報を多次元配列で返します。
</para>
<para>
</simpara>
<simpara>
この関数は、データベースがインストールされていない場合でも使用可能です。
その場合は、使用できないことが返されます。
</para>
<para>
</simpara>
<simpara>
返される連想配列のキーは、次のようになります。
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -53,18 +53,18 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
連想配列を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_db_get_all_info</function> の例</title>
<para>
<simpara>
これは、すべての情報を含む配列を表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -107,9 +107,9 @@ array(11) {
<example>
<title><function>geoip_db_get_all_info</function> の例</title>
<para>
<simpara>
さまざまな定数を使用することで、特定の情報のみを取得することができます。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: mumumu Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: mumumu Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-domain-by-name">
<refnamediv>
<refname>geoip_domain_by_name</refname>
@@ -13,14 +13,14 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_domain_by_name</function> 関数は ホスト名またはIPアドレスに関連付けられた
セカンドレベルドメイン名を返します。
</para>
<para>
</simpara>
<simpara>
この関数は、商用の GeoIP Domain Edition を購入したユーザーだけが利用可能です。
適切にデータベースが配置されていない場合は、警告が発生します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -29,28 +29,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
ホスト名またはIPアドレス
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功時にはドメイン名を返します。
アドレスがデータベースに存在しない場合は &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_domain_by_name</function> の例</title>
<para>
<simpara>
この例は、IPアドレス 61.106.139.1 に関連付けられているドメインを出力します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-id-by-name">
<refnamediv>
<refname>geoip_id_by_name</refname>
@@ -13,13 +13,13 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_id_by_name</function> 関数は、
ホスト名あるいは IP アドレスに対応するインターネット接続方式を返します。
</para>
<para>
</simpara>
<simpara>
戻り値は数値で、以下の定数と比較できます。
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -50,27 +50,27 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
接続方式を探す対象となるホスト名あるいは IP アドレス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
接続方式を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_id_by_name</function> の例</title>
<para>
<simpara>
これは、ホスト example.com の接続方式を返します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-isp-by-name">
<refnamediv>
<refname>geoip_isp_by_name</refname>
@@ -13,15 +13,15 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_isp_by_name</function> 関数は、
IP アドレスに対応するインターネットサービスプロバイダ (ISP) 名を返します。
</para>
<para>
</simpara>
<simpara>
現在この関数を使用できるのは、商用の
GeoIP ISP Edition を購入した人だけです。
適切なデータベースが見つからない場合には警告が発生します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,28 +30,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
ホスト名あるいは IP アドレス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合には ISP 名、
アドレスがデータベースで見つからない場合には &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_isp_by_name</function> の例</title>
<para>
<simpara>
これは、ホスト example.com の ISP 名を表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: mumumu Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: mumumu Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-netspeedcell-by-name">
<refnamediv>
<refname>geoip_netspeedcell_by_name</refname>
@@ -13,20 +13,20 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_netspeedcell_by_name</function> 関数は、
ホスト名またはIPアドレスに対応するインターネットへの接続タイプと接続速度を返します。
</para>
<para>
</simpara>
<simpara>
この関数は、GeoIP Library 1.4.8 以降でのみ利用可能です。
</para>
<para>
</simpara>
<simpara>
この関数は、商用の GeoIP NetSpeedCell Edition を購入したユーザーのみが利用可能です。
適切にデータベースが配置されていない場合は、警告が発生します。
</para>
<para>
</simpara>
<simpara>
この関数の戻り値は文字列です。共通の値は以下の通りです:
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -57,28 +57,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
ホスト名またはIPアドレス
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功時には接続スピードを返します。
アドレスがデータベースに存在しない場合は、&false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_netspeedcell_by_name</function> の例</title>
<para>
<simpara>
この例は、ホスト example.com の接続速度を出力します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-org-by-name">
<refnamediv>
<refname>geoip_org_by_name</refname>
@@ -13,15 +13,15 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_org_by_name</function> 関数は、
その IP アドレスが割り当てられている組織の名前を返します。
</para>
<para>
</simpara>
<simpara>
現在この関数を使用できるのは、商用の
GeoIP Organization, ISP あるいは AS Edition を購入した人だけです。
適切なデータベースが見つからない場合には警告が発生します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,28 +30,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
ホスト名あるいは IP アドレス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合には組織名、
アドレスがデータベースで見つからない場合には &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_org_by_name</function> の例</title>
<para>
<simpara>
これは、ホスト example.com の IP が誰に割り当てられているかを表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-record-by-name">
<refnamediv>
@@ -14,18 +14,18 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_record_by_name</function> 関数は、
ホスト名あるいは IP アドレスに対応するレコード情報を返します。
</para>
<para>
</simpara>
<simpara>
この関数は、GeoLite City Edition および商用の GeoIP
City Edition のどちらでも使用可能です。
適切なデータベースが見つからない場合には警告が発生します。
</para>
<para>
</simpara>
<simpara>
返される連想配列には、以下のようなさまざまな名前のキーが含まれます。
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -95,19 +95,19 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
レコードを探す対象となるホスト名あるいは IP アドレス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合には連想配列、
アドレスがデータベースで見つからない場合には &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -142,9 +142,9 @@
&reftitle.examples;
<example>
<title><function>geoip_record_by_name</function> の例</title>
<para>
<simpara>
これは、ホスト example.com のレコードを含む連想配列を表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-region-by-name">
<refnamediv>
<refname>geoip_region_by_name</refname>
@@ -13,18 +13,18 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_region_by_name</function> 関数は、
ホスト名あるいは IP アドレスに対応する国および地域を返します。
</para>
<para>
</simpara>
<simpara>
現在この関数を使用できるのは、商用の
GeoIP Region Edition を購入した人だけです。
適切なデータベースが見つからない場合には警告が発生します。
</para>
<para>
</simpara>
<simpara>
返される連想配列には、以下のようなさまざまな名前のキーが含まれます。
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -45,28 +45,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
地域を探す対象となるホスト名あるいは IP アドレス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合には連想配列、
アドレスがデータベースで見つからない場合には &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_region_by_name</function> の例</title>
<para>
<simpara>
これは、ホスト example.com の国コードおよび地域を含む配列を表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.geoip-region-name-by-code">
<refnamediv>
<refname>geoip_region_name_by_code</refname>
@@ -14,23 +14,23 @@
<methodparam><type>string</type><parameter>region_code</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_region_name_by_code</function> 関数は、
国コードと地域コードの組み合わせに対応する地域名を返します。
</para>
<para>
</simpara>
<simpara>
アメリカの場合、地域コードは各州の名前を二文字で略したものとなります。
カナダの場合、地域コードは Canada Post による二文字の州コードに対応します。
</para>
<para>
</simpara>
<simpara>
それ以外の場所では、GeoIP は FIPS 10-4 コードを用いて地域を表します。
FIPS 10-4 コードの詳細な一覧は
<link xlink:href="&url.maxmind.fips;">&url.maxmind.fips;</link> で確認できます。
</para>
<para>
</simpara>
<simpara>
この関数は、GeoIP Library バージョン 1.4.1 以降を使っている場合に使用可能です。
データは直接 GeoIP Library から受け取り、データベースは使用しません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -38,29 +38,29 @@
<varlistentry>
<term><parameter>country_code</parameter></term>
<listitem>
<para>
<simpara>
二文字の国コード
(<function>geoip_country_code_by_name</function> を参照ください)。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>region_code</parameter></term>
<listitem>
<para>
<simpara>
二文字 (あるいは二桁) の地域コード
(<function>geoip_region_by_name</function> を参照ください)。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合は地域名、国コードと地域コードの組に対応する地域が見つからなかった場合は
&false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -68,9 +68,9 @@
<para>
<example>
<title>US/Canada の地域コードを使用した <function>geoip_region_name_by_code</function> の例</title>
<para>
<simpara>
これは、国 CA (カナダ)、地域 QC (ケベック) に対応する地域名を表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -90,9 +90,9 @@ Region name for CA/QC is: Quebec
</example>
<example>
<title>FIPS コードを使用した <function>geoip_region_name_by_code</function> の例</title>
<para>
<simpara>
これは、国 JP (日本)、地域 01 に対応する地域名を表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: mumumu Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: mumumu Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-setup-custom-directory">
<refnamediv>
<refname>geoip_setup_custom_directory</refname>
@@ -13,11 +13,11 @@
<methodparam><type>string</type><parameter>path</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_setup_custom_directory</function> 関数は、
GeoIPデータベースのデフォルトディレクトリを変更します。
これは <link linkend="ini.geoip.custom-directory">geoip.custom_directory</link> を変更することと同等です。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,27 +26,27 @@
<varlistentry>
<term><parameter>path</parameter></term>
<listitem>
<para>
<simpara>
ディスク上に置くGeoIP データベースのフルパス。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>geoip_setup_custom_directory</function> の例</title>
<para>
<simpara>
この例は、GeoIP のデータベースパスを変更します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: takagi Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.geoip-time-zone-by-country-and-region">
<refnamediv>
<refname>geoip_time_zone_by_country_and_region</refname>
@@ -14,23 +14,23 @@
<methodparam choice="opt"><type>string</type><parameter>region_code</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_time_zone_by_country_and_region</function> 関数は、
国コードと地域コードの組み合わせに対応するタイムゾーンを返します。
</para>
<para>
</simpara>
<simpara>
アメリカの場合、地域コードは各州の名前を二文字で略したものとなります。
カナダの場合、地域コードは Canada Post による二文字の州コードに対応します。
</para>
<para>
</simpara>
<simpara>
それ以外の場所では、GeoIP は FIPS 10-4 コードを用いて地域を表します。
FIPS 10-4 コードの詳細な一覧は
<link xlink:href="&url.maxmind.fips;">&url.maxmind.fips;</link> で確認できます。
</para>
<para>
</simpara>
<simpara>
この関数は、GeoIP Library バージョン 1.4.1 以降を使っている場合に使用可能です。
データは直接 GeoIP Library から受け取り、データベースは使用しません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -38,29 +38,29 @@
<varlistentry>
<term><parameter>country_code</parameter></term>
<listitem>
<para>
<simpara>
二文字の国コード
(<function>geoip_country_code_by_name</function> を参照ください)。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>region_code</parameter></term>
<listitem>
<para>
<simpara>
二文字 (あるいは二桁) の地域コード
(<function>geoip_region_by_name</function> を参照ください)。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合はタイムゾーン、国コードと地域コードの組に対応するタイムゾーンが見つからなかった場合は
&false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -68,9 +68,9 @@
<para>
<example>
<title>US/Canada の地域コードを使用した <function>geoip_time_zone_by_country_and_region</function> の例</title>
<para>
<simpara>
これは、国 CA (カナダ)、地域 QC (ケベック) に対応するタイムゾーンを表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -90,9 +90,9 @@ Time zone for CA/QC is: America/Montreal
</example>
<example>
<title>FIPS コードを使用した <function>geoip_time_zone_by_country_and_region</function> の例</title>
<para>
<simpara>
これは、国 JP (日本)、地域 01 に対応するタイムゾーンを表示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: mumumu Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: mumumu Status: ready -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="geoip.configuration">
&reftitle.runtime;
&extension.runtime;
@@ -35,10 +35,10 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
デフォルトは空ですが、
ライブラリ中にコンパイルされているパスとは異なるパスに強制的に変更可能です。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

View File

@@ -1,42 +1,40 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: takagi Status: ready -->
<chapter xml:id="geoip.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: takagi Status: ready -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="geoip.setup">
&reftitle.setup;
<section xml:id="geoip.requirements">
&reftitle.required;
<para>
<simpara>
この拡張モジュールを使用するには、GeoIP C ライブラリのバージョン
1.4.0 以降がインストールされていなければなりません。最新のバージョンは
<link xlink:href="&url.maxmind.geoip;">&url.maxmind.geoip;</link>
<link xlink:href="&url.maxmind.geoip;">&url.maxmind.geoip;</link>
から取得できるので、これをコンパイルします。
</para>
<para>
</simpara>
<simpara>
デフォルトでは、Free GeoIP Country データベースあるいは
GeoLite City データベースにしかアクセスできません。
しかし、それ以外のデータベースを使用することも可能です。その場合には
<link xlink:href="&url.maxmind;">Maxmind</link>
から商用ライセンスを購入しなければなりません。
</para>
</simpara>
</section>
<section xml:id="geoip.installation">
&reftitle.install;
<para>
<simpara>
&pecl.moved;
</para>
<para>
</simpara>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;geoip">&url.pecl.package;geoip</link>.
</para>
</simpara>
</section>
&reference.geoip.ini;
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -57,4 +55,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->