Eio

Introducción

Esta extensión proporciona E/S POSIX asíncrona a través de la biblioteca de C » libeio escrita por Marc Lehmann.

Nota: Esta extensión no está disponible en las plataformas Windows.

Advertencia

Es importante tener en cuenta que cada solicitud se ejecuta en un hilo, y el orden de ejecución continua de peticiones en cola es basicamente impredecible. Por ejemplo, el siguiente trozo de código es incorrecto.

Ejemplo #1 Peticiones incorrectas

<?php
// Petición para crear un enlace simbólico de $nombre_archivo a $enlace
eio_symlink($nombre_archivo, $enlace);

// Petición para mover $nombre_archivo a $nuevo_nombre_archivo
eio_rename($nombre_archivo, $nuevo_nombre_archivo);

// Procesar las peticiones
eio_event_loop();
?>

En el ejemplo de arriba la petición eio_rename() puede finalizar antes que eio_symlink(). Para corregirlo se podría llamar a eio_rename() en la llamada de retorno de eio_symlink():

Ejemplo #2 Llamar a una petición desde una llamada de retorno de petición

<?php
function mi_enlace_simbólico_hecho($nombre_archivo, $resultado) {
 // Petición para mover $nombre_archivo a $nuevo_nombre_archivo
 eio_rename($nombre_archivo, "/ruta/a/nuevo-nombre");

 // Procesar las peticiones
 eio_event_loop();
}

// Petición para crear un enlace simbólico de $nombre_archivo a $enlace
eio_symlink($nombre_archivo, $enlace, EIO_PRI_DEFAULT, "mi_enlace_simbólico_hecho", $nombre_archivo);

 // Procesar las peticiones
eio_event_loop();
?>

Alternativamente, podría querer crear un grupo de peticiones:

Ejemplo #3 Llamar a una petición desde una llamada de retorno de petición

<?php
/* Se llama cuando el grupo de peticiones está hecho */
function mi_grupo_hecho($data, $resultado) {
 // ...
}

function mi_enlace_simbólico_hecho($nombre_archivo, $resultado) {
 // Crear una petición eio_rename y añadirla al grupo
 $petición = eio_rename($nombre_archivo, "/ruta/a/nuevo-nombre");
 eio_grp_add($grupo, $petición);
 // Podría querer añadir más peticiones...
}

// Crear un grupo de peticiones
$grupo = eio_grp("mi_grupo_hecho", "mis_datos_de_grupo");

// Crear una petición eio_symlink y añadirla al grupo
// Pasar $nombre_archivo a la llamada de retorno
$petición = eio_symlink($nombre_archivo, $enlace,
  EIO_PRI_DEFAULT, "mi_enlace_simbólico_hecho", $nombre_archivo);
eio_grp_add($grupo, $petición);

 // Procesar las peticiones
eio_event_loop();
?>

El grupo es un tipo especial de peticion que podría acumular un conjunto de peticiones eio regulares. Se podría usar para crear una petición compleja para abrir, leer y cerrar un fichero.

Desde la versión 0.3.0 alfa, una variable usada internamete en las comunicaciones con libeio, podía ser recuperada con eio_get_event_stream(). La variable se podría usar para vincularse a un bucle de eventos soportado por alguna otra extensión. Se podría organizar un sencillo bucle de eventos donde eio y libevent trabajaran juntos:

Ejemplo #4 Usar eio con libevent

<?php
function mi_eio_poll($df, $eventos, $argumentos) {
    /* Algunas regulaciones de libevent podrían ir aquí .. */
    if (eio_nreqs()) {
        eio_poll();
    }
    /* .. y aquí */
}

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

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

// Este flujo se usa para vincularse con libevent
$df = eio_get_event_stream();

eio_nop(EIO_PRI_DEFAULT, "mi_res_cb", "nop data");
eio_mkdir("/tmp/abc-eio-temp", 0750, EIO_PRI_DEFAULT, "mi_res_cb", "mkdir data");
/* algunas llamadas eio_* aquí ... */


// establecer las banderas del evento
event_set($evento, $df, EV_READ /*| EV_PERSIST*/, "mi_eio_poll", array($evento, $base));

// Establecer la base del evento
event_base_set($evento, $base);

// habilitar el evento
event_add($evento);

