Beschreibung von Benutzung von PHP-Scripten

ALLGEMEINE INFORMATION

Bei der Aktivierung der Dienstleistung PHP für die Seite wird ein neues Benutzerkonto auf separaten Server erstellt, wo die Ausführung von allen PHP-Scripten geschieht. Zugang zu diesem Benutzerkonto, Hochladung, Änderung und Löschung der Angaben ist nach dem Protokoll FTP mit Login und Kennwort (das bei der Aktivierung der Dienstleistung PHP angegeben wurde) gemacht. Man kann den Login und das Kennwort im Verwaltungspanel der Seite ansehen.

Bei Erstellung vom Benutzerkonto wird das Verzeichnis scripts erstellt, wo sich alle php-scripte befinden sollen, die auf der Seiten aufgerufen werden. Alle Scripte müssen die Erweiterung ".php" haben, nur diese Dateien sind zugänglich durch direkte Links. Alle anderen Dateien (ihre Inhalte) kann man NUR durch php-Scripte bekommen.
Alle Benutzerkonten werden mit den folgenden Beschränkungen erstellt:

Max Webspace beträgt - 200Mb
Maximale Anzahl an Dateien und Verzeichnissen - 10000
Maximale Anzahl an Dateien in einem Ordner - 500
Maximalzeit von der Ausführung von einem Script - 25 Sekunden

BENUTZUNG

Man kann php-Scripte auf der Seite in der aktuellen Domain durch Proxys benutzen:

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

Um einen php-Script in den Schablonen aufzurufen, kann man die Funktion PHPCODE benutzen:

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

Wo:

SITE_ADDRESS - die Adresse der Benutzerseite, wo der Script ausgeführt wird
SCRIPT_NAME - der Pfad (hinsichtlich des Ordners scripts) und der Name vom Script, der ausgeführt wird
?param0=valueA&param1=valueB...&paramN=valueM - nicht obligatorische Parameter für den Script

Diese Funktion macht die GET-Anfrage auf den angegebenen Script. Die Antwort darauf muss nur im Format json zurückgegeben werden, und zwar bei der Benutzung dieser Funktion in den Schablonen von den Seiten muss der von ihnen aufrufender Script nicht den Typ von den zurückgegebenen Angaben auf anderen ändern (durch die Erstellung der Veränderlichen $___notjson, die Benutzung der Funktion header('Content-type: TYPE') usw.). Man kann sie einmal auf der Seite benutzen. Für die Aufrufe von einigen Scripts auf eine Seite durch GET kann man Ausgangs Javascript Code der Funktion $PHPCODE$ benutzen, id des Tags <div id="phpdiv"> ändern.

Man kann die Benutzung von POST-Anfragen durch die Formen, iframe und anderen Scripten von dieser Domain usw. realisieren, zum Beispiel:

in die Datei der Schablone:


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

im 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>";

?>

ODER

in der Datei von der Schablone:


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

im 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>";

?>

Es gibt ein paar Parameter, die man im Script verwalten kann.

$___notjson=1 - wenn die angegebene Veränderliche auf 1 ist, wird das Resultat der Arbeit vom Script zurückkommen in der Form, in welcher es vom Script gebildet worden ist, sonst (als Standardregel) kommt das Resultat im json Format zurück
$___retval - das Resultat der Arbeit wird vom Script (die von ihm zurückgegebene Angaben), kann im Script vom Benutzer aufgestellt sein und benutzt wird, wie ein Resultat von der Arbeit
$___error - wird für eine Beschreibung des Fehlers benutzt, falls Script sie zurückgeben soll

BENUTZEN SIE NICHT __FILE__, weil die Scripte durch wrapper ausgeführt werden und die angegebene Veränderliche wie der Name vom wrapper-Script aufgestellt ist.

Achtung!
1.Jeder Versuch die PHP-Scripte für die böswilligen Aktionen zu benutzen, u.a. für die Absendung der großen Anzahl von HTTP- Anfragen irgendwohin, wird durch die Löschung der Seite gestraft!
2. Als Standardregel wird das Resultat der Arbeit vom Script im Format JSON zurückgegeben.