win32_start_service_ctrl_dispatcher
(PECL win32service SVN)
win32_start_service_ctrl_dispatcher — Добавляет в Диспетчер Служб скрипт, который может быть использован как служба с заданным именем
Описание
При запуске с помощью диспетчера служб, процессу службы необходимо сверяться с ним для мониторинга службы и связи с ней. Эта функция выполняет сверку посредством создания потока для обработки низкоуровневой связи с диспетчером служб.
После запуска процесс службы должен осуществить два действия. Первое - сообщить
диспетчеру служб, что служба запущена. Это осуществляется путем вызова win32_set_service_status()
с константой WIN32_SERVICE_RUNNING. Если вам необходимо выполнить
некий длительный процесс перед запуском службы, то вы можете использовать константу
WIN32_SERVICE_START_PENDING. Второе - продолжить сверку с диспетчером
служб, чтобы определить необходимость отключения. Это осуществляется посредством
периодического вызова win32_get_last_control_message() и обработки
кода возврата соответствующим образом.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения, FALSE если была обнаружена проблема с параметрами или код ошибки Win32 при неудачном завершении работы.
Примеры
Пример #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 секунд
# перед соответствующим переходом в цикл.
}
?>
Смотрите также
- win32_set_service_status() - Update the service status
- win32_get_last_control_message() - Returns the last control message that was sent to this service
- Коды Ошибок Win32
Коментарии
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.
<?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);
?>
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'));
*/
?>