Manuel PHP
Précédent |  | Suivant

# 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

shmop_close()
shmop_delete()

Précédent | Sommaire | Suivant
shmop_delete | Niveau supérieur | shmop_read