(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.