W32api Functions

Introduction

This extension is a generic extension API to DLLs. This was originally written to allow access to the Win32 API from PHP, although you can also access other functions exported via other DLLs.

Currently supported types are generic PHP types (strings, booleans, floats, integers and nulls) and types you define with w32api_deftype().

Note:

This extension has been moved to the » PECL repository and is no longer bundled with PHP as of PHP 5.1.0.

Warning:

This extension is EXPERIMENTAL. The behaviour of this extension -- including the names of its functions and anything else documented about this extension -- may change without notice in a future release of PHP. Use this extension at your own risk.

Requirements

This extension will only work on Windows systems.

Installation

There is no installation needed to use these functions; they are part of the PHP core.

Runtime Configuration

This extension has no configuration directives defined in php.ini.

Resource Types

This extension defines one resource type, used for user defined types. The name of this resource is "dynaparm".

Predefined Constants

The constants below are defined by this extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime.

DC_MICROSOFT (integer)
DC_BORLAND (integer)
DC_CALL_CDECL (integer)
DC_CALL_STD (integer)
DC_RETVAL_MATH4 (integer)
DC_RETVAL_MATH8 (integer)
DC_CALL_STD_BO (integer)
DC_CALL_STD_MS (integer)
DC_CALL_STD_M8 (integer)
DC_FLAG_ARGPTR (integer)

Examples

This example gets the amount of time the system has been running and displays it in a message box.

Example 2611. Get the uptime and display it in a message box

copy to clipboard

<?php
// Define constants needed, taken from

// Visual Studio/Tools/Winapi/WIN32API.txt
define("MB_OK", 0);

// Load the extension in
dl("php_w32api.dll");

// Register the GetTickCount function from kernel32.dll
w32api_register_function("kernel32.dll", 

                         "GetTickCount",

                         "long");

                         
// Register the MessageBoxA function from User32.dll
w32api_register_function("User32.dll",

                         "MessageBoxA",

                         "long");

// Get uptime information
$ticks = GetTickCount();

// Convert it to a nicely displayable text
$secs  = floor($ticks / 1000);
$mins  = floor($secs / 60);
$hours = floor($mins / 60);

$str = sprintf("You have been using your computer for:" .

                "\r\n %d Milliseconds, or \r\n %d Seconds" .

                "or \r\n %d mins or\r\n %d hours %d mins.",

                $ticks,

                $secs,

                $mins,

                $hours,

                $mins - ($hours*60));

// Display a message box with only an OK button and the uptime text
MessageBoxA(NULL, 

            $str, 

            "Uptime Information", 

            MB_OK);
?>

Table of Contents

w32api_deftype — Defines a type for use with other w32api_functions
w32api_init_dtype — Creates an instance of the data type typename and fills it with the values passed
w32api_invoke_function — Invokes function funcname with the arguments passed after the function name
w32api_register_function — Registers function function_name from library with PHP
w32api_set_call_method — Sets the calling method used

Code Examples / Notes » ref.w32api

In response to post by Jan Kleinsorge. To get the proper windows system uptime, one should use the Performance Monitoring system... GetTickCount is limited to 49.7 days, as the result is a dword. <?php if (!dl("php_w32api.dll")) { echo "Unable to load php_w32api.dll"; exit; } $api = new win32; $api->registerfunction("bool QueryPerformanceCounter (float &lpPerformanceCount) From kernel32.dll"); $api->registerfunction("bool QueryPerformanceFrequency (float &lpPerformanceFrequency) From kernel32.dll"); $api->QueryPerformanceCounter($a); $api->QueryPerformanceFrequency($b); $c = $a/$b; $days = floor($c / 86400); echo gmstrftime("System uptime is $days Days, %H Hr, %M Min, %S Sec ", $c); ?> The above snippet will return the true uptime for an unlimited time for a windows OS. (Disregarding the fact that windows needs reboot every 10 days or so :)) A tiny dange though is the lack of 64bit variable types in php.. (the "float &lpPerformanceCount" should be "long long &lpPerformanceCount") .. Nevertheless.. It works :) Philip S.

I played a bit around with the W32API. Here is some code that actually works with the current release of W32API. The interface changed completely, so all documentation about this extension is out-dated. While the old release just implemented "plain" functions, the current version offers a class to handle all the API-related operations. Additionally, functions are now registered using a SQL-like language with a single string. <?php $api = new win32; /* BOOL GetUserName( LPTSTR lpBuffer, // address of name buffer LPDWORD nSize // address of size of name buffer ); Returns the current thread's username "&" passes argument as "refrence" not as "copy" */ $api->registerfunction("long GetUserName (string &a, int &b) From advapi32.dll"); /* DWORD GetTickCount(VOID) Returns the ms the OS is running */ $api->registerfunction("long GetTickCount () From Kernel32.dll"); $len = 255; // set the length your variable should have $name = str_repeat("\0", $len); // prepare an empty string if ($api->GetUserName($name, $len) == 0) { die("failed"); } if (!($time = $api->GetTickCount())) { die("failed"); } echo "Username: $name \nSystemtime: $time \n"; ?> GOOD LUCK !! Jan Kleinsorge