com::__construct

Liste de paramètres

module_name

Peut être un ProgID, Class ID ou Moniker qui nomme le composant à charger. Un ProgID est typiquement le nom de l'application ou de la DLL, suivi d'un point, suivi du nom de l'objet. Par exemple : Word.Application. Un Class ID est l'UUID qui identifie uniquement une classe donnée. Un Moniker est une forme spéciale de nommage, similaire en concept à un schéma URL, qui identifie une ressource et spécifie comment elle devrait être chargée. Par exemple, il est possible de démarrer Word et récupérer un objet représentant un document word en spécifiant le chemin complet du document word en tant que nom de module, ou il est possible d'utiliser LDAP: en tant que Moniker pour utiliser l'interface ADSI à LDAP.

server_name

Le nom du serveur DCOM sur lequel le composant devrait être chargé et exécuté. Si null, l'objet est exécuté en utilisant le défaut pour l'application. La valeur par défaut est typiquement d'exécuter sur la machine locale, cependant l'administrateur peut avoir configuré l'application pour être lancée sur une machine différente. Si une valeur non-null est spécifiée pour le serveur, PHP refusera de charger l'objet à moins que l'option com.allow_dcom php.ini option soit définie à true.

Si server_name est un tableau, il devrait contenir les éléments suivants (sensible à la casse !). À noter qu'ils sont tous optionnels (cependant il faut définir l'Utilisateur et le Mot de Passe ensemble) ; si l'on omet le paramètre Server, le serveur par défaut sera utilisé (comme dit ci-dessus), et l'instanciation de l'objet ne sera pas affectée par la directive php.ini com.allow_dcom.

Nom de serveur DCOM

Clé	Type	Description
Server	chaîne de caractères	Le nom du serveur
Username	chaîne de caractères	Le nom d'utilisateur pour se connecter en tant que.
Password	chaîne de caractères	Le mot de passe pour Username.
Domain	chaîne de caractères	Le domaine du serveur.
Flags	entier	Une ou plusieurs des constantes suivantes, assemblées ensemble grâce au OU logique : CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER, CLSCTX_LOCAL_SERVER, CLSCTX_REMOTE_SERVER, CLSCTX_SERVER et CLSCTX_ALL. La valeur par défaut si non définie ici est CLSCTX_SERVER si l'on omet aussi Server, ou CLSCTX_REMOTE_SERVER si l'on définit un serveur. Il est recommandé de consulter la documentation de Microsoft pour CoCreateInstance pour plus d'information sur la signification de ces constantes ; on devra typiquement jamais les utiliser.

codepage

Définit la codepage qui est utilisée pour convertir les chaîne de caractères en chaîne de caractères unicode et vice versa. La conversion est appliquée quand une chaîne de caractères PHP est passée en tant que paramètre ou retournée depuis une méthode de cet objet COM. La codepage est "collante", ce qui signifie qu'elle sera propagée aux objets et variants retournés depuis l'objet. Les valeurs possibles sont : CP_ACP (utilise la code page ANSI système par défaut - par défaut si ce paramètre est omis), CP_MACCP, CP_OEMCP, CP_SYMBOL, CP_THREAD_ACP (utilise codepage/locale définie pour le thread en cours d'exécution ), CP_UTF7 et CP_UTF8. Il est aussi possible d'utiliser le numéro pour une codepage donnée ; consulter la documentation de Microsoft pour plus de détails sur les codepages et leurs valeurs numériques.