Eio

Introdução

Esta extensão fornece E/S POSIX assíncrona por meio da biblioteca C » libeio escrita por Marc Lehmann.

Nota: Esta extensão não está disponível em plataformas Windows.

Aviso

É importante estar ciente de que cada solicitação é executada em um thread e a ordem de execução das solicitações enfileiradas continuamente é basicamente imprevisível. Por exemplo, o trecho de código a seguir está incorreto.

Exemplo #1 Requisições incorretas

<?php
// Solicitação para criar link simbólico de $filename para $link
eio_symlink($filename, $link);

// Solicitação para mover $filename para $new_filename
eio_rename($filename, $new_filename);

// Processa solicitações
eio_event_loop();
?>

No exemplo acima a solicitação eio_rename() pode terminar antes de eio_symlink(). Para corrigir, pode-se chamar eio_rename() na função de retorno de eio_symlink():

Exemplo #2 Chamando solicitação de uma chamada de solicitação

<?php
function my_symlink_done($filename, $result) {
 // Solicitação para mover $filename para $new_filename
 eio_rename($filename, "/path/to/new-name");

 // Processa solicitações
 eio_event_loop();
}

// Solicitação para criar ligação simbólica de $filename para $link
eio_symlink($filename, $link, EIO_PRI_DEFAULT, "my_symlink_done", $filename);

// Processa solicitações
eio_event_loop();
?>

Alternativamente, pode-se criar um grupo de solicitações:

Exemplo #3 Chamando solicitação de uma chamada de solicitação

<?php
/* É chamado quando as solicitações do grupo são concluídas */
function my_grp_done($data, $result) {
 // ...
}

function my_symlink_done($filename, $result) {
 // Cria a solicitação eio_rename e adiciona-a ao grupo
 $req = eio_rename($filename, "/path/to/new-name");
 eio_grp_add($grp, $req);
 // Pode-se adicionar mais solicitações...
}

// Cria um grupo de solicitações
$grp = eio_grp("my_grp_done", "my_grp_data");

// Cria a solicitação eio_symlink e adiciona-a ao grupo
// Passa $filename para o retorno de chamada
$req = eio_symlink($filename, $link,
  EIO_PRI_DEFAULT, "my_symlink_done", $filename);
eio_grp_add($grp, $req);

// Processa solicitações
eio_event_loop();
?>

Grupo é um tipo especial de solicitação que pode acumular um conjunto de solicitações eio regulares. Isso poderia ser usado para criar uma solicitação complexa que abre, lê e fecha um arquivo.

Desde a versão 0.3.0 alpha, uma variável usada internamente nas comunicações com o l ibeio, poderia ser recuperada com eio_get_event_stream(). A variável poderia ser usada p ara vincular a um loop de eventos suportado por alguma outra extensão. Pode-se organizar um loop de eventos simples onde eio e libevent trabalhem juntos:

Exemplo #4 Usando eio com libevent

<?php
function my_eio_poll($fd, $events, $arg) {
    /* Algum regulamento do libevent pode estar aqui.. */
    if (eio_nreqs()) {
        eio_poll();
    }
    /* .. e aqui */
}

function my_res_cb($d, $r) {
    var_dump($r); var_dump($d);
}

$base = event_base_new();
$event = event_new();

// Este fluxo é usado para vincular com libevent
$fd = eio_get_event_stream();

eio_nop(EIO_PRI_DEFAULT, "my_res_cb", "nop data");
eio_mkdir("/tmp/abc-eio-temp", 0750, EIO_PRI_DEFAULT, "my_res_cb", "mkdir data");
/* algumas outras chamadas eio_* aqui... */


// define opções de evento
event_set($event, $fd, EV_READ /*| EV_PERSIST*/, "my_eio_poll", array($event, $base));

// define a base de eventos
event_base_set($event, $base);

// habilita evento
event_add($event);

// inicia loop de eventos
event_base_loop($base);

/* O mesmo estará disponível através da interface libevent em buffer */
?>

