win32service.github.io

PHP Extension website

---

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

Win32Service project

This project provides most elements:

• a PHP extension for running a custom PHP script like a Windows Service
• a PHP library for help to use the extension
• a Bundle to integrating the library into your Symfony 4 project

News

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

PHP Extension

PHP Library

Symfony Bundle

Requirements

For the extension

• Windows 7 or newer, Windows 2012 R2 or newer
• PHP 7.1 or newer for Windows

For the library

• You can install this library on all operating system
• PHP 7.1 or newer

For the Symfony bundle

• You can install this Bundle on all operating system
• Symfony 4 or newer

Goal

This extension provide a wrapper between Windows Service Manager and your PHP script. The PHP version supported by this extension is 7.1.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:

• The official extension website for PHP This site provide the slow release.
• The Github repository tag assets The tags contains the pre-release build.
• The Appveyor artifact The artifact are available since 6 month. The build for all change are available for test only.

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.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.1.0 dont work with this extension, use the latest version of PHP 7.1.

Use

You can use this PHP service-library for implements your service runtime and management scripts. If you project is based on Symfony 4+, you can use the bundle to integrate the library into Symfony and reduce the number of codes do you need to write.

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

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

Blog post: Nouveautés de Win32Service 0.4 [FR]

Blog posts: [Win32Service] PHP 7.0 and 7.1 support [EN] and [Win32Service] Support de PHP 7.0 et PHP 7.1 [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.