COM and .Net (Windows)

简介
安装／配置
预定义常量
Errors and error handling
范例
- For Each
- Arrays and Array-style COM properties
com — The com class
- com::__construct — com class constructor
dotnet — The dotnet class
- dotnet::__construct — dotnet class constructor
variant — variant class
- variant::__construct — variant class constructor
COMPersistHelper — The COMPersistHelper class
- COMPersistHelper::__construct — Construct a COMPersistHelper object
- COMPersistHelper::GetCurFileName — Get current filename
- COMPersistHelper::GetMaxStreamSize — Get maximum stream size
- COMPersistHelper::InitNew — Initialize object to default state
- COMPersistHelper::LoadFromFile — Load object from file
- COMPersistHelper::LoadFromStream — Load object from stream
- COMPersistHelper::SaveToFile — Save object to file
- COMPersistHelper::SaveToStream — Save object to stream
com_exception — The com_exception class
COM 函数
- com_create_guid — Generate a globally unique identifier (GUID)
- com_event_sink — Connect events from a COM object to a PHP object
- com_get_active_object — Returns a handle to an already running instance of a COM object
- com_load_typelib — 装载一个 Typelib
- com_message_pump — Process COM messages, sleeping for up to timeoutms milliseconds
- com_print_typeinfo — Print out a PHP class definition for a dispatchable interface
- variant_abs — Returns the absolute value of a variant
- variant_add — "Adds" two variant values together and returns the result
- variant_and — Performs a bitwise AND operation between two variants
- variant_cast — Convert a variant into a new variant object of another type
- variant_cat — Concatenates two variant values together and returns the result
- variant_cmp — Compares two variants
- variant_date_from_timestamp — Returns a variant date representation of a Unix timestamp
- variant_date_to_timestamp — Converts a variant date/time value to Unix timestamp
- variant_div — Returns the result from dividing two variants
- variant_eqv — Performs a bitwise equivalence on two variants
- variant_fix — Returns the integer portion of a variant
- variant_get_type — Returns the type of a variant object
- variant_idiv — Converts variants to integers and then returns the result from dividing them
- variant_imp — Performs a bitwise implication on two variants
- variant_int — Returns the integer portion of a variant
- variant_mod — Divides two variants and returns only the remainder
- variant_mul — Multiplies the values of the two variants
- variant_neg — Performs logical negation on a variant
- variant_not — Performs bitwise not negation on a variant
- variant_or — Performs a logical disjunction on two variants
- variant_pow — Returns the result of performing the power function with two variants
- variant_round — Rounds a variant to the specified number of decimal places
- variant_set_type — Convert a variant into another type "in-place"
- variant_set — Assigns a new value for a variant object
- variant_sub — Subtracts the value of the right variant from the left variant value
- variant_xor — Performs a logical exclusion on two variants

User Contributed Notes

robert dot johnson at icap dot com 24-Jul-2012 09:30


(From?) PHP 5.4.5 for Windows:



If you are seeing this in your error log:



Fatal error:  Class 'COM' not found 



You require this in php.ini:



[PHP_COM_DOTNET]

extension=php_com_dotnet.dll



Previously it was compiled as built-in on the Windows build.  I assume this has happened because the com extension can now be built as a shared component.

Anonymous 23-Sep-2009 05:00


Add hyperlink at a Word Document's bookmark





<?php


// Create COM instance to word


       function clsMSWord($Visible = false)


       {


           $this->handle = new COM("word.application") or die("Unable to instanciate Word");


           $this->handle->Visible = $Visible;


       }





function WriteHyperlink($Bookmark,$Path,$Text)


       {


               $objBookmark = $this->handle->ActiveDocument->Bookmarks($Bookmark);


               $range = $objBookmark->Range;


               $objHyperlink = $this->handle->ActiveDocument->Hyperlinks;


               $objHyperlink->add($range,$Path,"","",$Text);


           


       }


