shm_attach

(PHP 4, PHP 5, PHP 7, PHP 8)

shm_attachCria ou abre um segmento de memória compartilhada

Descrição

shm_attach(int $key, ?int $size = null, int $permissions = 0666): SysvSharedMemory|false

shm_attach() retorna um id que pode ser usado para acessar a memória compartilhada do System V com a chave fornecida em key. A primeira chamada cria o segmento de memória compartilhada com tamanho size e os bits de permissão opcionais permissions.

Uma segunda chamada a shm_attach() para a mesma key retornará uma instância diferente de SysvSharedMemory, mas ambas as instâncias acessam a mesma memória compartilhada subjacente. size e permissions serão ignorados.

Parâmetros

key

Um ID numérico de segmento de memória compartilhada

size

O tamanho da memória. Se não for fornecido, o padrão é sysvshm.init_mem no php.ini caso contrário, 10000 bytes.

permissions

Bits de permissão opcionais. Padrão: 0666.

Valor Retornado

Retorna uma instância SysvSharedMemory em caso de sucesso, ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 Em caso de sucesso, esta função retorna uma instância de SysvSharedMemory; anteriormente, um resource era retornado.
8.0.0 size agora é anulável.

Veja Também

  • shm_detach() - Desconecta do segmento de memória compartilhada
  • ftok() - Converte um nome de caminho e um identificador de projeto em uma chave IPC do System V