win32service.github.io

PHP Extension website


Project maintained by win32service Hosted on GitHub Pages — Theme by mattgraham

Win32Service projet

This projet provide an PHP extension for running a custom PHP script like a Windows Service and an PHP library for help to use the extension.

News

For the latest news for this project, search on Twitter the #Win32Service hashtag #Win32Service hashtag.

PHP Extension

Repository Build status License Documentation

Library

Repository Build status License Documentation

Goal

This extension provide a wrapper between Windows Service Manager and your PHP script. The PHP version supported by this extension is 7.0.1 and later. This extension work only for the Windows Build of PHP and with all variant (NTS/TS and 32/64 bit).

This extension requires the elevated privileges for work. However, you can delegate for some actions

Download

You can download the pre-build extension from:

Installation

Unzip the package and copy the extention into the folder ext of your PHP installation.

After copy, edit the the file php.ini and add one line for load the extension depending on your version of PHP (7.0/7.1/7.2/7.3, x64/x86, ZTS/NTS). In example for PHP 7.3 in TS mode and 32 bit architecture : extension = php_win32service-7.3-ts-vc14-x86.dll (or use the short name available since PHP 7.2 : extension = win32service if the extension file is named php_win32service.dll).

Check in command line if the extension is correctly loaded with this command php --ri win32service.

If the output indicate this extension is not loaded, check the PHP configuration.

Note: The PHP version 7.0.0 and 7.1.0 dont work with this extension, use the latest version of PHP 7.0 and PHP 7.1.

Use

You can use this PHP service-library for implements your service runtime and management scripts.

Otherwise , the downloaded zip contains examples scripts used for testing. The file service.php contains a skeleton for implement one service in PHP.

To use this example, open a command line window in administrator mode. Go to the example folder and run this command php service.php create to installing the test service.

Now a new service is added into the Windows service manager. You can start, stop this service from the Windows service manager or from the administrator command line.

Good coding !

Help

Crash, feature request, or suggest, please open an issue.

Help for the extension function, visit the official PHP web site

Extension PHP pour réaliser des services Windows [FR]

Contributing

If you want to contribute, you can open an issue for propose your idea. If you can writing the code, fork the repository and write the code, finally propose your enhancement by a pull request.