(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
shmop_open — Crée ou ouvre un bloc de mémoire partagée
shmop_open() peut créer ou ouvrir un bloc de mémoire partagée.
keyIdentifiant système pour le bloc de mémoire partagé. Ce paramètre peut être passé comme un décimal ou un hexadécimal.
modeVous 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.
permissionsLes 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).
sizeLa 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.
En cas de succès, shmop_open() retourne une
instance de Shmop que vous pouvez utiliser pour accéder à la mémoire que
vous venez de créer. false sera retourné en cas d'échec.
Si mode est invalide, ou si size est inférieur ou égal à zéro,
une ValueError est levée.
Dans d'autres cas d'échec, un E_WARNING est émis.
| Version | Description |
|---|---|
| 8.0.0 |
shmop attend une instance de Shmop
désormais; auparavant une resource était attendu.
|
| 8.0.0 |
Si mode est invalide, ou si size est inférieur ou égal à zéro,
une ValueError est levée ; auparavant, un E_WARNING était émis à la place,
et la fonction retournait false.
|
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().