PHP Execute

4D v16.3

PHP

PHP Execute


PHP Execute ( rutaScript {; nomFuncion {; resultPHP {; param} {; param2 ; ... ; paramN}}} ) -> Resultado

Parámetro	Tipo	Descripción
rutaScript	Texto	Ruta de acceso al script PHP o "" para ejecutar una función PHP
nomFuncion	Texto	Función PHP a ejecutar
resultPHP	Operador, Variable, Campo	Resultado de ejecución de la función PHP o * para no recibir el resultado
param	Texto, Booleano, Real, Entero largo, Fecha, Hora	Parámetros de la función PHP
Resultado	Booleano	True = ejecución correcta, False = error de ejecución

Descripción

El comando PHP Execute permite ejecutar un script o una función PHP.

Pase en el parámetro rutaScript la ruta de acceso del archivo de script PHP a ejecutar. Puede ser una ruta de acceso relativa si el archivo está ubicado junto a la estructura de la base o de una ruta absoluta. La ruta de acceso puede expresarse en sintaxis sistema o POSIX.
Si quiere ejecutar directamente una función PHP estándar, pase una cadena vacía ("") en rutaScript. El nombre de la función debe pasarse en el segundo parámetro.

Pase en el parámetro nomFuncion un nombre de función PHP si quiere ejecutar una función específica en el script rutaScript. Si pasa una cadena vacía u omite el parámetro nomFuncion, el script se ejecuta completamente.

Nota: PHP tiene en cuenta las mayúsculas y minúsculas de los caracteres en el nombre de la función. No utilice paréntesis, introduzca únicamente el nombre de la función.

El parámetro resultPHP recibe el resultado de la ejecución de la función PHP. Puede pasar:

una variable, un array o un campo para recibir el resultado,
el carácter * si la función no devuelve ningún resultado o si no quiere recuperar el resultado.

El parámetro resultPHP puede ser de tipo texto, entero largo, real, booleano o fecha así como también (excepto para arrays) BLOB u hora. 4D efectuará la conversión de los datos y los ajustes necesarios siguiendo los principios descritos en la sección a continuación.

si pasa un nombre de función en el parámetro nomFuncion, resultPHP recibirá lo que el desarrollador PHP devuelve con el comando return del cuerpo de la función.
Si utiliza el comando sin pasar un nombre de función en el parámetro nomFuncion, resultPHP recibirá lo que el desarrollador PHP devolvió con el comando echo ( o un comando similar).

Si llama a una función PHP que espera argumentos, utilice los parámetros param1...N para pasar uno o varios valores. Los valores deben estar separados por punto y coma. Puede pasar valores de tipo alfa, texto, booleano, real, entero, entero largo, fecha u hora. Las imágenes y los BLOBs y objetos no se aceptan. Puede enviar un array; en este caso debe pasar un puntero en el array al comando PHP Execute, de lo contrario el índice actual del array se enviará como un entero (ver el ejemplo). El comando acepta todos los tipos de arrays excepto los arrays puntero, los arrays imagen y los arrays 2D.

Nota: por razones técnicas, el tamaño de los parámetros pasados vía el protocolo FastCGI no debe pasar los 64 KB. Debe tener en cuenta esta limitación si utiliza parámetros de tipo Texto.

El comando devuelve True si la ejecución se ha efectuado correctamente del lado de 4D, en otras palabras, si el lanzamiento del entorno de ejecución, la apertura del script y el establecimiento de la comunicación con el intérprete PHP fueron exitosos. De lo contrario, se genera un error, que puede interceptar con el comando ON ERR CALL y analizar con GET LAST ERROR STACK.
Además, el script mismo puede generar errores PHP. En este caso, debe utilizar el comando PHP GET FULL RESPONSE para analizar la fuente del error (ver ejemplo 4).

Nota: PHP permite configurar la gestión de errores. Para mayor información, consulte por ejemplo la página: http://www.php.net/manual/en/errorfunc.configuration.php#ini.error-reporting.

Conversión de los datos devueltos

La siguiente tabla especifica cómo 4D interpreta y convierte los datos devueltos en función del tipo del parámetro resultPHP.

