archived-doc-ru/reference/gearman/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->

<appendix xml:id="gearman.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.constants;
 &extension.constants;
 <para>
  Возвращаемые значения. Всегда проверяйте значение
  <methodname>GearmanClient::error</methodname> или
  <methodname>GearmanWorker</methodname>, содержащее строку с описанием ошибки, так
  как в этой строке может содержаться более детальная информация о последней
  операции:
 </para>
 <para>
  <variablelist>
   <varlistentry xml:id="constant.gearman-success">
    <term>
     <constant>GEARMAN_SUCCESS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Операция была завершена успешно.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-io-wait">
    <term>
     <constant>GEARMAN_IO_WAIT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      В режиме без блокировок событие ожидает установку блокировки.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-errno">
    <term>
     <constant>GEARMAN_ERRNO</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Системная ошибка. Чтобы получить код ошибки, воспользуйтесь функцией
      <methodname>GearmanClient::errno</methodname> или
      <methodname>GearmanWorker::errno</methodname>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-no-active-fds">
    <term>
     <constant>GEARMAN_NO_ACTIVE_FDS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      На момент вызова <methodname>GearmanClient::wait</methodname> или
      <methodname>GearmanWorker</methodname> не было активных подключений.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-unexpected-packet">
    <term>
     <constant>GEARMAN_UNEXPECTED_PACKET</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Означает, что что-то пошло совсем не так, как должно было. Применимо только
      к <classname>GearmanWorker</classname>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-getaddrinfo">
    <term>
     <constant>GEARMAN_GETADDRINFO</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Неудачная операция разрешения имён DNS (неверный порт, хост и т.п.).
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-no-servers">
    <term>
     <constant>GEARMAN_NO_SERVERS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Перед отправкой задания или задачи не был вызван метод
      <methodname>GearmanClient::addServer</methodname>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-lost-connection">
    <term>
     <constant>GEARMAN_LOST_CONNECTION</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Во время обработки запроса прервалось соединение.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-memory-allocation-failure">
    <term>
     <constant>GEARMAN_MEMORY_ALLOCATION_FAILURE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Не удалось выделить память (недостаточно памяти).
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-server-error">
    <term>
     <constant>GEARMAN_SERVER_ERROR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      На сервере Gearman произошёл сбой, и сервер не смог обработать запрос.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-work-data">
    <term>
     <constant>GEARMAN_WORK_DATA</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Код возврата уведомления, который можно получить методом
      <methodname>GearmanClient::returnCode</methodname> во время работы
      <methodname>GearmanClient::do</methodname>. Выполняющий задание обработчик
      (worker) посылает этот код, когда ему требуется обновить данные на клиенте,
      передать часть результатов работы или сбросить данные во время
      выполнения долгих заданий.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-work-warning">
    <term>
     <constant>GEARMAN_WORK_WARNING</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Код возврата уведомления, который можно получить методом
      <methodname>GearmanClient::returnCode</methodname> во время работы
      <methodname>GearmanClient::do</methodname>. Обновляет клиент с отправкой
      предупреждением. Поведение те же, что и в случае
      <constant>GEARMAN_WORK_DATA</constant>, однако
      этот код следует интерпретировать как предупреждение вместо обычных данных
      ответа.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-work-status">
    <term>
     <constant>GEARMAN_WORK_STATUS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Код возврата уведомления, который можно получить методом
      <methodname>GearmanClient::returnCode</methodname> во время работы
      <methodname>GearmanClient::do</methodname>. Обработчик задания посылает
      этот код, чтобы обновить статус долго выполняемого задания. Используйте
      <methodname>GearmanClient::doStatus</methodname> для получения
      процента завершения работы.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-work-exception">
    <term>
     <constant>GEARMAN_WORK_EXCEPTION</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Код возврата уведомления, который можно получить методом
      <methodname>GearmanClient::returnCode</methodname> во время работы
      <methodname>GearmanClient::do</methodname>. Указывает, что выполнение
      задания завершилось неудачей с заданным исключением.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-work-fail">
    <term>
     <constant>GEARMAN_WORK_FAIL</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Код возврата уведомления, который можно получить методом
      <methodname>GearmanClient::returnCode</methodname> во время работы
      <methodname>GearmanClient::do</methodname>. Указывает, что задание выполнить
      не удалось.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-could-not-connect">
    <term>
     <constant>GEARMAN_COULD_NOT_CONNECT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Не удалось подключиться к серверу.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-invalid-function-name">
    <term>
     <constant>GEARMAN_INVALID_FUNCTION_NAME</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Это значение возвращается при попытке зарегистрировать NULL в качестве имени
      функции или при использовании callback-интерфейса без указания
      callback-функций.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-invalid-worker-function">
    <term>
     <constant>GEARMAN_INVALID_WORKER_FUNCTION</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Попытка зарегистрировать в обработчике функцию, передавая NULL в качестве
      callback-функции.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-no-registered-functions">
    <term>
     <constant>GEARMAN_NO_REGISTERED_FUNCTIONS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Когда обработчик получил задание для функции, которая
      в нем не зарегистрирована.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-no-jobs">
    <term>
     <constant>GEARMAN_NO_JOBS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Для неблокирующего обработчика, когда
      <methodname>GearmanWorker::work</methodname> не имеет активных заданий.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-echo-data-corruption">
    <term>
     <constant>GEARMAN_ECHO_DATA_CORRUPTION</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Указывает, что после вызова <methodname>GearmanClient::echo</methodname>
      или <methodname>GearmanWorker::echo</methodname> возвращённые данные не
      соответствуют переданным.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-need-workload-fn">
    <term>
     <constant>GEARMAN_NEED_WORKLOAD_FN</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Когда клиент выбрал потоковый режим передачи данных для обработки,
      но не задал callback-функцию для обработки данных из этого потока.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-pause">
    <term>
     <constant>GEARMAN_PAUSE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      При работе в неблокирующем режиме, это значение может вернуть
      callback-функция, чтобы приостановить обработку задания и выйти из метода
      <methodname>GearmanClient::runTasks</methodname>. Чтобы продолжить работу,
      следует ещё раз вызвать метод
      <methodname>GearmanClient::runTasks</methodname>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-unknown-state">
    <term>
     <constant>GEARMAN_UNKNOWN_STATE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Внутренняя ошибка клиента/обработчика.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-send-buffer-too-small">
    <term>
     <constant>GEARMAN_SEND_BUFFER_TOO_SMALL</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Внутренняя ошибка: попытка передать больше данных, чем помещается в один
      чанк. Размеры буфера жёстко заданы и не подлежат изменению.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-timeout">
    <term>
     <constant>GEARMAN_TIMEOUT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Превышено время ожидания, заданный клиентом/обработчиком.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>

 <para>
  Настройки <classname>GearmanClient</classname>:
 </para>
 <para>
  <variablelist>
   <varlistentry xml:id="constant.gearman-client-generate-unique">
    <term>
     <constant>GEARMAN_CLIENT_GENERATE_UNIQUE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Создавать уникальный идентификатор (UUID) для каждой задачи.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-client-non-blocking">
    <term>
     <constant>GEARMAN_CLIENT_NON_BLOCKING</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Запускать клиента в неблокирующем режиме.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-client-unbuffered-result">
    <term>
     <constant>GEARMAN_CLIENT_UNBUFFERED_RESULT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Позволять клиенту читать данные и посылать их обратно в чанках вместо
      буферизации данных целиком средствами библиотеки.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-client-free-tasks">
    <term>
     <constant>GEARMAN_CLIENT_FREE_TASKS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Автоматически уничтожать объекты задач после их выполнения. Эта настройка
      используется по умолчанию, чтобы предотвратить утечки памяти.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>

 <para>
  Настройки <classname>GearmanWorker</classname>:
 </para>
 <para>
  <variablelist>
   <varlistentry xml:id="constant.gearman-worker-non-blocking">
    <term>
     <constant>GEARMAN_WORKER_NON_BLOCKING</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Запускать обработчик заданий в неблокирующем режиме.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-worker-grab-uniq">
    <term>
     <constant>GEARMAN_WORKER_GRAB_UNIQ</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      Возвращать клиенту уникальный идентификатор в дополнение к дескриптору задания.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>

 <para>
  Базовая конфигурация Gearman:
 </para>
 <para>
  <variablelist>
   <varlistentry xml:id="constant.gearman-default-tcp-host">
    <term>
     <constant>GEARMAN_DEFAULT_TCP_HOST</constant>
     (<type>string</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-default-tcp-port">
    <term>
     <constant>GEARMAN_DEFAULT_TCP_PORT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-default-socket-timeout">
    <term>
     <constant>GEARMAN_DEFAULT_SOCKET_TIMEOUT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-default-socket-send-size">
    <term>
     <constant>GEARMAN_DEFAULT_SOCKET_SEND_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-default-socket-recv-size">
    <term>
     <constant>GEARMAN_DEFAULT_SOCKET_RECV_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-max-error-size">
    <term>
     <constant>GEARMAN_MAX_ERROR_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-packet-header-size">
    <term>
     <constant>GEARMAN_PACKET_HEADER_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-job-handle-size">
    <term>
     <constant>GEARMAN_JOB_HANDLE_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-option-size">
    <term>
     <constant>GEARMAN_OPTION_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-unique-size">
    <term>
     <constant>GEARMAN_UNIQUE_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-max-command-args">
    <term>
     <constant>GEARMAN_MAX_COMMAND_ARGS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-args-buffer-size">
    <term>
     <constant>GEARMAN_ARGS_BUFFER_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-send-buffer-size">
    <term>
     <constant>GEARMAN_SEND_BUFFER_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-recv-buffer-size">
    <term>
     <constant>GEARMAN_RECV_BUFFER_SIZE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gearman-worker-wait-timeout">
    <term>
     <constant>GEARMAN_WORKER_WAIT_TIMEOUT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->