win32_create_service

    (PECL win32service >=0.1.0)

    win32_create_service — Crea una nueva entrada para servicio en la base de datos SCM

    Descripción

    win32_create_service(array $details, string $machine = null): void

    Intenta añadir un servicio en la base de datos SCM. Se necesitan privilegios de administrador para que esto tenga éxito.

    Parámetros

    details

    Un array de detalles del servicio:

    service

    El nombre corto del servicio. Este es el nombre que se utilizará para controlar el servicio utilizando el comando net. El servicio debe ser único (dos servicios no pueden compartir el mismo nombre), e idealmente, debería evitar tener espacios en su nombre.

    display

    El nombre de visualización del servicio. Este es el nombre que se verá en la Applet Servicios.

    description

    La descripción larga del servicio. Esta es la descripción que se verá en la Applet de Servicios.

    user

    El nombre de usuario bajo el cual se desea que el servicio se ejecute. Si se omite, el servicio funcionará como LocalSystem. Si se especifica el nombre de usuario, también se debe proporcionar una contraseña.

    password

    La contraseña que corresponde a user.

    path

    La ruta completa al módulo ejecutable que se iniciará cuando el servicio se inicie. Si se omite, se utilizará la ruta del proceso actual de PHP.

    params

    Argumentos de comando a pasar al servicio cuando se inicie. Si se desea ejecutar un script PHP como servicio, entonces el primer argumento debería ser la ruta completa al script PHP que se planea ejecutar. Si el nombre del script o la ruta contienen espacios, entonces, rodee la ruta completa del script PHP con "

    load_order

    Controla el load_order. Esto aún no está completamente soportado.

    svc_type

    Establece el tipo de servicio. Si se omite, el valor por omisión es WIN32_SERVICE_WIN32_OWN_PROCESS. No se debe cambiar esto a menos que se sepa realmente lo que se está haciendo.

    start_type

    Especifica cómo debe iniciarse el servicio. El valor por omisión es WIN32_SERVIDE_AUTO_START lo que significa que el servicio se iniciará cuando la máquina se inicie.

    error_control

    Informa al SCM sobre qué hacer cuando detecte un problema con el servicio. El valor por omisión es WIN32_SERVER_ERROR_IGNORE. Cambiar este valor aún no está completamente soportado.

    delayed_start

    Si delayed_start está establecido a true, entonces informará al SCM que este servicio debe iniciarse después de los servicios iniciados automáticamente y un cierto retraso.

    Cualquier servicio puede ser marcado como un servicio retrasado después del inicio automático; sin embargo, esta configuración no tiene ningún efecto mientras el parámetro start_type del servicio valga WIN32_SERVICE_AUTO_START.

    Esta configuración solo se aplica en Windows Vista y servidores Windows 2008 y posteriores.

    base_priority

    Para reducir el impacto en el uso del procesador, puede ser necesario establecer una prioridad más baja que la normal.

    El parámetro base_priority puede ser establecido a una de las constantes definidas en las clases de baja prioridad Win32.

    dependencies

    Para definir las dependencias del servicio, es necesario establecer este parámetro con la lista de nombres de servicios en un array.

    recovery_delay

    Este parámetro define el retraso entre el fallo y la ejecución de la acción de recuperación. El valor es en milisegundos.

    El valor por omisión es 60000.

    recovery_action_1

    La acción que se ejecutará en caso de la primera falla. La acción por omisión es WIN32_SC_ACTION_NONE.

    El parámetro recovery_action_1 puede ser establecido con una de las constantes definidas en las Acciones de recuperación Win32.

    recovery_action_2

    La acción que se ejecutará en caso de la segunda falla. La acción por omisión es WIN32_SC_ACTION_NONE.

    El parámetro recovery_action_2 puede ser establecido con una de las constantes definidas en las Acciones de recuperación Win32.

    recovery_action_3

    La acción que se ejecutará en caso de fallas subsiguientes. La acción por omisión es WIN32_SC_ACTION_NONE.

    El parámetro recovery_action_3 puede ser establecido con una de las constantes definidas en las Acciones de recuperación Win32.

    recovery_reset_period

    El contador de fallas se reiniciará después del retraso definido en este parámetro. El retraso se expresa en segundos.

    El valor por omisión es 86400.

    recovery_enabled

    Establecer este parámetro a true para habilitar las opciones de recuperación, y false para deshabilitarlas.

    El valor por omisión es false

    recovery_reboot_msg

    Añadir este parámetro para definir el mensaje registrado en el registro de eventos de Windows antes del reinicio. Solo se utiliza si una de las acciones está definida a WIN32_SC_ACTION_REBOOT.

    recovery_command

    Añadir este parámetro para definir el comando a ejecutar cuando una acción está definida a WIN32_SC_ACTION_RUN_COMMAND.

    machine

    El nombre opcional de la máquina en la que se desea crear el servicio. Si se omite, se utilizará la máquina local.

    Valores devueltos

    No devuelve ningún valor.

    Antes de la versión 1.0.0, Devuelve WIN32_NO_ERROR en caso de éxito, false si hay un problema con los parámetros o Código de error Win32 en caso de error.

    Errores/Excepciones

    Se lanzará una ValueError si el valor del parámetro service está vacío.

    Se lanzará una ValueError si el valor del parámetro path está omitido o vacío.

    Se lanzará una ValueError si el valor del parámetro svc_type es incorrecto.

    Se lanzará una ValueError si el valor del parámetro start_type es incorrecto.

    Se lanzará una ValueError si el valor del parámetro error_control es incorrecto.

    Se lanzará una ValueError si el valor del parámetro base_priority es incorrecto.

    Se lanzará una ValueError si el valor del parámetro recovery_delay no está entre 0 y PHP_INT_MAX.

    Se lanzará una ValueError si el valor del parámetro recovery_action_1 es incorrecto.

    Se lanzará una ValueError si el valor del parámetro recovery_action_2 es incorrecto.

    Se lanzará una ValueError si el valor del parámetro recovery_action_3 es incorrecto.

    Se lanzará una ValueError si el valor del parámetro recovery_reset_period no está entre 0 y PHP_INT_MAX.

    Se lanzará una Win32ServiceException en caso de error.

    Historial de cambios

    Versión Descripción
    PECL win32service 1.0.0 Se lanzará una ValueError si un parámetro es inválido, antes false era devuelto.
    PECL win32service 1.0.0 Se lanzará una Win32ServiceException en caso de error, antes un Código de error Win32 era devuelto.
    PECL win32service 1.0.0 El tipo de retorno ahora es void, antes era mixed.
    PECL win32service 0.4.0 Los parámetros dependencies, recovery_delay, recovery_action_1, recovery_action_2, recovery_action_3, recovery_reset_period, recovery_enabled, recovery_reboot_msg y recovery_command han sido añadidos.

    Ejemplos

    Ejemplo #1 Ejemplo con win32_create_service()

    Crea un servicio cuyo nombre corto es 'dummyphp'.

    <?php
    \$x = win32_create_service(array(
    'service' => 'dummyphp', // el nombre del servicio
    'display' => 'ejemplo de servicio PHP ficticio', // la descripción corta
    'description' => 'Este es un servicio Windows creado utilizando PHP', // la descripción larga
    'params' => '"' . __FILE__ . '" run', // ruta al script así como los argumentos
    ));
    debug_zval_dump(\$x);
    ?>

    Ejemplo #2 Un ejemplo win32_create_service() con dependencias

    Crea un servicio cuyo nombre corto es 'dummyphp' con dependencias.

    <?php
    \$x = win32_create_service(array(
    'service' => 'dummyphp', // El nombre del servicio
    'display' => 'ejemplo de servicio PHP ficticio', // Una descripción corta
    'description' => 'Este es un servicio Windows creado utilizando PHP.', // Una descripción larga
    'params' => '"' . __FILE__ . '" run', // ruta al script así como los argumentos
    'dependencies' => array("Netman"), // La lista de dependencias
    ));
    debug_zval_dump(\$x);
    ?>

    Ejemplo #3 Ejemplo de win32_create_service() con opciones de recuperación

    Crea un servicio cuyo nombre corto es 'dummyphp' con opciones de recuperación.

    <?php
    \$x = win32_create_service(array(
    'service' => 'dummyphp', // El nombre del servicio
    'display' => 'ejemplo de servicio PHP ficticio', // Una descripción corta
    'description' => 'Este es un servicio Windows creado utilizando PHP.', // Una descripción larga
    'params' => '"' . __FILE__ . '" run', // ruta al script así como los argumentos
    'recovery_delay' => 120000, // Las acciones de recuperación se ejecutarán después de 2 minutos
    'recovery_action_1' => WIN32_SC_ACTION_RESTART, // Primera falla, reiniciar el servicio
    'recovery_action_2' => WIN32_SC_ACTION_RUN_COMMAND, // Segunda falla, ejecutar un comando
    'recovery_action_3' => WIN32_SC_ACTION_NONE, // Fallas subsiguientes, no hacer nada
    'recovery_reset_period' => 86400, // Reiniciar el contador de fallas después de 1 día (86400 minutos)
    'recovery_enabled' => true, // Habilitar las opciones de recuperación
    'recovery_reboot_msg' => null, // No definir un mensaje de reinicio, no es útil.
    'recovery_command' => "c:\clean-service.bat", // Cuando la acción es WIN32_SC_ACTION_RUN_COMMAND, ejecutar este comando.
    ));
    debug_zval_dump(\$x);
    ?>

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    2
    pauljamesthomson at gmail dot com
    18 years ago
    Other start_type values:

    0x00000002: A service started automatically by the service control manager during system startup. For more information, see Automatically Starting Services.

    0x00000000: A device driver started by the system loader. This value is valid only for driver services.

    0x00000003: A service started by the service control manager when a process calls the win32_start_service() function.

    0x00000004: A service that cannot be started. Attempts to start the service result in the error code

    0x00000001: A device driver started by the IoInitSystem function. This value is valid only for driver services.

    I can confirm that 0x00000003 works as expected (service is created, but must be started manually).

    More here:

    http://msdn2.microsoft.com/en-us/library/ms682450.aspx
    up
    0
    Anonymous
    14 years ago
    [An example of how to create a Windows service. Evaluate code first and use at your own risk!]

    <?php

    //No timeouts, Flush Content immediatly
    set_time_limit(0);
    ob_implicit_flush();

    //Service Settings
    $phpPath = "D:\\php\\php5.2.9";
    $ServiceName = 'phpServiceName';
    $ServiceDisplay = 'phpDisplayName';

    //Windows Service Control
    $ServiceAction = "status";
    //$ServiceAction = "debug";
    if ( isset($_GET['ServiceAction']) and strlen($_GET['ServiceAction']) ) {
    $ServiceAction = addslashes($_GET['ServiceAction']);
    } else if ( isset(    $argv) and isset($argv[1]) and strlen($argv[1]) ) {
    $ServiceAction = $argv[1];
    }
    if(     $ServiceAction == "status" ) {
    $ServiceStatus = win32_query_service_status($ServiceName);
    if (     $ServiceStatus['CurrentState'] == WIN32_SERVICE_STOPPED ) {
    echo     "Service Stopped\n\n";
    } else if (     $ServiceStatus['CurrentState'] == WIN32_SERVICE_START_PENDING ) {
    echo     "Service Start Pending\n\n";
    } else if (     $ServiceStatus['CurrentState'] == WIN32_SERVICE_STOP_PENDING ) {
    echo     "Service Stop Pending\n\n";
    } else if (     $ServiceStatus['CurrentState'] == WIN32_SERVICE_RUNNING ) {
    echo     "Service Running\n\n";
    } else if (     $ServiceStatus['CurrentState'] == WIN32_SERVICE_CONTINUE_PENDING ) {
    echo     "Service Continue Pending\n\n";
    } else if (     $ServiceStatus['CurrentState'] == WIN32_SERVICE_PAUSE_PENDING ) {
    echo     "Service Pause Pending\n\n";
    } else if (     $ServiceStatus['CurrentState'] == WIN32_SERVICE_PAUSED ) {
    echo     "Service Paused\n\n";
    } else{
    echo     "Service Unknown\n\n";
    }
    exit;
    } else if (     $ServiceAction == "install" ) {
    //Install Windows Service
    win32_create_service( Array(
    'service' => $ServiceName,
    'display' => $ServiceDisplay,
    'params' => __FILE__ . " run",
    'path' => $phpPath."\\php.exe",
    ));
    echo     "Service Installed\n\n";
    exit;
    } else if (     $ServiceAction == "uninstall" ) {
    //Remove Windows Service
    win32_delete_service($ServiceName);
    echo     "Service Removed\n\n";
    exit;
    } else if(     $ServiceAction == "start") {
    //Start Windows Service
    win32_start_service($ServiceName);
    echo     "Service Started\n\n";
    exit;
    } else if(     $ServiceAction == "stop" ) {
    //Stop Windows Service
    win32_stop_service($ServiceName);
    echo     "Service Stopped\n\n";
    exit;
    } else if (     $ServiceAction == "run" ) {
    //Run Windows Service
    win32_start_service_ctrl_dispatcher($ServiceName);
    win32_set_service_status(WIN32_SERVICE_RUNNING);
    } else if (     $ServiceAction == "debug" ) {
    //Debug Windows Service
    set_time_limit(10);
    } else {
    exit();
    }

    //Server Loop
    while (1) {
    //Handle Windows Service Request
    usleep(100*1000);
    if (     $ServiceAction == "run" ) {
    switch (     win32_get_last_control_message() ) {
    case     WIN32_SERVICE_CONTROL_CONTINUE:
    break;
    case     WIN32_SERVICE_CONTROL_INTERROGATE:
    win32_set_service_status(WIN32_NO_ERROR);
    break;
    case     WIN32_SERVICE_CONTROL_STOP:
    win32_set_service_status(WIN32_SERVICE_STOPPED);
    exit;
    default:
    win32_set_service_status(WIN32_ERROR_CALL_NOT_IMPLEMENTED);
    }
    }
    //User Loop
    sleep(1);
    echo     "\n<BR>YOUR CODE HERE";
    }

    //Exit
    if ( $ServiceAction == "run" ) {
    win32_set_service_status(WIN32_SERVICE_STOPPED);
    }
    exit();
    ?>
    ＋add a note
    To Top