Instalação/Configuração
Constantes predefinidas
Exemplos
Funções de Eio
- eio_busy — Aumenta artificialmente a carga. Pode ser útil em testes, benchmarking
- eio_cancel — Cancela uma requisição
- eio_chmod — Altera permissões de arquivo/diretório
- eio_chown — Altera permissões de arquivo/diretório
- eio_close — Fecha arquivo
- eio_custom — Executa requisição personalizada como qualquer outra chamada eio_*
- eio_dup2 — Duplica um descritor de arquivo
- eio_event_loop — Consulta a libeio até que todas as requisições tenham concluído
- eio_fallocate — Permite ao chamador manipular diretamente o espaço alocado em disco para um arquivo
- eio_fchmod — Altera permissões de arquivo
- eio_fchown — Altera proprietário de arquivo
- eio_fdatasync — Sincroniza o estado central de um arquivo com o dispositivo de armazenamento
- eio_fstat — Obtém status de arquivo
- eio_fstatvfs — Obtém estatísticas de sistema de um arquivo
- eio_fsync — Sincroniza o estado central de um arquivo com o dispositivo de armazenamento
- eio_ftruncate — Trunca um arquivo
- eio_futime — Altera o horário de último acesso e última modificação de um arquivo
- eio_get_event_stream — Obtém fluxo representando uma variável usada em comunicações internas com libeio
- eio_get_last_error — Retorna uma string que descreve o último erro associado a um recurso de requisição
- eio_grp — Cria um grupo de requisições
- eio_grp_add — Adiciona uma requisição ao grupo de requisições
- eio_grp_cancel — Cancela um grupo de requisições
- eio_grp_limit — Define limite de grupo
- eio_init — (Re-)inicializa a Eio
- eio_link — Cria uma ligação física para um arquivo
- eio_lstat — Obtém status de arquivo
- eio_mkdir — Cria diretório
- eio_mknod — Cria arquivo normal ou especial
- eio_nop — Não faz nada, exceto passar por todo o ciclo de requisição
- eio_npending — Retorna o número de requisições concluídas, mas não tratadas
- eio_nready — Retorna o número de requisições ainda não tratadas
- eio_nreqs — Retorna o número de requisições a serem processadas
- eio_nthreads — Retorna o número de threads em uso
- eio_open — Abre um arquivo
- eio_poll — Pode ser chamada sempre que houver solicitações pendentes que precisem ser finalizadas
- eio_read — Lê um descritor de arquivo em determinada posição
- eio_readahead — Execute a leitura antecipada do arquivo no cache da página
- eio_readdir — Lê um diretório inteiro
- eio_readlink — Lê o valor de uma ligação simbólica
- eio_realpath — Obtém o caminho absoluto canônico
- eio_rename — Altera o nome ou localização de um arquivo
- eio_rmdir — Remove um diretório
- eio_seek — Aponta para uma posição
- eio_sendfile — Transfere dados entre descritores de arquivo
- eio_set_max_idle — Define o número máximo de threads ociosas
- eio_set_max_parallel — Define número máximo de threads paralelas
- eio_set_max_poll_reqs — Define número máximo de requisições processadas em uma consulta
- eio_set_max_poll_time — Define o tempo máximo de consulta
- eio_set_min_parallel — Define número mínimo de threads paralelas
- eio_stat — Obtém status de arquivo
- eio_statvfs — Obtém estatísticas do sistema de arquivos
- eio_symlink — Cria uma ligação simbólica
- eio_sync — Envia o cache em buffer para o disco
- eio_sync_file_range — Sincroniza um segmento de arquivo com o disco
- eio_syncfs — Faz a chamada de sistema syncfs do Linux, se disponível
- eio_truncate — Trunca um arquivo
- eio_unlink — Remove um nome e possivelmente o arquivo ao qual ele se refere
- eio_utime — Altera os horários de último acesso e de modificação de um arquivo
- eio_write — Escreve em um arquivo