Edit Report a Bug

    win32_start_service_ctrl_dispatcher

    (PECL win32service >=0.1.0)

    win32_start_service_ctrl_dispatcher — Добавляет в Диспетчер Служб скрипт, который может быть использован, как служба с заданным именем

    Описание

    win32_start_service_ctrl_dispatcher(string $name, bool $gracefulMode = true): void

    При запуске с помощью диспетчера служб, процессу службы необходимо сверяться с ним для мониторинга службы и связи с ней. Эта функция выполняет сверку посредством создания потока для обработки низкоуровневой связи с диспетчером служб.

    После запуска процесс службы должен осуществить два действия. Первое - сообщить диспетчеру служб, что служба запущена. Это осуществляется путём вызова win32_set_service_status() с константой WIN32_SERVICE_RUNNING. Если вам необходимо выполнить некий длительный процесс перед запуском службы, то вы можете использовать константу WIN32_SERVICE_START_PENDING. Второе - продолжить сверку с диспетчером служб, чтобы определить необходимость отключения. Это осуществляется посредством периодического вызова win32_get_last_control_message() и обработки кода возврата соответствующим образом.

    Предостережение

    Начиная с версии 0.2.0, эта функция работает только в "cli" SAPI. В прочих SAPI функция отключена.

    Список параметров

    name

    Короткое имя службы, как при добавлении с помощью win32_create_service().

    gracefulMode

    true для "элегантного" выхода. false для выхода с ошибкой. Смотрите win32_set_service_exit_mode() для получения подробной информации.

    Возвращаемые значения

    Функция не возвращает значения после выполнения.

    До версии 1.0.0, Возвращает WIN32_NO_ERROR в случае успешного завершения , false если была обнаружена проблема с параметрами или код ошибки Win32 при неудачном завершении работы.

    Ошибки

    До версии 1.0.0, если SAPI не является "cli", данная функция вызывает ошибку уровня E_ERROR.

    Начиная с версии 1.0.0, выбрасывает исключение Win32ServiceException, если SAPI не является "cli"

    Список изменений

    Версия Описание
    PECL win32service 1.0.0 Выбрасывает ValueError при некорректных данных в параметрах, ранее возвращалось false.
    PECL win32service 1.0.0 Выбрасывает Win32ServiceException в случае возникновения ошибки, ранее возвращался Код ошибки Win32.
    PECL win32service 1.0.0 Тип возвращаемого значения void, ранее был mixed.
    PECL win32service 0.4.0 Добавлен параметр gracefulMode.
    PECL win32service 0.2.0 Эта функция работает только с "cli" SAPI.

    Примеры

    Пример #1 Пример win32_start_service_ctrl_dispatcher()

    Проверьте, запущен ли сервис в диспетчере служб.

    <?php
    if (!win32_start_service_ctrl_dispatcher('dummyphp')) {

    die(    "Я, вероятно, не запущен в диспетчере служб");
    }

    win32_set_service_status(WIN32_SERVICE_START_PENDING);

    // Некий длительный процесс для обработки и запуска службы.

    win32_set_service_status(WIN32_SERVICE_RUNNING);

    while (    WIN32_SERVICE_CONTROL_STOP != win32_get_last_control_message()) {
    # здесь производятся какие-то действия, не занимающие больше чем 30 секунд
    # перед соответствующим переходом в цикл.
    }
    ?>

    Смотрите также

    add a note add a note

    User Contributed Notes 3 notes

    up
    0
    andrea
    15 years ago
    Insert value of params between " if the string have a space:

    <?php
    // First you need to create a service, you only need to do this once
    /*
    win32_create_service(array(
        'service' => 'myphpservice',
        'display' => 'My PHP Service',
        'params' => '"c:\\my folder\myphpservice.php"',
        'path' => 'c:\\PHP\\php.exe'));
    */
    ?>
    up
    -1
    dylan at nopower dot org
    17 years ago
    <?php
    // First you need to create a service, you only need to do this once
    /*
    win32_create_service(array(
        'service' => 'myphpservice',
        'display' => 'My PHP Service',
        'params' => 'c:\\myphpservice.php',
        'path' => 'c:\\PHP\\php.exe'));
    */

    $myservicename = 'myphpservice';

    // Connect to service dispatcher and notify that startup was successful
    if (!win32_start_service_ctrl_dispatcher($myservicename)) die('Could not connect to service :'.$myservicename);
    win32_set_service_status(WIN32_SERVICE_RUNNING);

    // Main Server Loop
    while (1) {
        switch (    win32_get_last_control_message()) {
            case     WIN32_SERVICE_CONTROL_CONTINUE: break; // Continue server routine
                case WIN32_SERVICE_CONTROL_INTERROGATE: win32_set_service_status(WIN32_NO_ERROR); break; // Respond with status
                case WIN32_SERVICE_CONTROL_STOP: win32_set_service_status(WIN32_SERVICE_STOPPED); exit; // Terminate script
                default: win32_set_service_status(WIN32_ERROR_CALL_NOT_IMPLEMENTED); // Add more cases to handle other service calls
            }
       
            // Main script goes here
       
            sleep(10); // Run every 10 seconds
    }
    win32_set_service_status(WIN32_SERVICE_STOPPED);
    ?>
    up
    -2
    Guibod
    17 years ago
    Don't try to call "win32_start_service_ctrl_dispatcher" too late in your code. You'd trigger a #2186 error : "The service is not responding to the control function." (from commande line) or a #1053 error : "The service did not respond to the start or control request in a timely fashion." (from services GUI).

    Try not to load a bunch of PEAR classes before to register php script as Service like I did.

    Another good hint, to get a verbose version of the return code, you can call "NET HELPMSG ###" from command line where ### is your error code.
    add a note add a note
    To Top