|
|
|
|
@@ -1,6 +1,6 @@
|
|
|
|
|
<?xml version="1.0" encoding="utf-8"?>
|
|
|
|
|
<!-- EN-Revision: cb6d65ebe2412bbaef6d1edd076911539f1aceda Maintainer: PhilDaiguille Status: ready -->
|
|
|
|
|
<!-- Reviewed: yes -->
|
|
|
|
|
<!-- EN-Revision: d1fa3096926b6cbaf9da1f831b6fe3302ae2e490 Maintainer: PhilDaiguille Status: ready -->
|
|
|
|
|
<!-- Reviewed: no -->
|
|
|
|
|
<chapter xml:id="install.pecl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
|
|
|
<title>Instalación de extensiones PECL</title>
|
|
|
|
|
|
|
|
|
|
@@ -8,56 +8,63 @@
|
|
|
|
|
<title>Introducción a las instalaciones PECL</title>
|
|
|
|
|
&pecl.moving.to.pie;
|
|
|
|
|
<simpara>
|
|
|
|
|
&link.pecl; es un depósito de extensiones PHP
|
|
|
|
|
que están disponibles a través del sistema de paquetes
|
|
|
|
|
<link xlink:href="&url.php.pear;">PEAR</link>. Esta sección del manual tiene como objetivo presentar
|
|
|
|
|
la manera de obtener e instalar las extensiones de PECL.
|
|
|
|
|
&link.pecl; es un repositorio de extensiones PHP que están disponibles a través del
|
|
|
|
|
sistema de empaquetado <link xlink:href="&url.php.pear;">PEAR</link>.
|
|
|
|
|
Esta sección del manual está destinada a demostrar cómo obtener e
|
|
|
|
|
instalar extensiones PECL.
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
Estas instrucciones suponen que <literal>/path/to/php/src/dir/</literal> es la
|
|
|
|
|
ruta hasta las fuentes de la distribución PHP, y <literal>extname</literal> es el nombre
|
|
|
|
|
de la extensión PECL. Ajuste las siguientes instrucciones en consecuencia.
|
|
|
|
|
Estas instrucciones también suponen una familiaridad con el uso de
|
|
|
|
|
los <link xlink:href="&url.php.pear.cli;">comandos pear</link>.
|
|
|
|
|
La información en el manual PEAR para el comando <command>pear</command>
|
|
|
|
|
también es aplicable al comando <command>pecl</command>.
|
|
|
|
|
Estas instrucciones asumen que <literal>/path/to/php/src/dir/</literal> es la
|
|
|
|
|
ruta a la distribución de código fuente de PHP y que <literal>extname</literal> es
|
|
|
|
|
el nombre de la extensión PECL. Ajuste según corresponda.
|
|
|
|
|
Estas instrucciones también asumen familiaridad con el
|
|
|
|
|
<link xlink:href="&url.php.pear.cli;">comando pear</link>.
|
|
|
|
|
La información en el manual PEAR para el
|
|
|
|
|
comando <command>pear</command>
|
|
|
|
|
también se aplica al
|
|
|
|
|
comando <command>pecl</command>.
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
Una extensión compartida debe ser compilada, instalada y cargada para ser
|
|
|
|
|
utilizada. Los métodos descritos a continuación proporcionan diversas
|
|
|
|
|
instrucciones sobre cómo compilar e instalar extensiones, pero no las cargan automáticamente. Las extensiones pueden ser cargadas
|
|
|
|
|
agregando una directiva de <link linkend="ini.extension">extensión</link>
|
|
|
|
|
al fichero &php.ini; o utilizando la función <function>dl</function>.
|
|
|
|
|
Una extensión compartida debe ser construida, instalada y cargada para ser útil.
|
|
|
|
|
Los métodos descritos a continuación proporcionan varias instrucciones sobre cómo construir e
|
|
|
|
|
instalar las extensiones, pero no las cargan automáticamente.
|
|
|
|
|
Las extensiones pueden ser cargadas añadiendo una
|
|
|
|
|
directiva <link linkend="ini.extension">extension</link>
|
|
|
|
|
al archivo &php.ini; o a través del uso de la
|
|
|
|
|
función <function>dl</function>.
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
Al compilar módulos PHP, es importante tener las herramientas en sus versiones apropiadas, tales como autoconf, automake, libtool, etc. Consulte las
|
|
|
|
|
<link xlink:href="&url.php.anongit;">Instrucciones para el Git anónimo</link>, para
|
|
|
|
|
conocer las utilidades necesarias y sus versiones.
|
|
|
|
|
Al construir módulos PHP, es importante tener versiones conocidas y buenas de las
|
|
|
|
|
herramientas requeridas (autoconf, automake, libtool, etc.).
|
|
|
|
|
Consulte las
|
|
|
|
|
<link xlink:href="&url.php.anongit;">Instrucciones de Git Anónimo</link>
|
|
|
|
|
para detalles sobre las herramientas requeridas y las versiones necesarias.
|
|
|
|
|
</simpara>
|
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
|
<sect1 xml:id="install.pecl.downloads">
|
|
|
|
|
<title>Descargar extensiones PECL</title>
|
|
|
|
|
<title>Descarga de extensiones PECL</title>
|
|
|
|
|
&pecl.moving.to.pie;
|
|
|
|
|
<simpara>
|
|
|
|
|
Existen varias maneras de descargar extensiones PECL:
|
|
|
|
|
Hay varias opciones para descargar extensiones PECL, tales como:
|
|
|
|
|
</simpara>
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<simpara>
|
|
|
|
|
El comando <command>pecl install extname</command> descarga el código
|
|
|
|
|
de las extensiones automáticamente, lo que evita realizar
|
|
|
|
|
una descarga particular.
|
|
|
|
|
</simpara>
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
El comando <command>pecl install extname</command> descarga el
|
|
|
|
|
código de la extensión automáticamente, por lo que en este caso no es necesaria una
|
|
|
|
|
descarga separada.
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
<link xlink:href="&url.pecl;">&url.pecl;</link>
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
El sitio web de PECL contiene diversa información sobre las diferentes extensiones
|
|
|
|
|
ofrecidas por el equipo de desarrollo de PHP.
|
|
|
|
|
Varias informaciones están disponibles, incluyendo los cambios
|
|
|
|
|
entre las versiones, las notas de versiones, lo que es requerido para hacer funcionar la extensión
|
|
|
|
|
así como otros detalles similares.
|
|
|
|
|
El sitio web de PECL contiene información sobre las diferentes extensiones que
|
|
|
|
|
son ofrecidas por el Equipo de Desarrollo de PHP.
|
|
|
|
|
La información disponible aquí incluye: registro de cambios, notas de lanzamiento,
|
|
|
|
|
requisitos y otros detalles similares.
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
@@ -65,10 +72,10 @@
|
|
|
|
|
<command>pecl download extname</command>
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
Las extensiones PECL listadas en el sitio web de PECL están disponibles
|
|
|
|
|
y pueden ser descargadas e instaladas utilizando la
|
|
|
|
|
Las extensiones PECL que tienen lanzamientos listados en el sitio web de PECL están disponibles
|
|
|
|
|
para descarga e instalación usando el
|
|
|
|
|
<link xlink:href="&url.php.pear.cli;">comando pecl</link>.
|
|
|
|
|
La versión específica de la extensión también puede ser especificada.
|
|
|
|
|
También se pueden especificar revisiones específicas.
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
@@ -76,7 +83,7 @@
|
|
|
|
|
<acronym>git</acronym>
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
Muchas extensiones PECL permanecen en GitHub.
|
|
|
|
|
Muchas extensiones PECL residen en GitHub.
|
|
|
|
|
<!-- TODO Expand -->
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
@@ -85,10 +92,11 @@
|
|
|
|
|
<acronym>SVN</acronym>
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
Algunas extensiones PECL permanecen en <acronym>SVN</acronym>.
|
|
|
|
|
Una interfaz web está disponible en <link xlink:href="&url.php.svn;pecl/">&url.php.svn;pecl/</link>.
|
|
|
|
|
Para descargar directamente desde <acronym>SVN</acronym>, la siguiente secuencia de instrucciones
|
|
|
|
|
puede ser utilizada:
|
|
|
|
|
Algunas extensiones PECL también residen en <acronym>SVN</acronym>.
|
|
|
|
|
Una vista basada en web puede verse en
|
|
|
|
|
<link xlink:href="&url.php.svn;pecl/">&url.php.svn;pecl/</link>.
|
|
|
|
|
Para descargar directamente desde <acronym>SVN</acronym>,
|
|
|
|
|
la siguiente secuencia de comandos puede ser usada:
|
|
|
|
|
</simpara>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
@@ -98,87 +106,88 @@ $ svn checkout https://svn.php.net/repository/pecl/extname/trunk extname
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
Descargas para Windows:
|
|
|
|
|
Descargas para Windows
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
El proyecto PHP compila y ofrece DLLs de Windows para la mayoría de las
|
|
|
|
|
extensiones PECL disponibles en la página del paquete.
|
|
|
|
|
El proyecto PHP compila y ofrece DLLs de Windows para la mayoría de las extensiones PECL
|
|
|
|
|
en la página del paquete.
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
|
<sect1 xml:id="install.pecl.windows">
|
|
|
|
|
<title>Instalar una extensión PHP en Windows</title>
|
|
|
|
|
<title>Instalación de una extensión PHP en Windows</title>
|
|
|
|
|
<para>
|
|
|
|
|
Existen dos maneras de cargar una extensión PHP en Windows:
|
|
|
|
|
o bien compilarla en PHP, o bien cargar una DLL. Cargar una
|
|
|
|
|
extensión precompilada es el método más práctico y recomendado.
|
|
|
|
|
Hay dos formas de cargar una extensión PHP en Windows: compilarla en
|
|
|
|
|
PHP o cargar la DLL.
|
|
|
|
|
Cargar una extensión precompilada es la forma más fácil y preferida.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Para cargar una extensión, su fichero <filename>.dll</filename> debe estar disponible en el sistema.
|
|
|
|
|
Todas las extensiones son automáticamente y periódicamente compiladas por el grupo PHP
|
|
|
|
|
(ver la sección de descargas).
|
|
|
|
|
Para cargar una extensión, debe estar disponible como un
|
|
|
|
|
archivo <filename>.dll</filename>
|
|
|
|
|
en el sistema.
|
|
|
|
|
Todas las extensiones son compiladas automáticamente y periódicamente por el Grupo PHP
|
|
|
|
|
(ver la siguiente sección para la descarga).
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Para compilar una extensión en PHP, consulte la
|
|
|
|
|
documentación sobre <link linkend="install.windows.building">
|
|
|
|
|
la compilación de las fuentes</link>.
|
|
|
|
|
documentación <link linkend="install.windows.building">compilación desde el código fuente</link>.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Para compilar una extensión autónoma, (es decir, un fichero DLL), consulte la
|
|
|
|
|
documentación sobre <link linkend="install.windows.building">
|
|
|
|
|
la compilación de las fuentes</link>. Si el fichero DLL no está presente en la distribución
|
|
|
|
|
PHP y PECL, puede ser necesario compilarlo antes de poder utilizarlo.
|
|
|
|
|
Para compilar una extensión independiente (también conocida como un archivo DLL), consulte la
|
|
|
|
|
documentación <link linkend="install.windows.building">compilación desde el código fuente</link>.
|
|
|
|
|
Si el archivo DLL no está disponible ni con la distribución de PHP ni en PECL,
|
|
|
|
|
puede ser necesario compilarlo antes de que la extensión pueda ser usada.
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<sect2 xml:id="install.pecl.windows.find">
|
|
|
|
|
<title>¿Dónde encontrar una extensión?</title>
|
|
|
|
|
&pecl.moving.to.pie;
|
|
|
|
|
<para>
|
|
|
|
|
Las extensiones PHP generalmente se llaman <filename>php_*.dll</filename> (donde los asteriscos
|
|
|
|
|
representan el nombre de la extensión) y se encuentran en la carpeta
|
|
|
|
|
<filename>PHP\ext</filename>.
|
|
|
|
|
Las extensiones PHP suelen llamarse <filename>php_*.dll</filename> (donde el
|
|
|
|
|
asterisco representa el nombre de la extensión), y están ubicadas en la
|
|
|
|
|
carpeta <filename>PHP\ext</filename>.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
PHP se entrega con las extensiones que son más útiles para la mayoría de los usuarios.
|
|
|
|
|
Se llaman extensiones <emphasis>integradas</emphasis>, o <emphasis>bundled</emphasis>.
|
|
|
|
|
PHP se distribuye con las extensiones más útiles para la mayoría de los desarrolladores.
|
|
|
|
|
Se llaman extensiones <emphasis>incluidas</emphasis>.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Sin embargo, si las extensiones integradas no proporcionan la funcionalidad necesaria,
|
|
|
|
|
una extensión que lo haga puede encontrarse en &link.pecl;.
|
|
|
|
|
La Biblioteca de Extensiones Comunitarias de PHP (PECL, también llamada Biblioteca de Extensiones Comunitarias de PHP)
|
|
|
|
|
es un depósito para las extensiones PHP, proporcionando un directorio de todas las extensiones conocidas y
|
|
|
|
|
facilidades de alojamiento para la descarga y el desarrollo de extensiones PHP.
|
|
|
|
|
Sin embargo, si las extensiones incluidas no proporcionan la funcionalidad necesaria,
|
|
|
|
|
aún se puede encontrar una extensión que sí lo haga en &link.pecl;.
|
|
|
|
|
La Biblioteca Comunitaria de Extensiones PHP (PECL) es un repositorio para
|
|
|
|
|
Extensiones PHP, proporcionando un directorio de todas las extensiones conocidas y alojando
|
|
|
|
|
facilidades para descargar y desarrollar extensiones PHP.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Si una extensión ha sido desarrollada para un uso particular, puede ser alojada en PECL para que
|
|
|
|
|
otras personas con las mismas necesidades puedan beneficiarse de ella.
|
|
|
|
|
Un efecto secundario interesante es que es una buena oportunidad para recibir comentarios,
|
|
|
|
|
(con un poco de suerte) agradecimientos, informes de errores y, a veces, correcciones. Antes de
|
|
|
|
|
enviar una extensión para alojamiento en PECL, por favor lea
|
|
|
|
|
Si una extensión ha sido desarrollada para usos particulares, puede estar alojada en
|
|
|
|
|
PECL para que otros con las mismas necesidades puedan beneficiarse de ella.
|
|
|
|
|
Un buen efecto secundario es que es una buena oportunidad para recibir comentarios,
|
|
|
|
|
(con suerte) agradecimientos, informes de errores e incluso correcciones/parches.
|
|
|
|
|
Antes de enviar una extensión para alojamiento en PECL, por favor lea
|
|
|
|
|
<link xlink:href="&url.pecl.submit;">PECL submit</link>.
|
|
|
|
|
</para>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
<sect2 xml:id="install.pecl.windows.which">
|
|
|
|
|
<title>¿Qué extensiones descargar?</title>
|
|
|
|
|
<title>¿Qué extensión descargar?</title>
|
|
|
|
|
<para>
|
|
|
|
|
<emphasis>A menudo hay varias versiones de cada DLL:</emphasis>
|
|
|
|
|
<emphasis>
|
|
|
|
|
Muchas veces, habrá varias versiones de cada DLL disponibles:
|
|
|
|
|
</emphasis>
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
Diferentes números de versiones (al menos, los dos primeros dígitos deben ser los mismos)
|
|
|
|
|
Diferentes números de versión (al menos los dos primeros números deben coincidir)
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
Diferentes configuraciones de seguridad de hilos
|
|
|
|
|
Diferentes configuraciones de seguridad de subprocesos
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
<simpara>
|
|
|
|
|
Diferentes arquitecturas de procesadores (x86, x64...)
|
|
|
|
|
Diferente arquitectura de procesador (x86, x64, ...)
|
|
|
|
|
</simpara>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
|
@@ -194,13 +203,15 @@ $ svn checkout https://svn.php.net/repository/pecl/extname/trunk extname
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Se recomienda elegir las extensiones para que se adapten
|
|
|
|
|
a la máquina servidor en la que se utiliza PHP. El siguiente script
|
|
|
|
|
mostrará <emphasis>todas</emphasis> las configuraciones de PHP:
|
|
|
|
|
Tenga en cuenta que la configuración de la extensión debe coincidir con todas las configuraciones de
|
|
|
|
|
el ejecutable PHP que se está utilizando.
|
|
|
|
|
El siguiente script PHP dirá <emphasis>todo</emphasis> sobre la configuración de PHP:
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
<example>
|
|
|
|
|
<title>Llamada a la función <function>phpinfo</function></title>
|
|
|
|
|
<title>
|
|
|
|
|
Llamada a <function>phpinfo</function>
|
|
|
|
|
</title>
|
|
|
|
|
<programlisting role="php">
|
|
|
|
|
<![CDATA[
|
|
|
|
|
<?php
|
|
|
|
|
@@ -211,7 +222,7 @@ phpinfo();
|
|
|
|
|
</example>
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
O bien, en línea de comandos:
|
|
|
|
|
O desde la línea de comandos, ejecute:
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
drive:\path\to\php\executable\php.exe -i
|
|
|
|
|
@@ -221,54 +232,57 @@ drive:\path\to\php\executable\php.exe -i
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
<sect2 xml:id="install.pecl.windows.loading">
|
|
|
|
|
<title>Cargar una extensión</title>
|
|
|
|
|
<title>Carga de una extensión</title>
|
|
|
|
|
<para>
|
|
|
|
|
La manera más común de cargar una extensión PHP es incluirla en el
|
|
|
|
|
fichero de configuración &php.ini;. Se debe tener en cuenta que muchas extensiones
|
|
|
|
|
ya están presentes en el fichero &php.ini; y que simplemente se debe eliminar el punto y coma para activarlas.
|
|
|
|
|
La forma más común de cargar una extensión PHP es incluirla en
|
|
|
|
|
el archivo de configuración &php.ini;.
|
|
|
|
|
Tenga en cuenta que muchas extensiones ya están presentes en el &php.ini; y
|
|
|
|
|
que solo es necesario eliminar el punto y coma para activarlas.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
A partir de PHP 7.2.0, el nombre de la extensión puede ser utilizado en lugar
|
|
|
|
|
del nombre del fichero de la extensión. Como es independiente del sistema operativo y más fácil,
|
|
|
|
|
especialmente para los nuevos usuarios, se convierte en la manera recomendada
|
|
|
|
|
de especificar las extensiones a cargar. Los nombres de los ficheros siguen siendo soportados para la compatibilidad con las versiones anteriores.
|
|
|
|
|
Tenga en cuenta que, a partir de PHP 7.2.0, se puede usar el
|
|
|
|
|
nombre de la extensión en lugar del nombre del archivo de la extensión.
|
|
|
|
|
Como esto es independiente del sistema operativo y más fácil, especialmente para principiantes, se convierte
|
|
|
|
|
en la forma recomendada de especificar extensiones para cargar.
|
|
|
|
|
Los nombres de archivos siguen siendo compatibles con versiones anteriores.
|
|
|
|
|
</para>
|
|
|
|
|
<screen>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
;extension=php_extname.dll
|
|
|
|
|
]]>
|
|
|
|
|
</screen>
|
|
|
|
|
<screen>
|
|
|
|
|
</screen>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
extension=php_extname.dll
|
|
|
|
|
]]>
|
|
|
|
|
</screen>
|
|
|
|
|
<screen>
|
|
|
|
|
</screen>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
; A partir de PHP 7.2, favorizar:
|
|
|
|
|
; A partir de PHP 7.2.0, prefiera:
|
|
|
|
|
extension=extname
|
|
|
|
|
zend_extension=another_extension
|
|
|
|
|
]]>
|
|
|
|
|
</screen>
|
|
|
|
|
</screen>
|
|
|
|
|
<para>
|
|
|
|
|
Sin embargo, algunos servidores web son confusos, ya que no utilizan el fichero
|
|
|
|
|
&php.ini; almacenado con el ejecutable PHP. Para saber más sobre el verdadero
|
|
|
|
|
&php.ini; utilizado, es posible buscar su ubicación utilizando <function>phpinfo</function>:
|
|
|
|
|
Sin embargo, algunos servidores web son confusos porque no usan
|
|
|
|
|
el &php.ini; ubicado junto al ejecutable de PHP.
|
|
|
|
|
Para averiguar dónde reside el &php.ini; real, busque su ruta
|
|
|
|
|
en <function>phpinfo</function>:
|
|
|
|
|
</para>
|
|
|
|
|
<screen>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
Configuration File (php.ini) Path C:\WINDOWS
|
|
|
|
|
Configuration File (php.ini) Path C:\WINDOWS
|
|
|
|
|
]]>
|
|
|
|
|
</screen>
|
|
|
|
|
<screen>
|
|
|
|
|
</screen>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
Loaded Configuration File C:\Program Files\PHP\8.2\php.ini
|
|
|
|
|
]]>
|
|
|
|
|
</screen>
|
|
|
|
|
</screen>
|
|
|
|
|
<para>
|
|
|
|
|
Después de activar una extensión, guarde el fichero &php.ini;, y
|
|
|
|
|
reinicie el servidor web, luego verifique nuevamente el fichero <function>phpinfo</function>.
|
|
|
|
|
La nueva extensión debería tener su sección allí.
|
|
|
|
|
Después de activar una extensión, guarde &php.ini;, reinicie el servidor web y
|
|
|
|
|
verifique <function>phpinfo</function> nuevamente.
|
|
|
|
|
La nueva extensión debería tener ahora su propia sección.
|
|
|
|
|
</para>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
@@ -276,26 +290,28 @@ Loaded Configuration File C:\Program Files\PHP\8.2\php.ini
|
|
|
|
|
<title>Resolución de problemas</title>
|
|
|
|
|
<para>
|
|
|
|
|
Si la extensión no aparece en <function>phpinfo</function>,
|
|
|
|
|
es conveniente verificar los registros para saber de dónde viene el problema.
|
|
|
|
|
los registros deben ser verificados para saber de dónde viene el problema.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Si PHP se utiliza en línea de comandos (CLI), el error de carga de la extensión
|
|
|
|
|
debería ser legible directamente en la pantalla.
|
|
|
|
|
Si PHP se está utilizando desde la línea de comandos (CLI), el error de carga de la extensión
|
|
|
|
|
puede leerse directamente en la pantalla.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Si PHP se utiliza en un servidor web, la posición y el formato de los registros
|
|
|
|
|
varían considerablemente de un servidor a otro. Lea la documentación del
|
|
|
|
|
servidor web para saber dónde se encuentran: PHP no tiene control sobre esta ubicación.
|
|
|
|
|
Si PHP se está utilizando con un servidor web, la ubicación y el formato de los registros
|
|
|
|
|
varían dependiendo del software.
|
|
|
|
|
Por favor lea la documentación del servidor web para localizar los registros, ya que
|
|
|
|
|
no tiene nada que ver con PHP en sí.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Los problemas más comunes son la ubicación del fichero DLL y
|
|
|
|
|
las DLLs de las que depende, el valor de la directiva
|
|
|
|
|
"<link linkend="ini.extension-dir">extension_dir</link>"
|
|
|
|
|
en el &php.ini; y las inconsistencias de compilación.
|
|
|
|
|
Los problemas comunes son la ubicación de la DLL y las DLLs de las que depende, el
|
|
|
|
|
valor de la configuración "<link linkend="ini.extension-dir">extension_dir</link>"
|
|
|
|
|
dentro de &php.ini; y las discrepancias en la configuración de tiempo de compilación.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Si el problema es una inconsistencia de compilación, la DLL descargada probablemente no es
|
|
|
|
|
la correcta. Intente descargar una nueva, con las configuraciones correctas del servidor. <function>phpinfo</function> será muy útil.
|
|
|
|
|
Si el problema radica en una discrepancia en la configuración de tiempo de compilación, probablemente la DLL
|
|
|
|
|
descargada no es la correcta.
|
|
|
|
|
Intente descargar la extensión nuevamente con la configuración adecuada.
|
|
|
|
|
Nuevamente, <function>phpinfo</function> puede ser de gran ayuda.
|
|
|
|
|
</para>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
@@ -304,8 +320,10 @@ Loaded Configuration File C:\Program Files\PHP\8.2\php.ini
|
|
|
|
|
<sect1 xml:id="install.pecl.pear">
|
|
|
|
|
<title>Compilación de extensiones PECL compartidas con el comando pecl</title>
|
|
|
|
|
<simpara>
|
|
|
|
|
PECL facilita la creación de extensiones PHP compartidas. Utilizando la
|
|
|
|
|
<link xlink:href="&url.php.pear.cli;">comando pecl</link>, haga lo siguiente:
|
|
|
|
|
PECL facilita la creación de extensiones PHP compartidas.
|
|
|
|
|
Usando el
|
|
|
|
|
<link xlink:href="&url.php.pear.cli;">comando pecl</link>,
|
|
|
|
|
haga lo siguiente:
|
|
|
|
|
</simpara>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
@@ -313,16 +331,19 @@ $ pecl install extname
|
|
|
|
|
]]>
|
|
|
|
|
</screen>
|
|
|
|
|
<simpara>
|
|
|
|
|
Esto descargará el fichero fuente de la extensión <emphasis>extname</emphasis>,
|
|
|
|
|
lo compilará e instalará el fichero <filename>extname.so</filename> en el
|
|
|
|
|
directorio <link linkend="ini.extension-dir">extension_dir</link>.
|
|
|
|
|
<filename>extname.so</filename> debe luego ser cargado a través de &php.ini;.
|
|
|
|
|
Esto descargará el código fuente para <emphasis>extname</emphasis>,
|
|
|
|
|
compilará e instalará <filename>extname.so</filename> en el
|
|
|
|
|
<link linkend="ini.extension-dir">extension_dir</link>.
|
|
|
|
|
<filename>extname.so</filename>
|
|
|
|
|
puede entonces ser cargado a través de &php.ini;.
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
Por defecto, el comando <command>pecl</command> no instalará los paquetes
|
|
|
|
|
marcados como <literal>alpha</literal> o
|
|
|
|
|
<literal>beta</literal>. Si no hay ningún paquete <literal>stable</literal> disponible,
|
|
|
|
|
es posible instalar un paquete <literal>beta</literal> utilizando el siguiente comando:
|
|
|
|
|
Por defecto, el comando <command>pecl</command> no instalará paquetes
|
|
|
|
|
que estén marcados con el estado <literal>alpha</literal> o
|
|
|
|
|
<literal>beta</literal>.
|
|
|
|
|
Si no hay paquetes <literal>estable</literal> disponibles,
|
|
|
|
|
un paquete <literal>beta</literal> puede ser instalado usando el siguiente
|
|
|
|
|
comando:
|
|
|
|
|
</simpara>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
@@ -330,7 +351,7 @@ $ pecl install extname-beta
|
|
|
|
|
]]>
|
|
|
|
|
</screen>
|
|
|
|
|
<para>
|
|
|
|
|
También es posible instalar una versión específica utilizando el siguiente comando:
|
|
|
|
|
También se puede instalar una versión específica usando esta variante:
|
|
|
|
|
</para>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
@@ -339,26 +360,27 @@ $ pecl install extname-0.1
|
|
|
|
|
</screen>
|
|
|
|
|
<note>
|
|
|
|
|
<para>
|
|
|
|
|
Después de activar la extensión en el &php.ini;, es necesario reiniciar el servidor web
|
|
|
|
|
para que se tenga en cuenta.
|
|
|
|
|
Después de habilitar la extensión en &php.ini;, es necesario reiniciar el servicio web para que
|
|
|
|
|
los cambios sean aplicados.
|
|
|
|
|
</para>
|
|
|
|
|
</note>
|
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
|
<sect1 xml:id="install.pecl.phpize">
|
|
|
|
|
<title>Compilación de extensiones compartidas con phpize</title>
|
|
|
|
|
<title>Compilación de extensiones PECL compartidas con phpize</title>
|
|
|
|
|
<simpara>
|
|
|
|
|
A veces, el uso del instalador <command>pecl</command> no es una opción.
|
|
|
|
|
Esto puede deberse a la presencia de un cortafuegos o al hecho de que la extensión en curso
|
|
|
|
|
de instalación no está disponible como un paquete PECL compatible, como las
|
|
|
|
|
extensiones no publicadas provenientes de git. Si se debe construir una extensión de este tipo,
|
|
|
|
|
las herramientas de construcción de nivel inferior pueden ser utilizadas para realizar
|
|
|
|
|
la construcción manualmente.
|
|
|
|
|
A veces, usar el instalador <command>pecl</command> no es una opción.
|
|
|
|
|
Esto podría deberse a que hay un firewall o porque la extensión que se está
|
|
|
|
|
instalando no está disponible como un paquete compatible con PECL, como extensiones no lanzadas
|
|
|
|
|
desde git.
|
|
|
|
|
Si tal extensión necesita ser construida, se pueden usar las herramientas de construcción de bajo nivel para
|
|
|
|
|
realizar la construcción manualmente.
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
El comando <command>phpize</command> se utiliza para preparar
|
|
|
|
|
el entorno de compilación para una extensión PHP. En el siguiente ejemplo, las
|
|
|
|
|
fuentes de la extensión están en una carpeta llamada <filename>extname</filename>:
|
|
|
|
|
El comando <command>phpize</command> se usa para preparar el entorno de construcción
|
|
|
|
|
para una extensión PHP.
|
|
|
|
|
En el siguiente ejemplo, los fuentes para una extensión están en un directorio
|
|
|
|
|
llamado <filename>extname</filename>:
|
|
|
|
|
</simpara>
|
|
|
|
|
<para>
|
|
|
|
|
<screen>
|
|
|
|
|
@@ -372,20 +394,22 @@ $ make
|
|
|
|
|
</screen>
|
|
|
|
|
</para>
|
|
|
|
|
<simpara>
|
|
|
|
|
Una instalación exitosa creará un fichero <filename>extname.so</filename>
|
|
|
|
|
y lo colocará en el <link linkend="ini.extension-dir">directorio de extensiones</link>
|
|
|
|
|
de PHP. El &php.ini; deberá ser ajustado, y la línea <literal>extension=extname.so</literal>
|
|
|
|
|
agregada antes de poder utilizar la extensión.
|
|
|
|
|
Una instalación exitosa habrá creado <filename>extname.so</filename> y
|
|
|
|
|
lo habrá puesto en el directorio de extensiones PHP
|
|
|
|
|
<link linkend="ini.extension-dir">extensions directory</link>.
|
|
|
|
|
El archivo &php.ini; necesitará ser ajustado, y una
|
|
|
|
|
línea <literal>extension=extname.so</literal>
|
|
|
|
|
necesitará ser añadida antes de que la extensión pueda ser usada.
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
Si el sistema no posee el comando <command>phpize</command> y se utilizan paquetes precompilados (como RPM), es necesario asegurarse de instalar
|
|
|
|
|
también la versión de desarrollo apropiada de los paquetes PHP ya que
|
|
|
|
|
incluye también el comando <literal>phpize</literal> así como los encabezados
|
|
|
|
|
apropiados para construir PHP y sus extensiones.
|
|
|
|
|
Si el sistema carece del comando <command>phpize</command>, y
|
|
|
|
|
se usan paquetes precompilados (como RPMs), asegúrese de instalar también la
|
|
|
|
|
versión de desarrollo adecuada del paquete PHP ya que a menudo incluyen el
|
|
|
|
|
comando <command>phpize</command>
|
|
|
|
|
junto con los archivos de cabecera adecuados para construir PHP y sus extensiones.
|
|
|
|
|
</simpara>
|
|
|
|
|
<simpara>
|
|
|
|
|
Ejecute el comando <command>phpize --help</command> para mostrar información
|
|
|
|
|
de uso adicional.
|
|
|
|
|
Ejecute <command>phpize --help</command> para mostrar información adicional de uso.
|
|
|
|
|
</simpara>
|
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
|
@@ -395,21 +419,24 @@ $ make
|
|
|
|
|
</title>
|
|
|
|
|
|
|
|
|
|
<para>
|
|
|
|
|
<command>php-config</command> es un pequeño script shell para obtener información
|
|
|
|
|
sobre la configuración instalada de PHP.
|
|
|
|
|
<command>php-config</command>
|
|
|
|
|
es un simple script de shell para obtener información sobre la configuración instalada de PHP.
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>
|
|
|
|
|
Al compilar extensiones, si se instalan varias versiones de PHP,
|
|
|
|
|
la instalación para la cual se debe construir puede ser especificada utilizando la opción
|
|
|
|
|
<option role="configure">--with-php-config</option> durante la configuración, definiendo
|
|
|
|
|
la ruta del script <command>php-config</command> correspondiente.
|
|
|
|
|
Cuando las extensiones están siendo compiladas, si hay múltiples versiones de PHP instaladas, la instalación
|
|
|
|
|
para la cual construir puede ser especificada usando la opción
|
|
|
|
|
<option role="configure">--with-php-config</option>
|
|
|
|
|
durante la configuración, estableciendo la ruta del respectivo script
|
|
|
|
|
<command>php-config</command>.
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>
|
|
|
|
|
La lista de opciones de línea de comandos proporcionadas por el script
|
|
|
|
|
<command>php-config</command> puede ser obtenida ejecutando el script <command>php-config</command>
|
|
|
|
|
con la opción <option>-h</option>:
|
|
|
|
|
<command>php-config</command>
|
|
|
|
|
puede ser consultada en cualquier momento ejecutando
|
|
|
|
|
<command>php-config</command>
|
|
|
|
|
con el interruptor <option>-h</option>:
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
Usage: /usr/local/bin/php-config [OPTION]
|
|
|
|
|
@@ -442,41 +469,48 @@ Options:
|
|
|
|
|
<tbody>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--prefix</entry>
|
|
|
|
|
<entry>Prefijo del directorio donde PHP está instalado, i.e. /usr/local</entry>
|
|
|
|
|
<entry>Prefijo de directorio donde PHP está instalado, p. ej. /usr/local</entry>
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--includes</entry>
|
|
|
|
|
<entry>Lista de las opciones <literal>-I</literal> con todos los ficheros incluidos</entry>
|
|
|
|
|
<entry>
|
|
|
|
|
Lista de opciones <literal>-I</literal> con todos los archivos de inclusión
|
|
|
|
|
</entry>
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--ldflags</entry>
|
|
|
|
|
<entry>Banderas <literal>LD</literal> que han sido compiladas con PHP</entry>
|
|
|
|
|
<entry>
|
|
|
|
|
<literal>LD</literal>
|
|
|
|
|
flags con los que PHP fue compilado
|
|
|
|
|
</entry>
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--libs</entry>
|
|
|
|
|
<entry>Bibliotecas adicionales que han sido compiladas con PHP</entry>
|
|
|
|
|
<entry>Librerías adicionales con las que PHP fue compilado</entry>
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--extension-dir</entry>
|
|
|
|
|
<entry>Directorios donde las extensiones son buscadas por defecto</entry>
|
|
|
|
|
<entry>Directorio donde las extensiones son buscadas por defecto</entry>
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--include-dir</entry>
|
|
|
|
|
<entry>Prefijo del directorio donde los encabezados de ficheros son
|
|
|
|
|
instalados por defecto</entry>
|
|
|
|
|
<entry>
|
|
|
|
|
Prefijo de directorio donde los archivos de cabecera son instalados por defecto
|
|
|
|
|
</entry>
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--php-binary</entry>
|
|
|
|
|
<entry>Ruta completa hacia el CLI PHP o el binario CGI</entry>
|
|
|
|
|
<entry>Ruta completa al binario CLI o CGI de php</entry>
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--php-sapis</entry>
|
|
|
|
|
<entry>Muestra todos los módulos SAPI disponibles</entry>
|
|
|
|
|
<entry>Mostrar todos los módulos SAPI disponibles</entry>
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--configure-options</entry>
|
|
|
|
|
<entry>Opciones de configuración para recrear la configuración
|
|
|
|
|
de la instalación actual de PHP</entry>
|
|
|
|
|
<entry>
|
|
|
|
|
Opciones de configuración para recrear la configuración de la instalación actual de PHP
|
|
|
|
|
</entry>
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--version</entry>
|
|
|
|
|
@@ -484,7 +518,7 @@ Options:
|
|
|
|
|
</row>
|
|
|
|
|
<row>
|
|
|
|
|
<entry>--vernum</entry>
|
|
|
|
|
<entry>Versión de PHP en forma de entero</entry>
|
|
|
|
|
<entry>Versión de PHP como entero</entry>
|
|
|
|
|
</row>
|
|
|
|
|
</tbody>
|
|
|
|
|
</tgroup>
|
|
|
|
|
@@ -496,9 +530,9 @@ Options:
|
|
|
|
|
<title>Compilación de extensiones PECL estáticamente en PHP</title>
|
|
|
|
|
<simpara>
|
|
|
|
|
Puede ser necesario construir una extensión PECL estáticamente en el binario PHP.
|
|
|
|
|
Para ello, las fuentes de la extensión deben ser colocadas en el directorio
|
|
|
|
|
<filename>/path/to/php/src/dir/ext/</filename>, y el sistema de compilación de PHP debe
|
|
|
|
|
regenerar su script de configuración.
|
|
|
|
|
Para hacer esto, el código fuente de la extensión necesitará ser colocado bajo el
|
|
|
|
|
directorio <filename>/path/to/php/src/dir/ext/</filename>,
|
|
|
|
|
y el sistema de construcción de PHP necesitará regenerar su script de configuración.
|
|
|
|
|
</simpara>
|
|
|
|
|
<para>
|
|
|
|
|
<screen>
|
|
|
|
|
@@ -511,16 +545,16 @@ $ mv extname-x.x.x extname
|
|
|
|
|
</screen>
|
|
|
|
|
</para>
|
|
|
|
|
<simpara>
|
|
|
|
|
Esto generará el siguiente directorio:
|
|
|
|
|
Esto resultará en el siguiente directorio:
|
|
|
|
|
</simpara>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
/path/to/php/src/dir/ext/extname
|
|
|
|
|
]]>
|
|
|
|
|
</screen>
|
|
|
|
|
</screen>
|
|
|
|
|
<simpara>
|
|
|
|
|
A partir de aquí, PHP debe ser forzado a reconstruir el script de configuración,
|
|
|
|
|
y luego puede ser construido normalmente:
|
|
|
|
|
Desde aquí, PHP necesita ser forzado a reconstruir el script de configuración, y luego
|
|
|
|
|
puede ser construido normalmente:
|
|
|
|
|
</simpara>
|
|
|
|
|
<screen>
|
|
|
|
|
<![CDATA[
|
|
|
|
|
@@ -532,28 +566,28 @@ $ ./configure --with-extname --enable-someotherext --with-foobar
|
|
|
|
|
$ make
|
|
|
|
|
$ make install
|
|
|
|
|
]]>
|
|
|
|
|
</screen>
|
|
|
|
|
</screen>
|
|
|
|
|
<note>
|
|
|
|
|
<simpara>
|
|
|
|
|
Para ejecutar el script <command>buildconf</command>,
|
|
|
|
|
Para ejecutar el script <command>buildconf</command>, se necesitarán
|
|
|
|
|
<command>autoconf</command>
|
|
|
|
|
<literal>2.68</literal>
|
|
|
|
|
y
|
|
|
|
|
<command>automake</command>
|
|
|
|
|
<literal>1.4+</literal>
|
|
|
|
|
serán necesarios.
|
|
|
|
|
Las versiones más recientes de <command>autoconf</command> pueden funcionar pero no son soportadas.
|
|
|
|
|
<literal>1.4+</literal>.
|
|
|
|
|
Versiones más nuevas de <command>autoconf</command> pueden funcionar pero no son
|
|
|
|
|
compatibles.
|
|
|
|
|
</simpara>
|
|
|
|
|
</note>
|
|
|
|
|
<simpara>
|
|
|
|
|
El uso de
|
|
|
|
|
Si se usa
|
|
|
|
|
<option role="configure">--enable-extname</option>
|
|
|
|
|
o
|
|
|
|
|
<option role="configure">--with-extname</option>
|
|
|
|
|
depende de la extensión.
|
|
|
|
|
En general, una extensión que no requiere bibliotecas externas utiliza
|
|
|
|
|
Típicamente, una extensión que no requiere librerías externas usa
|
|
|
|
|
<option role="configure">--enable</option>.
|
|
|
|
|
Para asegurarse, ejecute el siguiente comando después de <command>buildconf</command>:
|
|
|
|
|
Para estar seguro, ejecute lo siguiente después de <command>buildconf</command>:
|
|
|
|
|
</simpara>
|
|
|
|
|
<screen>
|
|
|
|
|
<
Philippe DELENTE