Description d`utilisation des scripts PHP

INFORMATION GENERALE

En activant le service PHP pour le site, le compte est créé sur le serveur séparé, ou se passe l`exécution de tous les scripts PHP. Accès à ce compte, téléchargement, changement et suppression des données est réalisé selon le procès-verbal FTP avec le nom d`utilisateur et le mot de passe (qui a été indiqué en activant le service PHP). Vous pouvez voir le nom d`utilisateur et le mot de passe dans le panneau de configuration du site.

En créant le compte, le répertoire "scripts" est créé automatiquement. Tous les scripts PHP, qui sont rappelés sur les pages du site, doivent se trouver dans ce répertoire. Tous les scripts doivent avoir l`extension ".php", seulement tels fichiers sont accessibles sur les références directes. On peut recevoir tous les autres fichiers (leurs contenu) SEULEMENT au moyen des scripts PHP.
Tous les comptes sont créés avec les limitation suivantes:

webspace maximal - 200Mb
quantité maximale des fichiers et des répertoires - 10000
quantité maximale des fichiers dans le répertoire - 500
temps maximal d`exécution du script - 25 secondes

COMMENT UTILISER

On peut utiliser les scripts PHP sur les pages du site dans le domaine courant par proxy:

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

On peut utiliser la fonction PHPCODE dans les modèles pour rappeler le script PHP comme suit:

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

où:

SITE_ADDRESS - l`adresse du site d`utilisateur, ou le script est exécuté
SCRIPT_NAME - le chemin d'accès (concernant la chemise "scripts") et le nom du script, qui est exécuté
?param0=valueA&param1=valueB...&paramN=valueM - les paramètres non obligatoires pour le script

Cette fonction fait la demande GET pour le script indiqué. La réponse pour cette fonction doit être rendue seulement dans le format json, c'est-à-dire en utilisant cette fonction aux modèles des pages le script, rappelé par lui, ne doit pas changer le type des données rendues pour un autre (au moyen d`installation de la variable $___notjson, d`utilisation la fonction header('Content-type: TYPE') etc.) On peut l`utiliser une fois sur la page. Pour appel de quelques scripts sur une page au moyen de GET on peut utiliser le code javascript de base de la fonction $PHPCODE$, en changeant id du tag <div id="phpdiv">

On peut réaliser l`utilisation des demandes POST à l'aide des formes, iframe, autres scripts de ce domaine etc., par exemple:

dans le fichier du modèle:


<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>

dans le 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>";

?>

dans le fichier du modèle:


<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>

dans le 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>";

?>

Il y a quelques paramètres dont on peut gérer dans le script:

$___notjson=1 - si la variable est établie comme 1, le résultat du travail du script revient sous telle forme, sous quelle il a été formé par le script, sinon (par défaut informatique) le résultat revient dans le format json.
$___retval - le résultat du travail du script (les données, revenus par lui), on peut l`établir dans le script d`utilisateur et l`utiliser comme le resultat du travail.
$___error - est utilisée comme la description de la faute au cas où le script doit la rendre

N`UTILISEZ PAS __FILE__, puisque les scripts sont exécutés par wrapper, et la variable est déterminée comme le titre du script.

Attention!
1. Chaque tentative d`utiliser les scripts PHP pour les actions malintentionnées, notamment pour l`envoi n'importe où des demandes HTTP en grande quantité, est passible de la suppression du site!
2. Par défaut informatique le resultat du travail du script revient au FORMAT JSON.