win32_create_service

(PECL win32service >=0.1.0)

win32_create_service — Crée une nouvelle entrée pour service dans la base de données SCM

Description

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

Tente d'ajouter un service dans la base de données SCM. Des privilèges d'administrateur sont nécessaires pour que cela réussisse.

Liste de paramètres

details

Un tableau des détails des services :

service

Le nom court du service. C'est le nom utilisé pour contrôler le service avec la commande net. Le service doit être unique (deux services ne peuvent partager le même nom), et idéalement, devrait éviter d'avoir des espaces dans son nom.

display

Le nom d'affichage du service. C'est le nom visible dans l'Applet Services.

description

La description longue du service. C'est la description visible dans l'Applet des services.

user

Le nom de l'utilisateur sous lequel on souhaite que le service s'exécute. Si oublié, le service fonctionnera en tant que LocalSystem. Si le nom de l'utilisateur est spécifié, il faut aussi fournir un mot de passe.

password

Le mot de passe qui correspond à user.

path

Le chemin complet au module exécutable qui sera démarré lorsque le service est démarré. Si oublié, le chemin du processus courant de PHP sera utilisé.

params

Paramètres de commande à passer au service lorsqu'il démarre. Pour exécuter un script PHP en tant que service, alors le premier paramètre devrait être le chemin complet au script PHP prévu pour l'exécution. Si le nom du script ou le chemin contiennent des espaces, alors, entourez le chemin complet du script PHP par des "

load_order

Contrôle le load_order. Cela n'est pas encore complètement supporté.

svc_type

Fixe le type de service. Si oublié, la valeur par défaut est WIN32_SERVICE_WIN32_OWN_PROCESS. Ne changez pas ceci à moins de savoir vraiment ce que l'on fait.

start_type

Spécifie comment le service devrait être démarré. La valeur par défaut est WIN32_SERVICE_AUTO_START qui signifie que le service sera démarré lorsque la machine démarrera.

error_control

Informe le SCM à propos de ce qu'il devrait faire lorsqu'il détecte un problème avec le service. La valeur par défaut est WIN32_SERVER_ERROR_IGNORE. Le changement de cette valeur n'est pas encore complètement supporté.

delayed_start

Si delayed_start est défini à true, alors il informera le SCM que ce service doit être démarré après les services démarrés automatiquement et un certain délai.

N'importe quel service peut être marqué comme étant un service retardé après le démarrage automatique ; cependant, cette configuration n'a aucun effet tant que le paramètre start_type du service vaut WIN32_SERVICE_AUTO_START.

Cette configuration n'est applicable que sous Windows Vista et les serveurs Windows 2008 et suivants.

base_priority

Pour réduire l'impact sur l'utilisation du processeur, il peut être nécessaire de définir une priorité plus basse qu'à la normale.

Le paramètre base_priority peut être défini à une des constantes définies dans les classes de priorité de base Win32.

dependencies

Pour définir les dépendances du service, il est nécessaire de définir ce paramètre avec la liste des noms des services dans un tableau.

recovery_delay

Ce paramètre définit le délai entre la défaillance et l'exécution de l'action de récupération. La valeur est en millisecondes.

La valeur par défaut est 60000.

recovery_action_1

L'action qui sera exécutée lors de la première défaillance. L'action par défaut est WIN32_SC_ACTION_NONE.

Le paramètre recovery_action_1 peut être défini avec l'une des constantes définies dans les Actions de récupération Win32.

recovery_action_2

L'action qui sera exécutée lors de la deuxième défaillance. L'action par défaut est WIN32_SC_ACTION_NONE.

Le paramètre recovery_action_2 peut être défini avec l'une des constantes définies dans les Actions de récupération Win32.

recovery_action_3

L'action qui sera exécutée lors des défaillances suivantes. L'action par défaut est WIN32_SC_ACTION_NONE.

Le paramètre recovery_action_3 peut être défini avec l'une des constantes définies dans les Actions de récupération Win32.

recovery_reset_period

Le compteur des défaillances sera réinitialisé après le délai défini dans ce paramètre. Le délai est exprimé en secondes.

La valeur par défaut est 86400.

recovery_enabled

Définir ce paramètre à true pour activer les options de récupération, et false pour les désactiver.

La valeur par défaut est false

recovery_reboot_msg

Ajouter ce paramètre pour définir le message enregistré dans le journal d'évènements Windows avant le redémarrage. Utilisé uniquement si l'une des actions est définie à WIN32_SC_ACTION_REBOOT.

recovery_command

Ajouter ce paramètre pour définir la commande à exécuter lorsqu'une action est définie à WIN32_SC_ACTION_RUN_COMMAND.

machine

Le nom optionnel de la machine sur laquelle on souhaite créer le service. Si oublié, cela utilisera la machine locale.

Valeurs de retour

Aucune valeur n'est retournée.