Tipo del parámetro resultPHP	Proceso 4D	Ejemplo
BLOB	4D recupera los datos recibidos sin ninguna modificación(*).
Texto	4D espera los datos codificados en UTF-8 (). El desarrollador PHP puede necesitar utilizar el comando PHP utf8_encode*.	Ejemplo de script PHP: `echo utf8_encode(miTexto)`
Fecha	4D espera una fecha enviada como una cadena en formato RFC 3339 (también llamado DATE_ATOM en PHP). Este formato es de tipo "AAAA-MM-DDTHH:MM:SS", por ejemplo: 2005-08-15T15:52:01+00:00. 4D ignora la parte hora y devuelve la fecha en UTC.
Hora	4D espera una hora enviada en forma de cadena en formato RFC 3339 (ver el tipo Fecha). 4D ignora la parte fecha y devuelve el número de segundos transcurridos desde la media noche considerando la fecha en la zona horaria local.	Ejemplo de script PHP para enviar 2h30'45": `echo date( DATE_ATOM, mktime( 2,30,45))`
Entero o Real	4D interpreta el valor numérico expresado con números, signo + o - y/o el exponente con el prefijo 'e'. Todo carácter '.' o ',' se interpreta como un separador decimal.	Ejemplo de script PHP: `echo -1.4e-16;`
Booleano	4D devuelve True si recibe la cadena "true" desde PHP o si la evaluación numérica da un valor no nulo.	Ejemplo de script PHP: `echo (a==b);`
Array	4D considera que el array PHP fue devuelto en el formato JSON.	Ejemplo de script PHP para devolver un array de dos textos: `echo json_encode( array( "hola", "mundo"));`

(*) Por defecto, no se devuelven los encabezados HTTP:
- Si utiliza PHP Execute al pasar una función en el parámetro nomFuncion, los encabezados HTTP nunca se devuelven en resultPHP. Sólo están disponibles por medio del comando PHP GET FULL RESPONSE.
- Si utiliza PHP Execute sin un nombre de función (el parámetro nomFuncion se omite o contiene una cadena vacía), puede devolver los encabezados HTTP fijando la opción PHP Raw result en True utilizando el comando PHP SET OPTION.

Nota: si debe recuperar grandes volúmenes de datos utilizando PHP, es más eficiente pasar por el canal del buffer stdOut (comando echo o similar) que por el retorno de función. Para mayor información, consulte la descripción del comando PHP GET FULL RESPONSE.

Using environment variables

Puede utilizar el comando SET ENVIRONMENT VARIABLE para definir las variables de entorno utilizadas por el script. Atención: después de llamar LAUNCH EXTERNAL PROCESS o PHP Execute, el conjunto de las variables entorno se borra.

Special functions

4D ofrece las siguientes funciones especiales:

quit_4d_php: permite salir del intérprete PHP y de todos sus procesos hijos. Si al menos uno de los procesos hijo está ejecutando un script, el intérprete no sale y el comando PHP Execute devuelve False.
relaunch_4d_php: permite relanzar el intérprete PHP.

Note que el intérprete se relanza automáticamente cuando la primera petición se envía por PHP Execute.

Ejemplo 1

Llamada del script "myPhpFile.php" sin función. Este es el contenido del script:

<?php
echo 'Versión PHP actual: ' . phpversion();
?>

El siguiente código 4D:

 C_TEXT($result)

 C_BOOLEAN($isOK)

 $isOK:=PHP Execute("C:\php\myPhpFile.php";"";$result)

 ALERT($Result)

... mostrará "Versión PHP actual: 5.3"

Ejemplo 2

Llamada de la función myPhpFunction en el script "myNewScript.php" con parámetros. Este es el contenido del script:

<?php
// . . . código PHP. . .
function myPhpFunction($p1, $p2) {
    return $p1 . ' '. $p2;
}
// . . . código PHP.. . .
?>

Llamada con función:

 C_TEXT($result)

 C_TEXT($param1)

 C_TEXT($param2)

 C_BOOLEAN($isOk)

 $param1 :="¡Hola"

 $param2 :="mundo 4D!"

 $isOk:=PHP Execute("C:\MyFolder\myNewScript.php";"myPhpFunction";$result;$param1;$param2)

 ALERT($result) // Muestra "¡Hola mundo 4D!"

Ejemplo 3

Salir del intérprete PHP:

$ifOk:=PHP Execute("";"quit_4d_php")

Ejemplo 4

