Introducción
pthreads es una API orientada a objetos que aporta todas las herramientas necesarias para
el multithreading en PHP.
Las aplicaciones PHP pueden crear, leer, escribir, ejecutar
y sincronizar Threads, Workers, y objetos Threaded.
Advertencia
Esta extensión es considerada no mantenida y obsoleta.
Sugerencia
Considerar el uso de parallel en su lugar.
Advertencia
La extensión pthreads no puede ser utilizada en un entorno de
servidor Web. El threading en PHP se limita por tanto a aplicaciones basadas
en CLI únicamente.
Advertencia
pthreads (v3) puede ser utilizado únicamente con PHP 7.2+ debido a un
modo ZTS peligroso en PHP 7.0 y 7.1.
La clase Threaded constituye la base de la
funcionalidad que permite a pthreads funcionar. Expone los métodos
de sincronización y algunas interfaces útiles para el programador.
La clase Thread permite crear threads extendiéndola simplemente e
implementando un método run
. Todos los miembros pueden ser escritos y leídos
por cualquier contexto con una referencia al thread. Todo contexto puede igualmente ejecutar
todos los métodos públicos y protegidos. El cuerpo del método run será ejecutado
en un thread separado cuando el método Thread::start()
de la implementación sea llamado desde el contexto que lo creó. Solo el
contexto que crea un thread puede iniciarlo y unirse a él.
La clase Worker tiene un estado persistente y estará
disponible desde la llamada a Thread::start() (un método heredado)
hasta que el objeto esté fuera de alcance, o sea explícitamente detenido (vía
Worker::shutdown()). Todo contexto con una referencia al objeto Worker
puede apilar tareas en el Worker (vía Worker::stack()), donde estas
tareas serán ejecutadas por el Worker en un thread separado. El método
run
de un objeto worker es ejecutado antes de cualquier objeto de la pila del worker,
lo que permite que los recursos sean inicializados para que los objetos a ejecutar puedan usarlos.
La clase Pool se utiliza para crear un grupo de
workers para distribuir objetos Threaded entre ellos.
Es el medio más fácil y eficiente de utilizar múltiples threads en aplicaciones PHP.
Precaución
La clase Pool no extiende la clase
Threaded, y por tanto los objetos basados en pool son
considerados como objetos PHP normales. En consecuencia, sus instancias no
deben ser compartidas entre contextos diferentes.
La clase Volatile es nueva para pthreads v3.
Se utiliza para designar las propiedades Threaded mutables
de las clases Threaded (ya que estas son ahora inmutables por defecto).
También se utiliza para almacenar arrays PHP en contextos Threaded.
La sincronización es una capacidad importante al realizar threading. Todos los
objetos creados por pthreads han sido construidos con sincronización en la forma
(que será familiar a los programadores Java) de
Threaded::wait() y
Threaded::notify(). La llamada a
Threaded::wait() sobre un objeto hará que el contexto
espere a que otro contexto llame a
Threaded::notify() sobre el mismo objeto. Este mecanismo
permite una sincronización poderosa entre los objetos
Threaded en PHP.
Precaución
Todo objeto previsto para ser utilizado en una parte multithread de la aplicación
debe extender Threaded.
Almacenamiento de datos: En regla general, todos los tipos de datos que puedan ser serializados pueden
ser utilizados como miembro de un objeto Threaded, pueden ser leídos y escritos desde cualquier
contexto con una referencia al objeto Threaded. No todos los tipos de datos son almacenados
después de la serialización; los tipos simples son almacenados en su forma inicial. Los tipos
complejos, los arrays y los objetos que no son Threaded, son almacenados serializados; pueden ser
leídos y escritos en el objeto Threaded desde cualquier contexto con una referencia.
A excepción de los objetos Threaded, toda referencia utilizada para definir un miembro de un objeto
Threaded es separada de la referencia en el objeto Threaded; los mismos datos pueden ser leídos
directamente desde el objeto Threaded en cualquier momento por cualquier contexto con una referencia
al objeto Threaded.
Miembros estáticos: Cuando un nuevo contexto es creado (Thread o Worker),
generalmente son copiados, pero los recursos y objetos con estado interno son nullificados
(por razones de seguridad). Esto permite a la función una especie de almacenamiento local
a nivel de thread. Por ejemplo, al iniciar el contexto, una clase cuyos miembros estáticos
incluyen información de conexión a un servidor de base de datos, solo la información
será copiada, y no la conexión en sí. Esto permite al nuevo contexto inicializar
una conexión de la misma forma que el contexto que lo creó, almacenando la conexión
en el mismo lugar sin afectar al contexto original.
Precaución
Cuando print_r, var_dump y otras funciones de depuración son ejecutadas, no incluyen
protección contra la recursión.
Nota:
Recursos: Las extensiones y funcionalidades que definen recursos en PHP no están preparadas
para este tipo de entorno; pthreads toma disposiciones en materia de recursos a compartir entre
los contextos, sin embargo, para la mayoría de los recursos, deberán ser considerados como peligrosos.
Un cuidado y una extrema precaución deberán ser de aplicación para compartir recursos entre los contextos.
Precaución
En el entorno de ejecución de pthreads, restricciones y limitaciones son necesarias para
proporcionar un entorno estable.