Ejecución

Un parallel\Runtime representa un hilo de intérprete PHP. Un parallel\Runtime se configura con un fichero de arranque opcional pasado a parallel\Runtime::__construct(), generalmente un cargador automático, o alguna otra rutina de precarga: el fichero de arranque será incluido antes de la ejecución de cualquier tarea.

Después de la construcción, el parallel\Runtime permanece disponible hasta que se cierre, se mate, o se destruya por las reglas de ámbito normales de los objetos PHP. parallel\Runtime::run() permite al desarrollador programar tareas para una ejecución paralela. Un parallel\Runtime tiene un orden de programación FIFO, las tareas se ejecutarán en el orden en que se programen.

API Funcional

Parallel implementa una API funcional, de alto nivel sobre parallel\Runtime que proporciona un único punto de entrada para ejecutar código paralelo con una programación automática: parallel\run().

Tareas

Una tarea (Task) es simplemente una Closure destinada a una ejecución paralela. La Closure puede contener casi cualquier instrucción, incluyendo cierres anidados. Sin embargo, algunas instrucciones están prohibidas en las tareas:

• yield
• use by-reference
• declare class
• declare named function

Nota: Los cierres anidados pueden usar yield o use by-reference, pero no deben contener declaraciones de clase o funciones nombradas.

Nota: Ninguna instrucción está prohibida en los ficheros que la tarea puede incluir.

Future

El parallel\Future se utiliza para acceder al valor de retorno de la tarea, y expone una API para la cancelación de la tarea.

Canales

Una tarea puede ser programada con argumentos, usar variables de ámbito léxico (por valor), y devolver un valor (a través de un parallel\Future), pero estos solo permiten la comunicación unidireccional: Permiten al desarrollador enviar datos a una tarea y recuperar datos de una tarea, pero no permiten la comunicación bidireccional entre las tareas. La API parallel\Channel permite la comunicación bidireccional entre las tareas, un parallel\Channel es un enlace de tipo socket entre las tareas que el desarrollador puede usar para enviar y recibir datos.

Eventos

La API parallel\Events implementa un bucle de eventos (Traversable) nativo, y el método parallel\Events::poll(). Esto permite al desarrollador trabajar con conjuntos de canales y/o futuros. El desarrollador simplemente añade canales y futuros al bucle de eventos, definiendo opcionalmente la entrada para las escrituras con parallel\Events::setInput(), y entra en un bucle foreach: parallel leerá y escribirá en los objetos a medida que se vuelvan disponibles, devolviendo objetos parallel\Events\Event describiendo las operaciones que han ocurrido.

Ver también

• Filosofía