(PHP 4 > 4.1.0, PHP 5, PHP 7, PHP 8)
com::__construct — Der com-Klassenkonstruktor
$module_name
,$server_name
= null
,$codepage
= CP_ACP
,$typelib
= ""Erstellt ein neues com-Objekt.
module_name
Word.Application
Eine Klassen-ID ist die UUID, die eine bestimmte Klasse eindeutig identifiziert. Ein Moniker ist eine spezielle Form der Benennung, die dem Konzept eines URL-Schemas ähnelt, das eine Ressource identifiziert und angibt, wie sie geladen werden soll. Beispielsweise könnten Sie Word laden und ein Objekt erzeugen, das ein Word-Dokument repräsentiert, indem Sie den vollständigen Pfad zum Word-Dokument als Modulnamen angeben, oder Sie können LDAP:
als einen Moniker verwenden, um das ADSI-Interface zu LDAP zu nutzen. server_name
null
, wird das Objekt mit dem Standardwert für diese Applikation ausgeführt. Der Standardwert ist typischerweise die Ausführung auf der lokalen Maschine, obwohl der Administrator die Applikation so konfiguriert haben kann, dass sie auf einer anderen Maschine startet. Wenn ein Nicht-null
-Wert als Server angeben wird, weist PHP das Laden des Objekts zurück, es sei denn, die php.ini-Option com.allow_dcom ist auf true
gesetzt. Wenn server_name
ein Array ist, sollte es die folgenden Elemente enthalten (Groß- und Kleinschreibung wird berücksichtigt!). Es ist zu beachten, dass alle Elemente optional sind (obwohl bei der Angabe eines Benutzernamens auch ein Passwort angeben werden muss). Wenn die Server-Einstellung weggelassen wird, wird der Standardserver verwendet (wie oben beschrieben) und die Instanziierung des Objekts ist nicht von der php.ini-Direktive com.allow_dcom betroffen.
Schlüssel | Typ | Beschreibung |
---|---|---|
Server | string | Der Name des Servers. |
Username | string | Der Benutzername, der für die Verbindung verwendet wird. |
Password | string | Das Passwort für Benutzername . |
Domain | string | Die Domain des Server s. |
Flags | integer | Eine oder mehrere der folgenden Konstanten, mittels logischem ODER verknüpft: CLSCTX_INPROC_SERVER , CLSCTX_INPROC_HANDLER , CLSCTX_LOCAL_SERVER , CLSCTX_REMOTE_SERVER , CLSCTX_SERVER und CLSCTX_ALL . Wenn nichts anderes angegeben ist, wird als Standardwert CLSCTX_SERVER angenommen, sofern auch der Server weggelassen wurde. Ist der Server angegeben, wird CLSCTX_REMOTE_SERVER verwendet. Weitere Informationen über die Bedeutung dieser Konstanten können der Microsoft-Dokumentation für CoCreateInstance entnommen werden; in der Regel werden sie nie benötigt. |
codepage
CP_ACP
(verwende die Standard-ANSI-Codepage des Systems - das ist der Standardwert, wenn dieser Parameter ausgelassen wird), CP_MACCP
, CP_OEMCP
, CP_SYMBOL
, CP_THREAD_ACP
(verwende die Codepage/Locale, die für den aktuell ausgeführten Thread angegeben wurde), CP_UTF7
und CP_UTF8
. Ebenfalls kann die Nummer einer bestimmten Codepage verwendet werden; weitere Details zu Codepages und ihren numerischen Werten können der Microsoft-Dokumentation entnommen werden.