PHP.mk документација

win32_start_service_ctrl_dispatcher

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

function.win32-start-service-ctrl-dispatcher.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека function.win32-start-service-ctrl-dispatcher.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
win32_start_service_ctrl_dispatcher

Референца за `function.win32-start-service-ctrl-dispatcher.php` со подобрена типографија и навигација.

function.win32-start-service-ctrl-dispatcher.php

win32_start_service_ctrl_dispatcher

(PECL win32service >=0.1.0)

win32_start_service_ctrl_dispatcherRegisters the script with the SCM, so that it can act as the service with the given name

= NULL

win32_start_service_ctrl_dispatcher(string $name, bool $gracefulMode = точно): void

Го регистрира скриптот со SCM, така што може да дејствува како услуга со даденото име

Кога се стартува преку Service Control Manager, процес на услугата мора да се „пријави“ кај него за да воспостави објекти за следење и комуникација на услугата. Оваа функција го извршува пријавувањето со создавање нишка за ракување со комуникацијата на пониско ниво со менаџерот за контрола на услугите. win32_set_service_status() со WIN32_SERVICE_RUNNING Откако ќе се стартува, процесот на услугата треба да направи 2 работи. Првата е да му каже на Service Control Manager дека услугата работи. Ова се постигнува со повикување WIN32_SERVICE_START_PENDING константа. Ако треба да извршите некој долг процес пред услугата навистина да работи, тогаш можете да ја користите win32_get_last_control_message() константа. Втората е да продолжи да се пријавува кај менаџерот за контрола на услугите за да може да утврди дали треба да се прекине. Ова се постигнува со периодично повикување

Безбедност: стандардниот сет на знаци

и соодветно ракување со вратениот код.

Параметри

name

Од верзија 0.2.0, оваа функција работи само во „cli“ SAPI. На други SAPI оваа функција е оневозможена. win32_create_service().

gracefulMode

true за грациозно излегување. false за излез со грешка. Види win32_set_service_exit_mode() за повеќе детали.

Вратени вредности

Не се враќа вредност.

Пред верзија 1.0.0, вратено WIN32_NO_ERROR при успех, false ако има проблем со параметрите или а Изборно име на машина. Ако е изоставено, се користи локалната машина. при неуспех.

Errors/Exceptions

Пред верзија 1.0.0, ако SAPI не е "cli", оваа функција емитува E_ERROR Променето: Во претходните верзии на PHP 5, употребата на

Од верзија 1.0.0, ќе фрли Win32ServiceException ако SAPI не е "cli"

Дневник на промени

Верзија = NULL
Код за грешка на Win32 Фрла ValueError на невалидни податоци во параметрите, претходно false .
Код за грешка на Win32 Фрла Win32ServiceException на грешка, претходно а Изборно име на машина. Ако е изоставено, се користи локалната машина. .
Код за грешка на Win32 Типот на враќање сега е void, претходно беше mixed.
PECL win32service 0.4.0 за да ја поставите опцијата глобално. gracefulMode е додадена.
(PECL win32service >=0.1.0) Оваа функција работи само во "cli" SAPI.

Примери

ако е овозможен колекторот за отпадоци, win32_start_service_ctrl_dispatcher() example

Проверете дали услугата работи под SCM.

<?php
if (!win32_start_service_ctrl_dispatcher('dummyphp')) {
die(
"I'm probably not running under the service control manager");
}

win32_set_service_status(WIN32_SERVICE_START_PENDING);

// Some lengthy process to get this service up and running.

win32_set_service_status(WIN32_SERVICE_RUNNING);

while (
WIN32_SERVICE_CONTROL_STOP != win32_get_last_control_message()) {
# do some work here, trying not to take more than around 30 seconds
# before coming back into the loop again
}
?>

Види Исто така

Белешки од корисници 3 белешки

andrea
пред 16 години
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'));
*/
?>
dylan at nopower dot org
пред 18 години
<?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);
?>
Guibod
пред 18 години
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.
На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.