wiki/HowtoShareDance.md

Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.

Howto Sharedance

Sharedance est un logiciel très simple conçu pour stocker des sessions en mémoire. Il est notamment utilisé sur les Skyblogs Il n'est plus maintenu depuis 2006 mais vu sa simplicité, son utilisation peut encore être envisagée.

http://www.pureftpd.org/project/sharedance

Installation

$ wget <http://download.pureftpd.org/pub/sharedance/sharedance-0.6.tar.gz>
$ tar xvf sharedance-0.6.tar.gz
$ cd sharedance-0.6
$ ./configure
$ make
# make install

Il peut être lancé ainsi :

# /usr/sbin/sharedanced --uid=65534 --gid=65534 --directory=/var/tmp --daemonize --expiration=10800

Son utilisation avec PHP se fait ainsi dans le fichier php.ini :

auto_prepend_file = /usr/local/etc/sharedance.php
;session.save_handler = user
;session.save_handler = files

avec un fichier sharedance.php du type :

<?php

define('SESSION_HANDLER_HOST', '127.0.0.1');
define('SHAREDANCE_DEFAULT_PORT', 1042);
define('SHAREDANCE_DEFAULT_TIMEOUT', 10);

function sharedance_open($host, $port = SHAREDANCE_DEFAULT_PORT,
                         $timeout = SHAREDANCE_DEFAULT_TIMEOUT) {
    global $GLOBAL_SHAREDANCE_FP;
    global $GLOBAL_SHAREDANCE_SETTING_HOST;
    global $GLOBAL_SHAREDANCE_SETTING_PORT;
    global $GLOBAL_SHAREDANCE_SETTING_TIMEOUT;

    if (!empty($GLOBAL_SHAREDANCE_FP)) {
        return 0;
    }
    if (empty($host)) {
        return -1;
    }
    $GLOBAL_SHAREDANCE_FP = @fsockopen($host, $port, $errno,
                                       $errstr, $timeout);
    if (!$GLOBAL_SHAREDANCE_FP) {
        return -1;
    }
    $GLOBAL_SHAREDANCE_SETTING_HOST = $host;
    $GLOBAL_SHAREDANCE_SETTING_PORT = $port;
    $GLOBAL_SHAREDANCE_SETTING_TIMEOUT = $timeout;

    return 0;
}

function sharedance_reopen() {
    global $GLOBAL_SHAREDANCE_FP;
    global $GLOBAL_SHAREDANCE_SETTING_HOST;
    global $GLOBAL_SHAREDANCE_SETTING_PORT;
    global $GLOBAL_SHAREDANCE_SETTING_TIMEOUT;

    if (!empty($GLOBAL_SHAREDANCE_FP)) {
        return 0;
    }
    if (sharedance_open($GLOBAL_SHAREDANCE_SETTING_HOST,
                        $GLOBAL_SHAREDANCE_SETTING_PORT,
                        $GLOBAL_SHAREDANCE_SETTING_TIMEOUT) !== 0) {
        return -1;
    }
    return 0;
}

function sharedance_close() {
    global $GLOBAL_SHAREDANCE_FP;

    if (empty($GLOBAL_SHAREDANCE_FP)) {
        return;
    }
    @fclose($GLOBAL_SHAREDANCE_FP);
    $GLOBAL_SHAREDANCE_FP = FALSE;
}

function sharedance_store($key, $data)
{
    global $GLOBAL_SHAREDANCE_FP;

    if (sharedance_reopen() !== 0) {
        return -1;
    }
    $key_len = strlen($key);
    $data_len = strlen($data);
    $s = sprintf('S%c%c%c%c%c%c%c%c',
                 ($key_len >> 24) & 0xff, ($key_len >> 16) & 0xff,
                 ($key_len >> 8) & 0xff, $key_len & 0xff,
                 ($data_len >> 24) & 0xff, ($data_len >> 16) & 0xff,
                 ($data_len >> 8) & 0xff, $data_len & 0xff);
    $s .= $key;
    $s .= $data;
    fwrite($GLOBAL_SHAREDANCE_FP, $s);
    if (@fgets($GLOBAL_SHAREDANCE_FP) !== "OK\n") {
        sharedance_close();
        return -1;
    }
    sharedance_close();

    return 0;

function sharedance_fetch($key)
{
    global $GLOBAL_SHAREDANCE_FP;

    if (sharedance_reopen() !== 0) {
        return -1;
    }
    $key_len = strlen($key);
    $s = sprintf('F%c%c%c%c',
                 ($key_len >> 24) & 0xff, ($key_len >> 16) & 0xff,
                 ($key_len >> 8) & 0xff, $key_len & 0xff);
    $s .= $key;
    stream_set_blocking($GLOBAL_SHAREDANCE_FP, 0);
    fwrite($GLOBAL_SHAREDANCE_FP, $s);
    stream_set_blocking($GLOBAL_SHAREDANCE_FP, 1);
    $data = '';
    while (($tmp = @fread($GLOBAL_SHAREDANCE_FP, 4096)) != FALSE) {
        $data .= $tmp;
    }
    sharedance_close();
    if ($data === '') {
        return FALSE;
    }
    return $data;
}

function sharedance_delete($key)
{
    global $GLOBAL_SHAREDANCE_FP;

    if (sharedance_reopen() !== 0) {
        return -1;
    }
    $key_len = strlen($key);
    $s = sprintf('D%c%c%c%c',
                 ($key_len >> 24) & 0xff, ($key_len >> 16) & 0xff,
                 ($key_len >> 8) & 0xff, $key_len & 0xff);
    $s .= $key;
    stream_set_blocking($GLOBAL_SHAREDANCE_FP, 0);
    fwrite($GLOBAL_SHAREDANCE_FP, $s);
    stream_set_blocking($GLOBAL_SHAREDANCE_FP, 1);
    if (@fgets($GLOBAL_SHAREDANCE_FP) !== "OK\n") {
        sharedance_close();
        return -1;
    }
    sharedance_close();

    return 0;
}

function session_handler_open($save_path, $session_name)
{
    if (sharedance_open(SESSION_HANDLER_HOST) !== 0) {
        return FALSE;
    }
    return TRUE;
}

function session_handler_close() {
    sharedance_close();

    return TRUE;
}

function session_handler_store($key, $data) {
    if (sharedance_store($key, $data) !== 0) {
        return FALSE;
    }
    return TRUE;
}

function session_handler_fetch($key) {
    return sharedance_fetch($key);
}

function session_handler_delete($key) {
    if (sharedance_delete($key) !== 0) {
        return FALSE;
    }
    return TRUE;
}

function session_handler_gc($timeout) {
    return TRUE;
}

session_set_save_handler('session_handler_open', 'session_handler_close',
                         'session_handler_fetch', 'session_handler_store',
                         'session_handler_delete', 'session_handler_gc');

?>