<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/refs.fileprocess.process.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'book.pthreads.php',
    1 => 'pthreads',
    2 => 'pthreads',
  ),
  'up' => 
  array (
    0 => 'refs.fileprocess.process.php',
    1 => 'Модули управления процессами программ',
  ),
  'prev' => 
  array (
    0 => 'parallel-sync.invoke.php',
    1 => 'parallel\\Sync::__invoke',
  ),
  'next' => 
  array (
    0 => 'pthreads.setup.php',
    1 => 'Установка и настройка',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/pthreads/book.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/book.pthreads.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="book.pthreads" class="book">
 
 <h1 class="title">pthreads</h1>
 

 <div id="intro.pthreads" class="preface">
  <h1 class="title">Введение</h1>
  <p class="simpara">
   pthreads предоставляет объектно-ориентированный API для работы с многопоточностью в PHP.
   Приложения на PHP могут создавать, читать, записывать, запускать и выполнять синхронизацию с объектами Threads, Workers и Threaded.
  </p>
  <div class="warning"><strong class="warning">Внимание</strong>
   <p class="simpara">
    Модуль считается неподдерживаемым и мёртвым.
   </p>
  </div>
  <div class="tip"><strong class="tip">Подсказка</strong>
   <p class="simpara">
    Попробуйте вместо этого использовать <a href="book.parallel.php" class="link">parallel</a>.
     </p>
  </div>
  <div class="warning"><strong class="warning">Внимание</strong>
   <p class="simpara">
    Модуль доступен только для CLI-приложений.
    Исходя из этого, многопоточность в PHP в окружении веб-сервера недоступна.
   </p>
  </div>
  <div class="warning"><strong class="warning">Внимание</strong>
   <p class="simpara">
    pthreads (v3) может использоваться только с PHP 7.2 и выше, так как ZTS-режим нестабилен в 7.0 и 7.1.
   </p>
  </div>
  <p class="simpara">
   Класс <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span> предоставляет базовый
   функционал, необходимый для работы pthreads. Он предоставляет
   методы синхронизации и некоторые полезные для разработчика
   интерфейсы.
  </p>
  <p class="simpara">
   Класс <span class="classname"><a href="class.thread.php" class="classname">Thread</a></span> позволяет создавать потоки.
   Для создания потока необходимо создать наследующие его класс и
   в нём реализовать метод <code class="literal">run</code>.
   Любые свойства могут быть записаны и прочитаны из любого контекста
   через ссылку на поток. Также из любого контекста
   могут быть вызваны публичные и защищённые методы. Метод run будет
   запущен в отдельном потоке, как только будет вызван
   метод <span class="methodname"><a href="thread.start.php" class="methodname">Thread::start()</a></span> из контекста, в котором он
   был создан. Стартовать и присоединить поток можно только в том контексте,
   где он был создан.
  </p>
  <p class="simpara">
   Класс <span class="classname"><a href="class.worker.php" class="classname">Worker</a></span> имеет постоянное состояние и
   будет доступен из метода <span class="methodname"><a href="thread.start.php" class="methodname">Thread::start()</a></span>
   (унаследованный метод) до тех пор, пока объект не выйдет из
   области видимости, либо пока не будет принудительно остановлен
   (с помощью <span class="methodname"><a href="worker.shutdown.php" class="methodname">Worker::shutdown()</a></span>).
   Любой контекст имеющий ссылку к данному объекту может добавлять
   задания на стек Worker (с помощью
   <span class="methodname"><a href="worker.stack.php" class="methodname">Worker::stack()</a></span>), которые будут запущены
   в отдельном потоке. Метод <code class="literal">run</code> объекта Worker
   будет запущен раньше, чем любой объект с его стека задач, что
   даёт возможность инициализировать необходимые для задачи
   ресурсы.
  </p>
  <p class="simpara">
   Класс <span class="classname"><a href="class.pool.php" class="classname">Pool</a></span> используется для создания группы
   исполнителей (worker) для распределения между ними объектов
   <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span>. Это самый простой и эффективный
   вариант использования многопоточности в PHP.
  </p>
  <div class="caution"><strong class="caution">Предостережение</strong>
   <p class="simpara">
    Класс <span class="classname"><a href="class.pool.php" class="classname">Pool</a></span> не наследует
    <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span>, таким образом являясь обычным
    объектом PHP. Объекты этого класса не должны разделяться по различным
    контекстам.
   </p>
  </div>
  <p class="simpara">
   Класс <span class="classname"><a href="class.volatile.php" class="classname">Volatile</a></span> добавлен в pthreads v3. Он
   используется для задания изменяемых
   <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span>-свойств классов типа
   <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span> (так как теперь они по умолчанию
   неизменяемы). Также используется для хранения массивов PHP
   в контексте <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span>.
  </p>
  <p class="simpara">
   Синхронизация - важная часть многопоточности. Все объекты,
   созданные pthreads, имеют встроенные методы для обеспечения
   синхронизации (они покажутся очень знакомыми для разработчиков
   на Java): <span class="methodname"><a href="threaded.wait.php" class="methodname">Threaded::wait()</a></span> и
   <span class="methodname"><a href="threaded.notify.php" class="methodname">Threaded::notify()</a></span>. Вызов
   <span class="methodname"><a href="threaded.wait.php" class="methodname">Threaded::wait()</a></span> переведёт объект в
   ожидание до того момента, пока из другого контекста не будет вызван
   <span class="methodname"><a href="threaded.notify.php" class="methodname">Threaded::notify()</a></span> для ожидающего объекта.
   Этот механизм позволяет осуществлять синхронизацию между
   объектами <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span>.
  </p>
  <div class="caution"><strong class="caution">Предостережение</strong>
   <p class="simpara">
    Любые объекты вашего приложения, которые предполагается использовать
    в многопоточном режиме, должны наследовать
    <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span>.
   </p>
  </div>
  <p class="simpara">
   Хранение данных:
   Как правило, в объекте Threaded можно использовать любые данные,
   которые могут быть сериализованы. Они могут быть записаны и прочтены из
   любого контекста через ссылку на этот объект.
   Не каждый тип данных хранится в сериализованном виде. Базовые типы
   хранятся в их истинной форме. Сложные типы, массивы и объекты , не
   являющиеся Threaded, хранятся сериализованными; они могут быть
   прочитаны или записаны в Threaded-объект из любого контекста  по
   ссылке.
   За исключением Threaded-объектов, все ссылки, использующиеся
   для установки свойства в Threaded-объекте отделены от ссылок внутри
   Threaded-объекте. Чтение тех же данных можно производить напрямую
   из любого контекста по ссылке на Threaded-объекте.
  </p>
  <p class="simpara">
   Статические свойства:
   Когда создаётся новый контекст (Thread или Worker), они просто копируются,
   но ресурсы и объекты обнуляются (из соображения безопасности). Это
   позволяет использовать их как локальные для потока хранилища. К примеру,
   во время создания контекста, для класса, статические свойства которого хранят
   информацию о соединении к БД и само соединение, будет скопирована только
   информация необходимая для соединения, но не само соединение. Это
   позволит создать новое соединение в новом контексте и сохранить его
   в том же месте никак не затрагивая оригинальный контекст.
  </p>
  <div class="caution"><strong class="caution">Предостережение</strong>
   <p class="simpara">
    Когда запускаются print_r, var_dump или другие отладочные функции,
    они не включают защиту от рекурсии.
   </p>
  </div>
  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <span class="simpara">
    Ресурсы:
    Модули и функциональность PHP, создающие ресурсы, совершенно не
    подготовлены для такого типа окружения; pthreads предоставляет
    механизм разделения ресурсов между контекстами, однако
    для большинства типов ресурсов его следует считать небезопасным.
    Разделяя ресурс между контекстами необходимо быть крайне внимательным
    и осторожным.
   </span>
  </p></blockquote>
  <div class="caution"><strong class="caution">Предостережение</strong>
   <p class="simpara">
    В окружении, где запускается pthreads, необходимы некоторые ограничения
    и запреты для обеспечения стабильности.
   </p>
  </div>
 </div>

 





 





 





 





 





 





 





 






<ul class="chunklist chunklist_book"><li><a href="pthreads.setup.php">Установка и настройка</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="pthreads.requirements.php">Требования</a></li><li><a href="pthreads.installation.php">Установка</a></li></ul></li><li><a href="pthreads.constants.php">Предопределённые константы</a></li><li><a href="class.threaded.php">Threaded</a> — Класс Threaded<ul class="chunklist chunklist_book chunklist_children"><li><a href="threaded.chunk.php">Threaded::chunk</a> — Обработка</li><li><a href="threaded.count.php">Threaded::count</a> — Обработка</li><li><a href="threaded.extend.php">Threaded::extend</a> — Обработка во время выполнения</li><li><a href="thread.isrunning.php">Threaded::isRunning</a> — Определяет состояние</li><li><a href="threaded.isterminated.php">Threaded::isTerminated</a> — Определение состояния</li><li><a href="threaded.merge.php">Threaded::merge</a> — Обработка</li><li><a href="threaded.notify.php">Threaded::notify</a> — Синхронизация</li><li><a href="threaded.notifyone.php">Threaded::notifyOne</a> — Синхронизация</li><li><a href="threaded.pop.php">Threaded::pop</a> — Обработка</li><li><a href="threaded.run.php">Threaded::run</a> — Выполнение</li><li><a href="threaded.shift.php">Threaded::shift</a> — Обработка</li><li><a href="threaded.synchronized.php">Threaded::synchronized</a> — Синхронизация</li><li><a href="threaded.wait.php">Threaded::wait</a> — Синхронизация</li></ul></li><li><a href="class.thread.php">Thread</a> — Класс Thread<ul class="chunklist chunklist_book chunklist_children"><li><a href="thread.getcreatorid.php">Thread::getCreatorId</a> — Идентификация</li><li><a href="thread.getcurrentthread.php">Thread::getCurrentThread</a> — Идентификация</li><li><a href="thread.getcurrentthreadid.php">Thread::getCurrentThreadId</a> — Идентификация</li><li><a href="thread.getthreadid.php">Thread::getThreadId</a> — Идентификация</li><li><a href="thread.isjoined.php">Thread::isJoined</a> — Определение состояния</li><li><a href="thread.isstarted.php">Thread::isStarted</a> — Определение состояния</li><li><a href="thread.join.php">Thread::join</a> — Синхронизация</li><li><a href="thread.start.php">Thread::start</a> — Выполнение</li></ul></li><li><a href="class.worker.php">Worker</a> — Класс Worker<ul class="chunklist chunklist_book chunklist_children"><li><a href="worker.collect.php">Worker::collect</a> — Собрать ссылки на завершённые задачи</li><li><a href="worker.getstacked.php">Worker::getStacked</a> — Возвращает текущий размер стека</li><li><a href="worker.isshutdown.php">Worker::isShutdown</a> — Определение состояния</li><li><a href="worker.shutdown.php">Worker::shutdown</a> — Остановить Worker</li><li><a href="worker.stack.php">Worker::stack</a> — Положить задачу на стек</li><li><a href="worker.unstack.php">Worker::unstack</a> — Убирает задачу из стека</li></ul></li><li><a href="class.collectable.php">Collectable</a> — Интерфейс Collectable<ul class="chunklist chunklist_book chunklist_children"><li><a href="collectable.isgarbage.php">Collectable::isGarbage</a> — Определяет, помечен ли объект как мусор</li></ul></li><li><a href="class.pool.php">Pool</a> — Класс Pool<ul class="chunklist chunklist_book chunklist_children"><li><a href="pool.collect.php">Pool::collect</a> — Собирает ссылки на выполненные задания</li><li><a href="pool.construct.php">Pool::__construct</a> — Создаёт новый пул воркеров</li><li><a href="pool.resize.php">Pool::resize</a> — Изменяет размер пула</li><li><a href="pool.shutdown.php">Pool::shutdown</a> — Выключает все воркеры</li><li><a href="pool.submit.php">Pool::submit</a> — Отправляет объект на исполнение</li><li><a href="pool.submitTo.php">Pool::submitTo</a> — Отправляет задачу конкретному воркеру для выполнения</li></ul></li><li><a href="class.volatile.php">Volatile</a> — Класс Volatile</li></ul></div><?php manual_footer($setup); ?>