Descripción de la utilización de los scripts PHP

INFORMACIÓN GENERAL

Después de activar el servicio de PHP para el sitio, se crea un registro en el servidor independiente donde se realiza la ejecución de todos los scripts PHP. El acceso a este registro, subida, modificación y eliminación de los datos se realiza por el protocolo FTP con el login y contraseña (configurados durante la activación del servicio de PHP) que los pueden ver en el Panel de Control del sitio web.

Durante la creación de la cuenta se crea automáticamente un directorio “scripts” donde han de estar puestos todos los scripts PHP que se llaman en las páginas del sitio web. Todos los scripts han de tener la extensión “.php”, solamente estos archivos son accesibles por los enlaces directos. Todos los demás archivos (su contenido) pueden estar obtenidos SOLAMENTE con ayuda de los propios scripts PHP.
Se crean todos los registros con las siguientes limitaciones:

volumen máximo del espacio en disco es - 200Мb
número máximo de archivos y directorios - 10000
número máximo de archivos en un directorios - 500
tiempo máximo de la ejecución de un script - 25 segundos

MODO DE EMPLEO

Utilizar los scripts PHP en las páginas del sitio web es posible en el dominio actual con ayuda de la proxificación:

http://SITE_ADDRESS/php/SCRIPT_NAME.php?param0=valueA&param1=valueB...&paramN=valueM

En las plantillas para llamar el script PHP se puede utilizar la función PHPCODE de manera siguiente:

<?$PHPCODE$("http://SITE_ADDRESS/php/SCRIPT_NAME.php?param0=valueA&param1=valueB...&paramN=valueM")?>

donde:

SITE_ADDRESS - es la dirección del sitio del usuario donde se ejecuta el script
SCRIPT_NAME - es la ruta (respectivamente la carpeta “scripts”) y el nombre del script que se está ejecutando
?param0=valueA&param1=valueB...&paramN=valueM - son parámetros innecesarios para el script

Esta función realiza una solicitud GET para el script especificado. La respuesta para la solicitud ha de estar devuelta solamente en el formato json, o sea, durante la utilización de esa función en las plantillas de las páginas el script llamado por ésta, no debe cambiar el tipo de los datos devueltos por cualquiera otra (por la vía de la instalación de la variable $___notjson, utilización de la función header('Content-type: TYPE') etc.). Puede estar realizada una sola vez en la página. Para la llamada por el método GET de varios scripts en una página se puede utilizar el código fuente script de la función $PHPCODE$ cambiando el identificador (id) del tag <div id="phpdiv">.

La realización de las solicitudes POST es posible con ayuda de las formas, iframe, otros scripts de este dominio etc. Por ejemplo:

en el archivo de la plantilla:


<script type="text/javascript">

    function updatepostdata(result) { $('#postdiv').html(result); }

</script>

<div id="postdiv"></div>

<iframe frameborder="0" src="http://SITE_ADDRESS/php/SCRIPT_NAME.php?param0=valueA&param1=valueB...&paramN=valueM"></iframe>

en el script SCRIPT_NAME.php:


<?

$___notjson=1;

if ($_POST)

{

    $ret="POST OK:<br>";

    foreach ($_POST as $i => $val) $ret.="$i=$val<br>";

    echo "<script type=\"text/javascript\">

    window.parent.updatepostdata(\"$ret\");

    </script>";

}

echo "<form 
action=\"http://SITE_ADDRESS/php/SCRIPT_NAME.php?param0=valueA&param1=valueB...&paramN=valueM\" 
method=\"POST\">

<input type=\"hidden\" name=\"field0\" value=\"test_".rand()."\">

<input type=\"submit\" value=\"Go\">

</form>";

?>

en el archivo de la plantilla:


<script type="text/javascript">

    function updatepostdata(result) { $('#postdiv').html(result); }

</script>

<div id="postdiv"></div>

<iframe frameborder="0">

    <form 
action=\"http://SITE_ADDRESS/php/SCRIPT_NAME.php?param0=valueA&param1=valueB...&paramN=valueM\" 
method=\"POST\">

        <input type=\"hidden\" name=\"field0\" value=\"test_".rand()."\">

        <input type=\"submit\" value=\"Go\">

    </form>

</iframe>

en el script SCRIPT_NAME.php:


<?

$___notjson=1;

if ($_POST)

{

    $ret="POST OK:<br>";

    foreach ($_POST as $i => $val) $ret.="$i=$val<br>";

    echo "<script type=\"text/javascript\">

    window.parent.updatepostdata(\"$ret\");

    </script>";

}

else echo "No data<br>";

?>

Hay unos cuantos parámetros que pueden estar gestionados en el script:

$___notjson=1 - si esta variable equivale a “1”, el resultado de la ejecución del script vuelve en el mismo aspecto como lo formó el script, de lo contrario (por defecto) el resultado será en el formato json
$___retval - el resultado de la ejecución del script (los datos devueltos por él), puede estar instalado en el script del usuario y se utilizará como el resultado de la ejecución
$___error - se utiliza como la descripción del error en caso cuando el script lo debe devolver

NO UTILICE __FILE__, pues los scripts se ejecutan con ayuda de “wrapper” y esta variable está definida como el nombre del wrapper-script.

¡Atención!
1. ¡Todo tipo de tentativas de utilizar los scripts PHP para acciones malintencionados, como poder enviar un gran número de las peticiones HTTP a alguna parte, se sancionará con la eliminación del sitio!
2. De predeterminado el resultado de la ejecución del script se devuelve EN EL FORMATO JSON.