Avant la version 1.0.0, retournait WIN32_NO_ERROR on success, false if there is a problem with the parameters or a Win32 Error Code on failure.

Erreurs / Exceptions

Une ValueError est levée si la valeur du paramètre service est vide.

Une ValueError est levée si la valeur du paramètre path est omise ou vide.

Une ValueError est levée si la valeur du paramètre svc_type est incorrecte.

Une ValueError est levée si la valeur du paramètre start_type est incorrecte.

Une ValueError est levée si la valeur du paramètre error_control est incorrecte.

Une ValueError est levée si la valeur du paramètre base_priority est incorrecte.

Une ValueError est levée si la valeur du paramètre recovery_delay n'est pas entre 0 et PHP_INT_MAX.

Une ValueError est levée si la valeur du paramètre recovery_action_1 est incorrecte.

Une ValueError est levée si la valeur du paramètre recovery_action_2 est incorrecte.

Une ValueError est levée si la valeur du paramètre recovery_action_3 est incorrecte.

Une ValueError est levée si la valeur du paramètre recovery_reset_period n'est pas entre 0 et PHP_INT_MAX.

Une Win32ServiceException est levée en cas d'erreur.

Historique

Version	Description
PECL win32service 1.0.0	Lance une ValueError si un paramètre est invalide, avant `false` était retourné.
PECL win32service 1.0.0	Lance une Win32ServiceException en cas d'erreur, avant un Code d'erreur Win32 était retourné.
PECL win32service 1.0.0	Le type de retour est maintenant void, avant il était mixed.
PECL win32service 0.4.0	Les paramètres `dependencies`, `recovery_delay`, `recovery_action_1`, `recovery_action_2`, `recovery_action_3`, `recovery_reset_period`, `recovery_enabled`, `recovery_reboot_msg` et `recovery_command` ont été ajoutés.

Exemples

Exemple #1 Exemple avec win32_create_service()

Crée un service dont le nom court est 'dummyphp'.

<?php
$x = win32_create_service(array(
    'service'     => 'dummyphp',                                        // le nom de votre service
    'display'     => 'service PHP simple',                            // la description courte
    'description' => 'Ceci est un service Windows créé en utilisant PHP', // la description longue
    'params'      => '"' . __FILE__ . '"  run',                           // chemin vers le script ainsi que les paramètres
));
debug_zval_dump($x);
?>

Exemple #2 Un exemple win32_create_service() avec les dépendances

Crée un service dont le nom court est 'dummyphp' avec des dépendances.

<?php
$x = win32_create_service(array(
    'service'      => 'dummyphp',                                       // Le nom du service
    'display'               => 'service PHP simple',                             // Une courte description
    'description'           => 'Ceci est un service Windows créé en utilisant PHP.', // Une longue description
    'params'                => '"' . __FILE__ . '"  run',                            // chemin vers le script ainsi que les paramètres
    'dependencies' => array("Netman"),                                      // La liste des dépendances
));
debug_zval_dump($x);
?>

Exemple #3 Exemple de win32_create_service() avec les options de récupération

Crée un service dont le nom court est 'dummyphp' avec les options de récupération.

<?php
$x = win32_create_service(array(
    'service'               => 'dummyphp',                                           // Le nom du service
    'display'               => 'service PHP simple',                             // Une courte description
    'description'           => 'Ceci est un service Windows créé en utilisant PHP.', // Une longue description
    'params'                => '"' . __FILE__ . '"  run',                            // chemin vers le script ainsi que les paramètres
    'recovery_delay'        => 120000,                                               // Les actions de récupération seront exécutées après 2 minutes
    'recovery_action_1'     => WIN32_SC_ACTION_RESTART,                              // Première défaillance, redémarrage du service
    'recovery_action_2'     => WIN32_SC_ACTION_RUN_COMMAND,                          // Deuxième défaillance, exécution d'une commande
    'recovery_action_3'     => WIN32_SC_ACTION_NONE,                                 // Défaillance suivante, ne rien faire
    'recovery_reset_period' => 86400,                                                // Réinitialiser le compteur des défaillances après 1 jour (86400 secondes)
    'recovery_enabled'      => true,                                                 // Activer les options de récupération
    'recovery_reboot_msg'   => null,                                                 // Ne pas définir de message de redémarrage, il n'est pas utile.
    'recovery_command'      => "c:\clean-service.bat",                               // Lorsque l'action est WIN32_SC_ACTION_RUN_COMMAND, exécuter cette commande.
));
debug_zval_dump($x);
?>

Voir aussi

win32_delete_service() - Supprime une entrée de service de la base de données SCM
Les classes de priorité de base Win32
Les actions de récupération Win32
Les codes erreurs Win32

Found A Problem?

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

＋add a note

User Contributed Notes 2 notes

down

Anonymous ¶

15 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();
?>

down

pauljamesthomson at gmail dot com ¶

19 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

＋add a note