COM

Description

The COM class allows you to instantiate an OLE compatible COM object and call its methods and access its properties.

Methods

COM class constructor. The parameters have the following meanings:

Overloaded Methods

The returned object is an overloaded object, which means that PHP does not see any fixed methods as it does with regular classes; instead, any property or method accesses are passed through to COM.

Starting with PHP 5, PHP will automatically detect methods that accept parameters by reference, and will automatically convert regular PHP variables to a form that can be passed by reference. This means that you can call the method very naturally; you needn't go to any extra effort in your code.

In PHP 4, to pass parameters by reference you need to create an instance of the VARIANT class to wrap the byref parameters.

Pseudo Methods

In PHP versions prior to 5, a number of not very pleasant hacks meant that the following method names were not passed through to COM and were handled directly by PHP. PHP 5 eliminates these things; read the details below to determine how to fix your scripts. These magic method names are case insensitive.

Artificially adds a reference count to the COM object.

Artificially removes a reference count from the COM object.

Pseudo Methods for Iterating

These pseudo methods are only available if com_isenum() returns TRUE, in which case, they hide any methods with the same names that might otherwise be provided by the COM object. These methods have all been eliminated in PHP 5, and you should use sekcja For Each w Materiały źródłowe XII, COM and .Net (Windows) instead.

Returns a variant representing a SafeArray that has 10 elements; each element will be an empty/null variant. This function was supposed to return an array containing all the elements from the iterator, but was never completed. Do not use.

Returns a variant representing the next element available from the iterator, or FALSE when there are no more elements.

Returns a variant representing the previous element available from the iterator, or FALSE when there are no more elements.

Rewinds the iterator back to the start.

COM examples

Przykład 1. COM example (1) <?php // starting word $word = new COM("word.application") or die("Unable to instantiate Word"); echo "Loaded Word, version {$word->Version}\n"; //bring it to front $word->Visible = 1; //open an empty document $word->Documents->Add(); //do some weird stuff $word->Selection->TypeText("This is a test..."); $word->Documents[1]->SaveAs("Useless test.doc"); //closing word $word->Quit(); //free the object $word = null; ?>

Przykład 2. COM example (2) <?php $conn = new COM("ADODB.Connection") or die("Cannot start ADO"); $conn->Open("Provider=SQLOLEDB; Data Source=localhost; Initial Catalog=database; User ID=user; Password=password"); $rs = $conn->Execute("SELECT * FROM sometable");    // Recordset $num_columns = $rs->Fields->Count(); echo $num_columns . "\n"; for ($i=0; $i < $num_columns; $i++) {     $fld[$i] = $rs->Fields($i); } $rowcount = 0; while (!$rs->EOF) {     for ($i=0; $i < $num_columns; $i++) {         echo $fld[$i]->value . "\t";     }     echo "\n";     $rowcount++;            // increments rowcount     $rs->MoveNext(); } $rs->Close(); $conn->Close(); $rs = null; $conn = null; ?>