Gestión de errores:

  // Instalación del método de gestión de errores

 phpCommError:="" // Modificado por PHPErrorHandler

 $T_saveErrorHandler :=Method called on error

 ON ERR CALL("PHPErrorHandler")</p><p> // Ejecución del script

 C_TEXT($T_result)

 If(PHP Execute("C:\MyScripts\MiscInfos.php";"";$T_result))

  // Ningún error, $T_Result contiene el resultado

 Else

  // Se ha detectado un error, administrado por PHPErrorHandler

    If(phpCommError="")

       ... // error PHP, utilice PHP GET FULL RESPONSE

    Else

       ALERT(phpCommError)

    End if

 End if

 

  // Desinstalación del método

 ON ERR CALL($T_saveErrorHandler)

El método PHP_errHandler es el siguiente:

 phpCommError:=""

 GET LAST ERROR STACK(arrCodes;arrComps;arrLabels)

 For($i;1;Size of array(arrCodes))

    phpCommError:=phpCommError+String(arrCodes{$i})+" "+arrComps{$i}+" "+

    arrLabels{$i}+Char(Carriage return)

 End for

Ejemplo 5

Creación dinámica por 4D de un script antes de su ejecución:

 DOCUMENT TO BLOB("C:\Scripts\MyScript.php";$blobDoc)

 If(OK=1)

    $strDoc:=BLOB to text($blobDoc;UTF8 text without length)

 

    $strPosition:=Position("function2Rename";$strDoc)

 

    $strDoc:=Insert string($strDoc;"_v2";Length("function2Rename")+$strPosition)

 

    TEXT TO BLOB($strDoc;$blobDoc;UTF8 text without length)

    BLOB TO DOCUMENT("C:\Scripts\MyScript.php";$blobDoc)

    If(OK#1)

       ALERT("Error on script creation")

    End if

 End if

Se ejecuta el script:

$err:=PHP Execute("C:\Scripts\MyScript.php";"function2Rename_v2";*)

Ejemplo 6

Recuperación directa de un valor de tipo fecha y hora. Este es el contenido del script:

<?php
// . . . code php. . .
echo date(DATE_ATOM, mktime(1, 2, 3, 4, 5, 2009));
// . . . code php. . .
?>

Recepción de la fecha del lado 4D:

 C_DATE($phpResult_date)

 $result :=PHP Execute("C:\php_scripts\ReturnDate.php";"";$phpResult_date)

  //$phpResult_date is !05/04/2009 !

 

 C_TIME($phpResult_time)

 $result :=PHP Execute("C:\php_scripts\ReturnDate.php";"";$phpResult_time)

  //$phpResult_time is ?01 :02 :03 ?

Ejemplo 7

Distribución de datos en arrays:

 ARRAY TEXT($arText ;0)

 ARRAY LONGINT($arLong ;0)

 $p1 :=","

 $p2 :="11,22,33,44,55"

 $phpok :=PHP Execute("";"explode";$arText;$p1;$p2)

 $phpok :=PHP Execute("";"explode";$arLong;$p1;$p2)

 

  // $arText contiene los valores Alfa "11", "22", "33", etc.

  // $arLong contiene los números, 11, 22, 33, etc.

Ejemplo 8

Inicialización de un array:

 ARRAY TEXT($arText ;0)

 $phpok :=PHP Execute("";"array_pad";$arText;->$arText;50;"indefinido")

  // Ejecute en PHP: $arrTest = array_pad($arrTest, 50, ’indefinido’);

  // Llene el array $arText con 50 elementos "indefinido"

Ejemplo 9

Paso de parámetros vía un array:

 ARRAY INTEGER($arInt;0)

 $phpok :=PHP Execute("";"json_decode";$arInt;"[13,51,69,42,7]")

  // Ejecute en PHP: $arInt = json_decode(’[13,51,69,42,7]’);

  // Llene el array con los valores iniciales

Ejemplo 10

Este es un ejemplo de la utilización básica de la función trim, para eliminar espacios adicionales y/o caracteres invisibles de principio a fin de una cadena:

 C_TEXT($T_String)

 $T_String:="   Hello  "

 C_BOOLEAN($B)

 $B:=PHP Execute("";"trim";$T_String;$T_String)

Para obtener más información acerca de la función trim, por favor, consulte la documentación de PHP.

Ver también

Ejecutar scripts PHP en 4D
PHP GET FULL RESPONSE
PHP SET OPTION