// iniciar el bucle de eventos
event_base_loop($base);

/* Lo mismo estará disponible mediante interfaz libevent con buffer */
?>

Instalación/Configuración
Constantes predefinidas
Ejemplos
Funciones Eio
- eio_busy — Incrementar artificialmente la carga. Podría ser útil en pruebas, evaluaciones comparativas
- eio_cancel — Cancelar una petición
- eio_chmod — Cambiar los permisos de fichero/directorio
- eio_chown — Cambiar los permisos de un fichero/directorio
- eio_close — Cerrar un fichero
- eio_custom — Ejecutar una petición personalizada como cualquier otra llamada eio_*
- eio_dup2 — Duplicar un descriptor de fichero
- eio_event_loop — Monitorizar libeio hasta que todas las peticiones sean procesadas
- eio_fallocate — Permitir al llamador manipular directamente el espacio de disco asignado a un fichero
- eio_fchmod — Cambiar los permisos de un fichero
- eio_fchown — Cambiar el propietario del fichero
- eio_fdatasync — Sincronizar el estado de ficheros que están en memoria con un dispositivo de almacenamiento
- eio_fstat — Obtener el estado de un fichero
- eio_fstatvfs — Obtener las estadísticas del sistema de ficheros
- eio_fsync — Sincronizar el estado de un fichero en memoria con un dispositivo de almacenamiento
- eio_ftruncate — Truncar un fichero
- eio_futime — Cambiar los momentos de último y acceso y modificación de un fichero
- eio_get_event_stream — Obtiene un flujo que representa una variable usada en comnunicaciones internas con libeio
- eio_get_last_error — Retorna un string describiendo el último error asociado con el recurso solicitado
- eio_grp — Crear un grupo de peticiones
- eio_grp_add — Añadir una petición al grupo de peticiones
- eio_grp_cancel — Cancelar un grupo de peticiones
- eio_grp_limit — Establecer el límite de un grupo
- eio_init — (Re-)inicializa Eio
- eio_link — Crear un enlace duro par un fichero
- eio_lstat — Obtener el estado de un fichero
- eio_mkdir — Crear un directorio
- eio_mknod — Crear un fichero especial u ordinario
- eio_nop — No hace nada, sólo recorre el ciclo de peticiones entero
- eio_npending — Devolver el número de peticiones, excepto las no manejadas
- eio_nready — Devolver el número de peticiones aún no tratadas
- eio_nreqs — Devuelve el número de peticiones a ser procesadas
- eio_nthreads — Devuelve el número de hilos actualmente en uso
- eio_open — Abre un fichero
- eio_poll — Puede ser llamada siempre que existan peticiones pendientes que necesitan ser finalizadas
- eio_read — Leer de un descriptor de fichero en un índice dado
- eio_readahead — Perform file readahead into page cache
- eio_readdir — Leer un directorio al completo
- eio_readlink — Leer el valor de un enlace simbólico
- eio_realpath — Obtener el nombre de ruta absoluto canonizado
- eio_rename — Cambiar el nombre o la ubicación de un fichero
- eio_rmdir — Eliminar un directorio
- eio_seek — Reposiciona el cursor de un fichero abierto
- eio_sendfile — Transferir información entre descriptores de ficheros
- eio_set_max_idle — Establecer el número máximo de hilos parados
- eio_set_max_parallel — Esteblecer el máximo de hilos paralelos
- eio_set_max_poll_reqs — Establecer el máximo número de peticiones procesadas en una monitorización
- eio_set_max_poll_time — Establecer el tiempo máximo de monitorización
- eio_set_min_parallel — Esteblecer el número de hilos paralelos mínimo
- eio_stat — Obtener el estado de un fichero
- eio_statvfs — Obtener las estadísticas del sistema de ficheros
- eio_symlink — Crear un enlace simbólico
- eio_sync — Consignar el caché de buffer cache al disco
- eio_sync_file_range — Sincornizar un segmento de fichero con el disco
- eio_syncfs — Realizar una llamada al sistema de syncfs de Linux si está disponible
- eio_truncate — Truncar un fichero
- eio_unlink — Borrar un nombre y posiblemente el fichero al que se refiere
- eio_utime — Cambiar los momentos de último y acceso y modificación de un fichero
- eio_write — Escribir en un fichero