?>

Dave Bachtel 27-May-2009 02:20


Hello everybody!



Here is some helpful advice for people attempting to use COM with Microsoft MapPoint 2006 or 2009 with PHP.



If you are using apache, it MUST be running under the same credentials as a desktop user that has already installed/run mappoint or modifiy the service and select the "Allow Service to Interact with Desktop" option.  Otherwise, it won't work due to the EULA popup having to be accepted.  Mappoint 2004 works just fine, this only applies to 2006 and 2009.



For troubleshooting, the error that appears in the System event viewer is:

The server {31851F82-AFE6-11D2-A3C9-00C04F72F340} did not register with DCOM within the required timeout.



The error generated by PHP, if you happen to get lucky and let the COM() function timeout by cranking up set_time_limit() timeout is:

<?php



set_time_limit(1000) ;



$mapoint =  new COM("MapPoint.Application") or die("Unable to instantiate Mappoint COM object");



?>

Generates:

Fatal error: Uncaught exception 'com_exception' with message 'Failed to create COM object `MapPoint.Application': Server execution failed ' in [somefile.php]:9 Stack trace: #0 [somefile.php](9): com->com('MapPoint.Applic...') #1 {main} thrown in [somefile.php] on line 9



Also, if you have multiple versions of MapPoint installed, you will need to run:

c:\path\to\mappoint\MapPoint.exe /registerserver 



(using the correct folder path) to select the right version of the com object to use.  Gooood luck!

acsandeep at gmail dot com 04-Apr-2009 09:40


If you are trying to get the properties of a Word document opened via COM object, you may need to define some constants in your script like so.





<?php


define('wdPropertyTitle', 1);


define('wdPropertySubject', 2);


define('wdPropertyAuthor', 3);


define('wdPropertyKeywords', 4);


define('wdPropertyComments', 5);


define('wdPropertyTemplate', 6);


define('wdPropertyLastAuthor', 7);





$word = new COM("word.application") or die ("Could not initialise MS Word object.");


$word->Documents->Open(realpath("Sample.doc"));


$Author = $word->ActiveDocument->BuiltInDocumentProperties(wdPropertyAuthor);





echo $Author;


?>

long2hu3 ATT yahoo DOTT com 18-Mar-2009 04:38


When you work with MS Excel, Word, ... and other applications, never forget that COM doesn't know their predefined constants, thus if you want to do sth. that would look like this in VB:



With myRange.Borders(xlEdgeBottom)

    .LineStyle = xlContinuous

    .Weight = xlThin

    .ColorIndex = xlAutomatic

End With



you should either use numbers or define constants above, like this:



<?php



define('xlEdgeBottom', 9);

define('xlContinuous', 1);

define('xlThin', 2);

define('xlAutomatic', -4105);



$ex = new COM("Excel.Application", NULL, CP_UTF8) or Die ("Did not instantiate Excel");

$wb = $ex->Application->Workbooks->Add();

$ws = $wb->Worksheets(1);



$xra = $ws->Range("A1:A6");



$bs = $xra->Borders(xlEdgeBottom);

$bs->LineStyle = xlContinuous;

$bs->Weight = xlThin;

$bs->ColorIndex = xlAutomatic;



?>



It is pointless to try to use text strings, i.e.



<?php



$bs = $xra->Borders('xlEdgeBottom');

$bs->Weight = 'xlThin';



?>



this will cause an error: Unable to set property Weight of class Border ...

ilayansmano at gmail dot com 26-Aug-2008 01:39


Extracting text from Word Documents via PHP and COM





<?php


$word = new COM("word.application") or die ("Could not initialise MS Word object.");


$word->Documents->Open(realpath("Sample.doc"));





// Extract content.


$content = (string) $word->ActiveDocument->Content;





echo $content;





$word->ActiveDocument->Close(false);





$word->Quit();


$word = null;


unset($word);


?>