1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-23 23:12:09 +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:06 +00:00
parent 1b6a3f3256
commit 628334f8a6
23 changed files with 252 additions and 256 deletions

View File

@@ -1,23 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.geoip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.geoip">
<?phpdoc extension-membership="pecl" ?>
<title>Localización geográfica de las IPs</title>
<titleabbrev>GeoIP</titleabbrev>
<preface xml:id="intro.geoip">
&reftitle.intro;
<para>
<simpara>
La extensión GeoIP permite localizar una dirección IP. La ciudad, el estado, el país,
la longitud, la latitud y otra información como el ISP y el tipo de conexión
pueden ser obtenidos gracias a GeoIP.
</para>
</simpara>
<warning>
<para>
<simpara>
Esta extensión no soporta las bases de datos "GeoIP2"
actuales de MaxMind, únicamente los ficheros de base de datos "GeoIP Legacy".
</para>
</simpara>
</warning>
</preface>

View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="geoip.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.constants;
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="geoip.constants"> &reftitle.constants;
&extension.constants;
<variablelist>
<varlistentry xml:id="constant.geoip-country-edition">
@@ -128,9 +127,9 @@
</listitem>
</varlistentry>
</variablelist>
<para>
<simpara>
Las constantes siguientes se utilizan para la velocidad de red:
</para>
</simpara>
<variablelist>
<varlistentry xml:id="constant.geoip-unknown-speed">
<term>
@@ -138,7 +137,7 @@
(<type>int</type>)
</term>
<listitem>
<simpara></simpara>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.geoip-dialup-speed">
@@ -147,7 +146,7 @@
(<type>int</type>)
</term>
<listitem>
<simpara></simpara>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.geoip-cabledsl-speed">
@@ -156,7 +155,7 @@
(<type>int</type>)
</term>
<listitem>
<simpara></simpara>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.geoip-corporate-speed">
@@ -165,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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-asnum-by-name">
<refnamediv>
@@ -14,10 +14,10 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_asnum_by_name</function> recupera el ASN
(Autonomous System Numbers) asociado con la dirección IP.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,28 +26,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre de host o la dirección IP.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el ASN en caso de éxito, o &false; si la dirección no puede
ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_asnum_by_name</function></title>
<para>
<simpara>
Este ejemplo mostrará el ASN para el host www.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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-continent-code-by-name">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_continent_code_by_name</function> devuelve el código de dos letras del continente correspondiente a un nombre de host o una dirección IP.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,19 +25,19 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre de host o la dirección IP que se está estudiando.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el código de dos letras del nombre del continente, en caso de éxito,
y &false; si la dirección no ha podido ser encontrada en la base.
</para>
</simpara>
<table>
<title>Códigos de continente</title>
<tgroup cols="2">
@@ -85,9 +85,9 @@
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_continent_code_by_name</function></title>
<para>
<simpara>
Este script mostrará el continente del host 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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.geoip-country-code-by-name">
<refnamediv>
@@ -14,11 +14,11 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_country_code_by_name</function>
devuelve las dos letras del código del país correspondiente al nombre del host o
a la dirección IP.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,28 +27,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre del host o la dirección IP
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve las dos letras del código del país ISO en caso de éxito, o
&false; si la dirección no pudo ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_country_code_by_name</function></title>
<para>
<simpara>
Este ejemplo muestra la localización del host example.com.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -71,12 +71,12 @@ Localización de este host: US
<refsect1 role="notes">
&reftitle.notes;
<caution>
<para>
<simpara>
Consulte la página
<link xlink:href="&url.maxmind.iso3166;">&url.maxmind.iso3166;</link>
para una lista completa de los valores devueltos posibles, incluyendo
los códigos especiales.
</para>
</simpara>
</caution>
</refsect1>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-country-code3-by-name">
<refnamediv>
@@ -14,11 +14,11 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_country_code3_by_name</function>
devuelve las tres letras del código del país correspondiente al nombre del host o
a la dirección IP.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,28 +27,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre del host o la dirección IP
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve las tres letras del código del país en caso de éxito, o &false;
si la dirección no pudo ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_country_code3_by_name</function></title>
<para>
<simpara>
Este ejemplo muestra dónde está localizado el host 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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-country-name-by-name">
<refnamediv>
@@ -14,11 +14,11 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_country_name_by_name</function> devuelve
el nombre completo del país correspondiente al nombre del host o a la
dirección IP.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,28 +27,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre del host o la dirección IP
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el nombre del país en caso de éxito, o &false; si la dirección
no pudo ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_country_name_by_name</function></title>
<para>
<simpara>
Este ejemplo muestra la localización del host 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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-database-info">
<refnamediv>
@@ -14,15 +14,15 @@
<methodparam choice="opt"><type>int</type><parameter>database</parameter><initializer>GEOIP_COUNTRY_EDITION</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_database_info</function> devuelve
la versión de la base de datos GeoIP tal como se define en el fichero binario.
</para>
</simpara>
<para>
<simpara>
Si esta función se llama sin argumento, devuelve la versión
de la <literal>GeoIP Free Country Edition</literal>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,11 +31,11 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
El tipo de base de datos, como entero. Se pueden utilizar
<link linkend="geoip.constants">diversas constantes</link> definidas
con esta extensión (ie: GEOIP_*_EDITION).
</para>
</simpara>
</listitem>
</varlistentry>
@@ -43,19 +43,19 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve la versión correspondiente de la base de datos, o &null;
si ocurre un error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_database_info</function></title>
<para>
<simpara>
Este ejemplo muestra la información contenida en la base de datos.
</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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-db-avail">
<refnamediv>
@@ -14,15 +14,15 @@
<methodparam><type>int</type><parameter>database</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_db_avail</function> verifica si la base
de datos correspondiente está disponible y puede ser abierta en el disco.
</para>
</simpara>
<para>
<simpara>
La función no indica si el fichero es una base de datos válida,
sino únicamente si es legible.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,11 +31,11 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
El tipo de base de datos, en forma de un &integer;.
Se pueden utilizar diversas <link linkend="geoip.constants">constantes</link>,
definidas con esta extensión (ie: GEOIP_*_EDITION).
</para>
</simpara>
</listitem>
</varlistentry>
@@ -43,19 +43,19 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si la base de datos existe, &false; si no se encuentra,
o &null; si ocurre un error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_db_avail</function></title>
<para>
<simpara>
Esto mostrará la versión de la base de datos actual.
</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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-db-filename">
<refnamediv>
@@ -14,15 +14,15 @@
<methodparam><type>int</type><parameter>database</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_db_filename</function> devuelve el nombre
del fichero que contiene la base de datos GeoIP especificada.
</para>
</simpara>
<para>
<simpara>
La función no indica si el fichero existe o no en el disco, sino únicamente
el lugar en el que la biblioteca busca la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,11 +31,11 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
El tipo de base de datos, en forma de un &integer;. Se pueden
utilizar diversas <link linkend="geoip.constants">constantes</link>,
definidas con esta extensión (ie: GEOIP_*_EDITION).
</para>
</simpara>
</listitem>
</varlistentry>
@@ -43,19 +43,19 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el nombre del fichero de la base de datos correspondiente, o
&null; si ocurre un error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_db_filename</function></title>
<para>
<simpara>
Esto mostrará el nombre del fichero correspondiente a la base de datos.
</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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-db-get-all-info">
<refnamediv>
@@ -14,18 +14,18 @@
<void/>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_db_get_all_info</function> devuelve información
detallada, en forma de un array multidimensional, sobre
todos los tipos de bases de datos GeoIP.
</para>
<para>
</simpara>
<simpara>
Esta función está disponible incluso si no se ha instalado ninguna base de datos.
Simplemente listará las bases de datos como no disponibles.
</para>
<para>
</simpara>
<simpara>
Los nombres de las diferentes claves del array asociativo devuelto son los siguientes:
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -55,18 +55,18 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un array asociativo.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_db_get_all_info</function></title>
<para>
<simpara>
Esto mostrará un array que contiene toda la información.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -109,10 +109,10 @@ array(11) {
<example>
<title>Ejemplo con <function>geoip_db_get_all_info</function></title>
<para>
<simpara>
Se pueden utilizar diversas constantes como claves para recuperar solo
partes de la información.
</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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-domain-by-name">
<refnamediv>
@@ -14,15 +14,15 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_domain_by_name</function> devuelve el
segundo nivel del dominio asociado con un nombre de host o la dirección IP.
</para>
<para>
</simpara>
<simpara>
Esta función está actualmente disponible solo para los usuarios que
han comprado una edición comercial de GeoIP Domain. Se emitirá una alerta
si no se puede encontrar la base de datos correcta.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,28 +31,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre de host o la dirección IP.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el nombre de dominio en caso de éxito, o &false; si la dirección
no puede ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_domain_by_name</function></title>
<para>
<simpara>
Este ejemplo mostrará el dominio asociado con la 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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-id-by-name">
<refnamediv>
@@ -14,15 +14,15 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_id_by_name</function>
devuelve el tipo de conexión a Internet correspondiente al nombre del host o
a la dirección IP.
</para>
<para>
</simpara>
<simpara>
El valor devuelto es de tipo numérico y puede ser comparado con
las siguientes constantes:
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -53,27 +53,27 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre del host o la dirección IP cuyo tipo de conexión debe ser examinado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el tipo de conexión.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_id_by_name</function></title>
<para>
<simpara>
Este ejemplo muestra el tipo de conexión del host 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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-isp-by-name">
<refnamediv>
@@ -14,15 +14,15 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_isp_by_name</function> devuelve el nombre
del ISP al que está asignada la IP.
</para>
<para>
</simpara>
<simpara>
Esta función está actualmente disponible solo para los usuarios que han
adquirido una edición comercial de GeoIP ISP. Se emitirá una advertencia
si la base de datos no puede ser localizada.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,28 +31,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre del host o la dirección IP.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el nombre del ISP en caso de éxito, o &false; si la dirección
no puede ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_isp_by_name</function></title>
<para>
<simpara>
Esto mostrará el nombre del ISP para el host 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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-netspeedcell-by-name">
<refnamediv>
@@ -14,23 +14,23 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_netspeedcell_by_name</function> devolverá
el tipo de conexión a Internet así como su velocidad, según un
nombre de host o una dirección IP.
</para>
<para>
</simpara>
<simpara>
Esta función solo está disponible al utilizar la versión
1.4.8 de la biblioteca GeoIP, o superiores.
</para>
<para>
</simpara>
<simpara>
Esta función está actualmente disponible únicamente para los usuarios
que han comprado una edición comercial de GeoIP NetSpeedCell. Se emitirá una alerta
si no se puede encontrar la base de datos correcta.
</para>
<para>
</simpara>
<simpara>
El valor devuelto será un string cuyos valores comunes son:
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -61,28 +61,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre de host, o la dirección IP.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve la velocidad de la conexión en caso de éxito, o &false; si
la dirección no puede ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_netspeedcell_by_name</function></title>
<para>
<simpara>
Este ejemplo mostrará la velocidad de la conexión del host 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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-org-by-name">
<refnamediv>
@@ -14,16 +14,16 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_org_by_name</function> devuelve
el nombre de la organización a la que se asigna la dirección IP.
</para>
<para>
</simpara>
<simpara>
Esta función está actualmente disponible únicamente para los usuarios
que han adquirido una licencia comercial <literal>GeoIP Organization</literal>,
<literal>ISP</literal> o <literal>AS Edition</literal>.
Se emitirá una alerta si la base de datos no puede ser encontrada.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -31,28 +31,28 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre del host o la dirección IP
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el nombre de la organización en caso de éxito, o &false;
si la dirección no pudo ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_org_by_name</function></title>
<para>
<simpara>
Este ejemplo muestra el nombre de la organización para el host example.com.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 66458042beed566a850f91dde06a6b8311233ade Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-record-by-name">
<refnamediv>
@@ -13,19 +13,19 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_record_by_name</function> devuelve
la información registrada correspondiente al nombre del host o
a la dirección IP.
</para>
<para>
</simpara>
<simpara>
Esta función está disponible para las bases de datos <literal>GeoLite City Edition</literal> y
la versión comercial <literal>GeoIP City Edition</literal>.
Se emitirá una alerta si la base de datos no ha podido ser encontrada.
</para>
<para>
</simpara>
<simpara>
Los nombres de las diferentes claves del array asociativo devuelto son los siguientes:
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -96,9 +96,9 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre del host o la dirección IP
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -106,10 +106,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un array asociativo en caso de éxito, o &false; si la dirección
no ha podido ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -144,10 +144,10 @@
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_record_by_name</function></title>
<para>
<simpara>
Este ejemplo muestra el array que contiene el registro del host
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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-region-by-name">
<refnamediv>
@@ -14,18 +14,18 @@
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_region_by_name</function> devuelve
el país y la región correspondientes al nombre del host o a la dirección IP.
</para>
<para>
</simpara>
<simpara>
Esta función está actualmente disponible únicamente para los usuarios
que han adquirido una licencia comercial <literal>GeoIP Region Edition</literal>. Se emitirá una alerta
si la base de datos no ha podido ser encontrada.
</para>
<para>
</simpara>
<simpara>
Los nombres de las diferentes claves del array devuelto son los siguientes:
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -46,29 +46,29 @@
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
El nombre del host o la dirección IP
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un array asociativo en caso de éxito, o &false; si la dirección
no ha podido ser encontrada en la base de datos.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>geoip_region_by_name</function></title>
<para>
<simpara>
Este ejemplo muestra el array que contiene el código del país y la región
del host 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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.geoip-region-name-by-code">
<refnamediv>
@@ -15,23 +15,23 @@
<methodparam><type>string</type><parameter>region_code</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_region_name_by_code</function> devuelve el nombre de la región correspondiente
a un par país y región.
</para>
<para>
</simpara>
<simpara>
En los Estados Unidos de América, la región corresponde a la abreviatura de dos letras
del estado. En Canadá, esta región corresponde a la abreviatura de la provincia o del
territorio, tal como lo asigna Correos de Canadá.
</para>
<para>
</simpara>
<simpara>
Para el resto del mundo, GeoIP utiliza los códigos FIPS 10-4 para representar las regiones.
Se puede verificar el sitio <link xlink:href="&url.maxmind.fips;">&url.maxmind.fips;</link>
para obtener una lista detallada de los códigos FIPS 10-4.
</para>
<para>
</simpara>
<simpara>
Esta función está siempre disponible si se utiliza la versión 1.4.1 o superior de la biblioteca GeoIP. Los datos se obtienen directamente de la biblioteca GeoIP y no de una tabla de referencia.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -39,29 +39,29 @@
<varlistentry>
<term><parameter>country_code</parameter></term>
<listitem>
<para>
<simpara>
El código del país, en dos letras (véase
<function>geoip_country_code_by_name</function>)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>region_code</parameter></term>
<listitem>
<para>
<simpara>
El código de la región en dos letras (véase
<function>geoip_region_by_name</function>)
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el nombre de la región en caso de éxito, o &false; si el país, la región o la combinación
de ambos no se encuentra.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -69,9 +69,9 @@
<para>
<example>
<title>Ejemplo con <function>geoip_region_name_by_code</function> para EE.UU. y Canadá</title>
<para>
<simpara>
Este script mostrará el nombre de la región para la región QC en CA.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -91,9 +91,9 @@ Nombre de la región CA/QC: Quebec
</example>
<example>
<title>Ejemplo con <function>geoip_region_name_by_code</function> utilizando los códigos FIPS</title>
<para>
<simpara>
Este script mostrará el nombre de la región para la región 01 en JP (Japón).
</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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.geoip-setup-custom-directory">
<refnamediv>
@@ -14,12 +14,12 @@
<methodparam><type>string</type><parameter>path</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La función <function>geoip_setup_custom_directory</function>
modificará el directorio por omisión de la base de datos GeoIP.
Esto es equivalente a modificar la opción de configuración
<link linkend="ini.geoip.custom-directory">geoip.custom_directory</link>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,27 +28,27 @@
<varlistentry>
<term><parameter>path</parameter></term>
<listitem>
<para>
<simpara>
La ruta de acceso completa donde se encuentra la base de datos GeoIP en el disco.
</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>Ejemplo con <function>geoip_setup_custom_directory</function></title>
<para>
<simpara>
Este ejemplo modificará la ruta de acceso por omisión hacia la base de datos 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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<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>
@@ -15,25 +15,25 @@
<methodparam choice="opt"><type>string</type><parameter>region_code</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>geoip_time_zone_by_country_and_region</function> devuelve la zona horaria
correspondiente a un país y una región.
</para>
<para>
</simpara>
<simpara>
En los Estados Unidos de América, la región corresponde a la abreviatura de dos letras
del estado. En Canadá, esta región corresponde a la abreviatura de la provincia o del
territorio, tal como lo asigna Correos de Canadá.
</para>
<para>
</simpara>
<simpara>
Para el resto del mundo, GeoIP utiliza los códigos FIPS 10-4 para representar las regiones.
Se puede verificar el sitio <link xlink:href="&url.maxmind.fips;">&url.maxmind.fips;</link>
para una lista detallada de los códigos FIPS 10-4.
</para>
<para>
</simpara>
<simpara>
Esta función está siempre disponible si se utiliza GeoIP Library
versión 1.4.1 o más reciente. Los datos provienen directamente de GeoIP
Library y no de una tabla de referencia.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -41,29 +41,29 @@
<varlistentry>
<term><parameter>country_code</parameter></term>
<listitem>
<para>
<simpara>
El código del país, en dos letras (véase
<function>geoip_country_code_by_name</function>)
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>region_code</parameter></term>
<listitem>
<para>
<simpara>
El código de región en dos letras (véase
<function>geoip_region_by_name</function>)
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve la zona horaria en caso de éxito, y &false; si el país,
la región o la combinación de ambos no se encuentra.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -71,9 +71,9 @@
<para>
<example>
<title>Ejemplo con <function>geoip_time_zone_by_country_and_region</function> para EE.UU. y Canadá</title>
<para>
<simpara>
Este script mostrará la zona horaria de Quebec, Canadá.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -93,9 +93,9 @@ Zona horaria de CA/QC : America/Montreal
</example>
<example>
<title>Ejemplo con <function>geoip_time_zone_by_country_and_region</function> y los códigos FIPS</title>
<para>
<simpara>
Este script mostrará la zona horaria de Japón, región 01 (Aichi).
</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: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="geoip.configuration">
&reftitle.runtime;
@@ -36,10 +36,10 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Vacío por omisión, pero puede ser utilizado para cargar una base
de datos diferente de la incluida en la biblioteca.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

View File

@@ -1,43 +1,41 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9d2fd3237ae1fa758ffc9beb1039110525802d1d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="geoip.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<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>
Esta extensión requiere la biblioteca GeoIP versión 1.4.0 o posterior.
La última versión puede ser obtenida en
<link xlink:href="&url.maxmind.geoip;">&url.maxmind.geoip;</link>
y compilada por usted mismo.
</para>
<para>
</simpara>
<simpara>
Por omisión, solo se puede acceder a la base de datos
<literal>Free GeoIP Country</literal> o <literal>GeoLite
City</literal>. Aunque este módulo puede funcionar con otros tipos
de bases de datos, es necesario adquirir una licencia comercial en
<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