|
內置於PHP4裏的COM函數對於我們在win32環境下開發程序是相當有吸引力的，但是至今仍沒有多少相關的技術文檔。本文將以三個例子分別處理 MS office 2000 Word 、 Excel 、 Adobe Distiller 來說明如何在PHP中使用COM函數。
COM技術是由Microsoft在幾年前提出並開發的，本文中提到的相關名詞有OLE, OLE Automation，ActiveX, COM ，這些詞的意思都基本一樣，都表示用一段封裝的代碼（對象）來完成一個windows 應用程序的一些功能。 PHP4 COM 函數可以連接一個對象實例，並使用它的方法與屬性。
如果你想使用下面的例子源碼，請參考一下我的配置。
Windows 98 - MS Office 2000
Apache 1.3.9 Windows
PHP4.02 Dev （08-20-00） Running as CGI
PHP4中的COM標記
現在讓我們開始吧，用PHP4的COM來實例化一個組件，需要 new 操作符和對象的 "OLE 程序標識"：
$instance = new COM（"$identifier"）;
?＞
因爲COM是一個PHP4的保留字，它傳送這個對象的標識給一個構造函數，現在得到了這個組件的一個實例，根據OOP類的性質，我們可以很容易地訪問它的方法與屬性。
例如：
$instance-＞[Object]-＞[method1]-＞[method2]-＞..-＞[property];
?＞
就是這麼簡單！
OOP的結構在PHP下不能工作，（由於PHP語法的問題，屬性的名字.值是非法字符，如點和圓括號等），所以PHP4提供了兩個相應的函數：
bool com_set（class com_object, string property name, string property_value）;
mixed com_get（class com_object, string property_name）;
?＞
最後，PHP4也支持DCOM技術，可以在遠程計算機創建一個對象實例。
$Instance = new COM（string "Component name", string "remote_server_address"）;
?＞
注意：這是用DCOM指令來設置PHP。在將來，PHP開發者提供Unix下對DCOM的支持。
標識、方法和屬性
標識是一個如下的字串：
MS Word: "Word.Application" or "Word.Application.9"
MS Excel: "Excel.Application" or "Excel.Sheet"
ADOBE Acrobat: "Exch.application" or "![]() dfDistiller.PdfDistiller"
對於最後一個標識，我要指明的是，獲得正確的對象標識名不是一件容易的事。如果你不能訪問VBA文檔，你可以查找一下windows的註冊表，在 HKEY_CLASSES_ROOT 中尋找一下，你就可以得到一些應用程序的名字。在你的機器上有效的對象標識放在 CLSID 子文件夾下。
應用程序一般會提供文檔說明它的COM方法和屬性。在office2000中，你可以運行程序，打開VBA編輯器 ，選擇對象編輯器。輸入應用程序庫中的一個方法名或屬性名，然後，在下面的窗口中用鼠標右鍵選擇一個類或成員名稱，點幫助，你就會得到關於這個類或成員的描述。你也可以參考 MSDN。一個 Excel 的例子如下： http://msdn.microsoft.com/librar ... odelapplication.htm 用COM函數操作 MS Word
現在，我們開始第一個例子吧：
#*********************************************************
# 本例來自Zend站點，略有改動
# 打開一個word實例，並新建一個文檔Useless test.doc
# 輸入一行文字 "This is a test2..."
#*********************************************************
#實例化一個對象
$word = new COM（"word.application"） or die（"Unable to instantiate Word"）;
#取得並顯示版本
print "Loaded Word, version {$word-＞Version}
";
#另一種方法去取得版本
$testversion = com_get（$word-＞application,version）;
print "Version using Com_get（）: $testversion
";
#使其可見
$word-＞Visible = 1;
#創建新文件
$word-＞Documents-＞Add（）;
#寫字符
$word-＞Selection-＞TypeText（"This is a test..."）;
#保存
$word-＞Documents[1]-＞SaveAs（"Useless test.doc"）;
#關閉
$word-＞Quit（）;
?＞
你只要花幾分鐘來讀這個程序，並參考Word的OLE 技術文檔，你將學到幾乎是你在自己程序中所需的全部的操作。
MS Excel在使用PHP的COM函數
如同上面的Word的例子一樣，你應學習這個例子的同時參考Excel的Visual Basic 編輯器中的對象瀏覽器的幫助文檔。
#打開workbook和它的sheet，
#本例使用一個電子表格是Excel安裝時自帶的SOLVSAMP.XLS
$workbook = "C![]() rogram FilesMicrosoft officeOfficeSamplesSOLVSAMP.XLS";
$sheet = "Quick Tour";
#實例化一個組件的對象
$ex = new COM（"Excel.sheet"） or Die （"Did not connect"）;
#取程序名稱和版本
print "Application name:{$ex-＞Application-＞value}
" ;
print "Loaded version: {$ex-＞Application-＞version}
";
#打開工作本使我們可使用它
$wkb = $ex-＞application-＞Workbooks-＞Open（$workbook） or Die （"Did not open"）;
#預保存原來的工作本，創建一個工作本的複本
$ex-＞Application-＞ActiveWorkbook-＞SaveAs（"Ourtest"）;
#$ex-＞Application-＞Visible = 1; #本句去註釋讓Excel可見
# 讀寫一個單元格在一個新的工作表中
# 我們可以讀到這個單元格 E11 （Advertising in the 4th. Quarter）
$sheets = $wkb-＞Worksheets（$sheet）; #Select the sheet
$sheets-＞activate; #Activate it
$cell = $sheets-＞Cells（11,5） ; #Select the cell （Row Column number）
$cell-＞activate; #Activate the cell
print "Old Value = {$cell-＞value}
"; #Print the value of the cell:10000
$cell-＞value = 15000; #Change it to 15000
print "New value = {$cell-＞value}
";#Print the new value=15000
#最後，用新值重新計算這個單元格
$sheets-＞Calculate;
#必須的如果要計算，手動則是可選的
#可看到效果總價值（E13單元格）
$cell = $sheets-＞Cells（13,5） ; #Select the cell （Row Column number）
$number = Number_format（$cell-＞value）;
print "New Total cost =$$number - was $47,732 before.
";
#根據計算公式，廣告影響了公司的開銷，這裏將顯示 $57,809
#使用Excel內建的函數
# PMT（percent/12 months,Number of payments,Loan amount）
$pay = $ex-＞application-＞pmt（0.08/12,10,10000）;
$pay = sprintf（"%.2f",$pay）;
print "Monthly payment for $10,000 loan @8% interest /10 months: $ $pay
";
#Should print monthly payment = $ -1,037.03
#可選，保存
$ex-＞Application-＞ActiveWorkbook-＞SaveAs（"Ourtest"）;
#關閉，不提問
$ex-＞application-＞ActiveWorkbook-＞Close（"False"）;
unset （$ex）;
?＞
這個例子讓你的PHP與Excel一同工作了，當然，也有更多的對象可以使用，訪問一個自已寫的OOP封裝類也與訪問excel一樣容易。
用PHP的COM訪問 Adobe Distiller
這最後一個例子不是MS程序了，如果你的程序有一個PostScript文件，你會對這個有興趣的，改寫（蒸餾）它成爲一個PDF文檔. Adobe 有一個程序叫 Distiller ，它可以生成一個實例。代碼如下：
$pdf = new COM（"pdfdistiller.pdfdistiller.1"）;
?＞
有一點要注意的，是在Distiller 的文檔中給出的這個OLE標識名 "pdfdistiller" 是無效的。
蒸餾一個文件的最基本的方法是：
$pdf-＞FileToPdf （$psfile, strOutputPDF '', strJobOptions ""）;
?＞
這 $psfile 是這個PostScript的文件名, strOutputPDF 是輸出文件PDF的文件名。 StrJobOptions 是Distiller的參數文件名，最後兩個參數是可選的，默認是同一名字。 這PS文件名與PDF文件名，使用這個默認的Job options 文件。例如：
$pdf-＞FileToPdf （$psfile, "", ""）;
#這兒$psfile 可以是 Myfile.ps 將返回 Myfile.pdf 文件。
?＞
在Distiller中有更多的方法和屬性能被用。如果你感興趣，請參考一下Adobe的技術文檔。
中止/可能的問題
如果你的代碼中發生了什麼錯誤，你可能會創建了一個實例，但沒有正常地關閉它。最糟的是，這個應用程序可能被這個實例所保持，結果，在你的程序列表中就存在多份這個程序的副本，即使你更正了這個錯誤也會干擾你的結果。解決方法是：修正一個bug以來要及時清除它們在你重新開始運行之前，用 並結束任務。同樣的原因，在你的代碼最後，也要及時關閉這個程序並刪除這個實例。
你有一些技巧在處理 com_get 和 com_set的異常時。例如：
$Version = Com_get（$instance-＞Application,"Version"）;
將會在Word中工作但在Excel中會產生一個錯誤。
有一些對象在PHP4中是不能實例化的，這是因爲這個程序要一個自定義的接口，但PHP4不支持。
爲什麼我們要用它？
我希望這三個例子可以給你一些思考的線索，PHP的COM允許你在PHP的腳本中訪問windows4的程序。這個代碼比ASP簡單並且能集成其它的PHP對數據庫強大的支持功能。Microsoft 在各個方面都大力銷售這個COM 技術，在不同的名稱和結構下，如 COM+（Combine COM with Microsoft Transaction Server MTS）, ADO, OLE DB, OWC, Windows DNA, 等等。 PHP 和 Apache的結合，提供了一個開放源碼的解決方案。
|
dfDistiller.PdfDistiller" 
rogram FilesMicrosoft officeOfficeSamplesSOLVSAMP.XLS"; 
