Si aucun espace de noms n'est spécifié lors de l'instanciation de Zend_Session_Namespace, toutes les données sont stockées de manière transparente dans un espace de noms appelé "Default". Zend_Session n'est pas prévu pour fonctionner directement sur le contenu des conteneurs des espaces de noms. Au lieu de cela, nous utilisons Zend_Session_Namespace. L'exemple ci-dessous montre l'utilisation de cet espace de noms par défaut, en montrant comment compter le nombre de fois qu'un utilisateur a vu une page sur le site Web. Pour tester cet exemple, ajouter le code suivant à votre fichier d'amorçage ZF :

$defaultNamespace = new Zend_Session_Namespace('Default');

if (isset($defaultNamespace->numberOfPageRequests)) {
    $defaultNamespace->numberOfPageRequests++;
    // ceci s'incrémente à chaque chargement de page.
} else {
    $defaultNamespace->numberOfPageRequests = 1;
    // première page
}

echo "Page demandée lors de cette session : ",
     $defaultNamespace->numberOfPageRequests;

Quand de multiples modules utilisent des instances de Zend_Session_Namespace ayant différents espaces de noms, chaque module obtient une encapsulation pour ses propres données de session. Le constructeur de Zend_Session_Namespace peut recevoir un paramètre facultatif $namespace, qui permet aux développeurs la partition des données de session dans des espaces de noms séparés. Les espaces de noms fournissent une manière efficace et populaire de protéger un sous-ensemble de données de session contre un changement accidentel dû à des collisions de noms.

Les noms des espaces de noms sont limités à des chaînes de caractères PHP non-vides qui ne commencent par un tiret-bas ("_"). De plus, seuls les composants coeur de Zend Framework devraient employer un nom d'espace de noms commençant par "Zend".

// Dans le composant Zend_Auth
$authNamespace = new Zend_Session_Namespace('Zend_Auth');
$authNamespace->user = "monusername";

// Dans un composant service web
$webServiceNamespace = new Zend_Session_Namespace('Un_Service_Web');
$webServiceNamespace->user = "monwebusername";

L'exemple ci-dessus réalise la même chose que celui ci-dessous, excepté que les objets de session ci-dessus préserve l'encapsulation des données de session dans leur espace de noms respectif.

$_SESSION['Zend_Auth']['user'] = "monusername";
$_SESSION['Un_Service_Web']['user'] = "monwebusername";

Zend_Session_Namespace fournit une interface IteratorAggregate complète, incluant le support de l'instruction foreach :

$unNamespace =
    new Zend_Session_Namespace('un_namespace_avec_des_donnes_presentes');

foreach ($unNamespace as $index => $valeur) {
    echo "unNamespace->$index = '$valeur';\n";
}

Zend_Session_Namespace implémente __get(), __set(), __isset(), et __unset(). Les méthodes magiques ne devraient pas être utilisées directement, excepté à l'intérieur d'une sous-classe. Au lieu de cela, utilisez les opérateurs normaux pour appeler ces méthodes magiques, comme :

$namespace = new Zend_Session_Namespace();
// Espace de noms par défaut

$namespace->foo = 100;

echo "\$namespace->foo = $namespace->foo\n";

if (!isset($namespace->bar)) {
    echo "\$namespace->bar n'existe pas\n";
}

unset($namespace->foo);