PHP 8.4.2 Released!

    PHP und COM

    PHP kann auf Win32-Plattformen benutzt werden, um auf COM- und DCOM-Objekte zuzugreifen.

    1. Ich habe eine DLL-Datei erstellt, um etwas zu berechnen. Kann ich diese DLL-Datei auch in PHP benutzen?
    2. Was bedeutet "Unsupported variant type: xxxx (0xxxxx)"?
    3. Ist es möglich, visuelle Objekte in PHP zu verändern?
    4. Kann ich ein COM-Objekt in einer Session speichern?
    5. Wie kann ich COM-Fehler abfangen?
    6. Kann ich DLL-Dateien aus PHP-Skripten wie in Perl generieren?
    7. Was bedeutet "Unable to obtain IDispatch interface for CLSID {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}"?
    8. Wie kann ich ein COM-Object von einem entfernten Server ausführen?
    9. Ich bekomme die Meldung "DCOM is disabled in C:\path...\scriptname.php on line 6" angezeigt, was kann ich tun?
    10. Ist es möglich ein ActiveX-Objekt auf einer Seite mit PHP zu laden/manipulieren?
    11. Ist es möglich, eine laufende Instanz einer Komponente zu erhalten?
    12. Gibt es einen Weg, um ein Ereignis von einem COM-Objekt zu verarbeiten?
    13. Ich habe Probleme, wenn ich versuche eine Methode eines COM-Objekts auszuführen, die mehr als ein Interface implementiert. Was kann ich tun?
    14. PHP funktioniert mit COM, aber was ist mit COM+?
    15. Wenn PHP COM-Objekte manipulieren kann, könnten wir in Zukunft MTS in Verbindung mit PHP benutzen, um Komponenten-Ressourcen zu verwalten?
    Ich habe eine DLL-Datei erstellt, um etwas zu berechnen. Kann ich diese DLL-Datei auch in PHP benutzen?

    Wenn es eine einfache DLL-Datei ist, gibt es noch keinen Weg diese auch in PHP zu benutzen. Wenn die DLL-Datei aber einen COM-Server enthält, können Sie diese möglicherweise benutzen, wenn sie das IDispatch-Interface implementiert.

    Was bedeutet "Unsupported variant type: xxxx (0xxxxx)"?

    Es gibt dutzende VARIANT-Typen und -Kombination. Die meisten werden bereits unterstützt, aber es gibt immer noch einige, die noch implementiert werden müssen. Arrays werden zum Beispiel noch nicht vollständig unterstützt. Nur eindimensional indexierte Arrays können zwischen PHP und COM ausgetauscht werden. Wenn Sie andere Typen finden, die nicht unterstützt werden, melden Sie diese bitte als Bug (wenn sie nicht schon gemeldet wurden) und stellen so viele Informationen zur Verfügung wie möglich.

    Ist es möglich, visuelle Objekte in PHP zu verändern?

    Generell ja, aber da PHP normalerweise als Web-Skriptsprache verwendet wird, läuft es im Webserver-Kontext, also werden visuelle Objekte niemals auf dem Desktop des Servers erscheinen. Wenn Sie PHP für Anwendungsskripting benutzen, zum Beispiel in Verbindung mit PHP-GTK, gibt es keine Limitation bei Zugriff und Veränderung von visuellen Objekten durch COM.

    Kann ich ein COM-Objekt in einer Session speichern?

    Nein, können Sie nicht. COM-Instanzen werden als Ressourcen behandelt und können somit nur im Kontext eines einzelnen Skripts benutzt werden.

    Wie kann ich COM-Fehler abfangen?

    Die COM-Erweiterung wirft eine com_exception, die Sie abfangen und dann das code-Member inspizieren können, um zu bestimmen, wie fortzufahren ist.

    Kann ich DLL-Dateien aus PHP-Skripten wie in Perl generieren?

    Nein, leider gibt es kein Tool, das für PHP verfügbar ist.

    Was bedeutet "Unable to obtain IDispatch interface for CLSID {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}"?

    Dieser Fehler kann mehrere Gründe haben:

    • Die CLSID ist falsch
    • Die angeforderte DLL-Datei fehlt
    • Die angeforderte Komponente implementiert das IDispatch-Interface nicht.

    Wie kann ich ein COM-Object von einem entfernten Server ausführen?

    Genauso, wie Sie lokale COM-Objekte ausführen. Sie müssen nur die IP des entfernten Rechners als zweiten Parameter an den COM-Konstruktor übergeben.

    Stellen Sie sicher, dass Sie com.allow_dcom=true in der php.ini gesetzt haben.

    Ich bekomme die Meldung "DCOM is disabled in C:\path...\scriptname.php on line 6" angezeigt, was kann ich tun?

    Bearbeiten Sie die php.ini und setzen Sie com.allow_dcom=true.

    Ist es möglich ein ActiveX-Objekt auf einer Seite mit PHP zu laden/manipulieren?

    Das hat nichts mit PHP zu tun. ActiveX-Objekte werden beim Benutzer geladen, wenn sie vom HTML-Dokument angefordert werden. Es gibt keine Verbindung zum PHP-Skript, also ist auch keine direkte Interaktion auf der Seite des Servers möglich.

    Ist es möglich, eine laufende Instanz einer Komponente zu erhalten?

    Mithilfe von Monikern ist das möglich. Wenn Sie mehrere Referenzen zum selben Word-Exemplar erhalten möchten, können Sie dieses Exemplar erstellen, wie hier beschrieben:

    <?php
    $word     = new COM("C:\docs\word.doc");
    ?>

    Dieser Code erstellt ein neues Exemplar, wenn kein laufendes Exemplar verfügbar ist, oder er gibt ein Handle zum laufenden Exemplar zurück, wenn dieses verfügbar ist.

    Gibt es einen Weg, um ein Ereignis von einem COM-Objekt zu verarbeiten?

    Sie können einen Listener definieren und ihn mithilfe von com_event_sink() binden. Sie können com_print_typeinfo() benutzen, um eine Listener-Skelettklasse von PHP erstellen zu lassen.

    Ich habe Probleme, wenn ich versuche eine Methode eines COM-Objekts auszuführen, die mehr als ein Interface implementiert. Was kann ich tun?

    Die Antwort ist genauso einfach wie unbefriedigend. Wir wissen es nicht genau, aber wir glauben, dass Sie nichts tun können.

    PHP funktioniert mit COM, aber was ist mit COM+?

    COM+ erweitert COM um ein Framework, um Komponenten über MTS und MSMQ zu verwalten, aber es gibt nichts Besonderes, das PHP unterstützen müsste, um solche Komponenten zu benutzen.

    Wenn PHP COM-Objekte manipulieren kann, könnten wir in Zukunft MTS in Verbindung mit PHP benutzen, um Komponenten-Ressourcen zu verwalten?

    PHP selbst verarbeitet Transaktionen noch nicht. Wenn also ein Fehler auftritt, wird kein Rollback gestartet. Wenn Sie Komponenten benutzen, die Transaktionen unterstützen, müssen Sie das Transaktions-Management selbst implementieren.

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    8
    Anonymous
    19 years ago
    Re: The Windows English CHM Sample with MS Word Automation.

    I see that $Word->Release() is called after $Word->Quit().
    This seems to be erroneous. Actually, $Word->Release() should not have to be called if proper COM garbage collection is taking place. Release() is a C++ construction not used in either Visual Basic or VBScript or even MS-JScript. Just to be sure, however, I ran the sample through php.exe (5.04 CLI on Windows XP SP1 with Office 2003) and got a RPC failed error on the line containing $Word->Release(). The rest of the sample works fine, and the results are as expected. So, I propose 2 scenarios:
    1.There is a problem with the documentation (more likely).
    2.There is a problem with PHP504 itself, as this problem is reproduced with any COM Automation call, not just Word.
    up
    6
    junk.ghost@virgin dOtt net
    20 years ago
    It may be obvious to everyone else but...

    If you want to write your own COM DLL in MSVC++6 and you want to pass it a string, you need the following in your .idl file:

    HRESULT function_name([in] BSTR parameter_name,
    [retval, out] BSTR * retval);

    retval is the result of your function as a string to be passed back.

    BSTR is an unsigned short *, so if you want to use your string with STL string etc. you may need to convert parameters to and from char *.

    The burden of my message is that from PHP

    $comThing = new COM("comThing.comThing");
    print $comThing->function_name("Jeremy");

    Jeremy will be marshalled as wide chars, which match BSTR.
    up
    2
    codeslinger at compsalot dot com
    17 years ago
    in response to item #1 above: "If this is a simple DLL there is no way yet to run it from PHP."

    Answer: There are several different packages/add-ons to php that enable low level access to the windows api. One of the most popular of these packages is available at http://www.winbinder.org

    Winbinder does have the ability to load a dll and call it's functions. Winbinder also provides a large set of windows apis for creating windows and controls. This is useful for creating stand-alone desktop apps. It is a possible alternative to php-gtk.

    I've had mixed results with Winbinder, some things work very well, others are buggy; source code is available. It's worth a look, Evaluate carefully.
    ＋add a note
    To Top