shmop_open

(PHP 4 >= 4.0.4, PHP 5)

shmop_open — Cr�e ou ouvre un bloc de m�moire partag�e

Description

int shmop_open ( int $key , string $flags , int $mode , int $size )

shmop_open() peut cr�er ou ouvrir un bloc de m�moire partag�e.

Liste de param�tres

key

Identifiant syst�me pour le bloc de m�moire partag�. Ce param�tre peut �tre pass� comme un d�cimal ou un hexad�cimal.

flags

Vous pouvez utiliser :

  • "a" pour acc�s (utilise SHM_RDONLY pour shmat) utilisez cette option pour ouvrir un bloc d�j� existant en lecture seule.
  • "c" pour cr�ation (utilise IPC_CREATE) utilisez cette option pour cr�er un nouveau bloc, ou, si un segment avec le m�me identifiant existe, essayer d'y acc�der en lecture et �criture.
  • "w" pour acc�s en lecture et �criture. Utilisez cette option lorsque vous devez acc�der en lecture et �criture � un segment de m�moire partag�e. C'est le cas le plus courant.
  • "n" cr�e un nouveau segment de m�moire partag�e (utilise IPC_CREATE|IPC_EXCL). Utilisez cette option lorsque vous voulez cr�er un nouveau segment de m�moire partag�e sauf s'il en existe d�j� un corrompu avec la m�me option. Ceci est tr�s pratique pour des raisons de s�curit�, pour �viter des trous de s�curit� qui exploiteraient la course aux ressources.

mode

Les permissions que vous donnez � ce bloc. Ce sont les m�mes que pour les fichiers. Ces permissions doivent �tre pass�es sous forme d'octal (i.e. 0644).

size

La taille du bloc m�moire partag� que vous voulez cr�er, en octets

Note: Note : Les troisi�me et quatri�me param�tres doivent �tre pass�s � 0 si vous voulez ouvrir un bloc de m�moire partag�e d�j� existant.

Valeurs de retour

En cas de succ�s shmop_open() retourne un identifiant que vous pouvez utiliser pour acc�der � la m�moire que vous venez de cr�er. FALSE sera retourn� si une erreur survient.

Exemples

Exemple #1 Cr�er un nouveau bloc de m�moire partag�e Shmop

<?php
$shm_key = ftok(__FILE__, 't');
$shm_id = shmop_open($shm_key, "c", 0644, 100);
?>

Cet exemple ouvre un nouveau bloc de m�moire partag�e, dont l'identifiant est retourn� par ftok().

Voir aussi

Fonctions sur la m�moire partag�e
PHP Manual