8.12.10.2 Méthodes

com  COM::COM ( string   module_name , mixed   server_name , int   codepage , string   typelib )

Constructeur de la classe COM. Paramètres :

module_name

Peut être un ProgID, un Class ID ou un Moniker qui nomment un composant à charger.

Un ProgID est typiquement une application ou le nom d'une DLL, suivi d'une période, suivi par le nom de l'objet. e.g : Word.Application .

Un Class ID est un UUID qui identifie de manière unique une classe donnée.

Un Moniker est une manière spéciale de nommage, similaire dans le concept au schéma d'URL, qui identifie une ressource et spécifie comment elle doit être chargée. Par exemple, vous pouvez charger Word et prendre un objet représentant un document Word en spécifiant le chemin complet du document Word comme nom de module, ou bien, vous pouvez utiliser LDAP: comme un Moniker pour utiliser l'interface ADSI pour LDAP.

server_name

Le nom du serveur DCOM sur lequel le composant devrait être chargé et lancé. Si le paramètre vaut NULL , l'objet courant utilisera la valeur par défaut pour l'application. La valeur par défaut est typiquement localhost bien que l'administrateur peut avoir configuré l'application pour qu'elle s'exécute sur une machine différente.

Si vous spécifiez une valeur non- NULL pour le serveur, PHP peut refuser de charger l'objet tant que com.allow_dcom l'option de configuration ne vaut pas TRUE .

Si server_name est un tableau, il doit contenir les éléments suivants (sensible à la casse). Notez qu'ils sont tous optionnels (bien que vous devez spécifier et USERNAME, et PASSWORD) ; si vous omettez les paramètres du serveur, le serveur par défaut sera utiliser (comme mentionné plus haut), et l'instanciation de l'objet ne sera pas affecté par com.allow_dcom la directive.

clé server_name	type	description
Server	chaîne	Le nom du serveur.
Username	chaîne	L'utilisateur de connexion.
Password	chaîne	Le mot de passe de l'utilisateur Username .
Flags	entier	Une ou plusieurs des constantes suivantes CLSCTX_INPROC_SERVER , CLSCTX_INPROC_HANDLER , CLSCTX_LOCAL_SERVER , CLSCTX_REMOTE_SERVER , CLSCTX_SERVER et CLSCTX_ALL . La valeur par défaut est CLSCTX_SERVER si vous omettez également Server , ou bien CLSCTX_REMOTE_SERVER si vous spécifiez un serveur. Vous devriez consulter la dcumentation Mcrosoft concernant CoCreateInstance pour plus d'informations sur cesconstantes ; vous ne devriez pas les utiliser dans un cas typique.

codepage

Spécifie le code qui est utilisé pour transformer les chaînes de caractères PHP en chaînes unicode, et vice-versa. La conversion est appliquée même si une chaîne PHP est passée en paramètre ou bien retournée d'une méthode de cette objet COM. Le code est "collé" en PHP 5, ce qui siginifie qu'il se propagera aux objets et aux variables retournés par cette objet.

Les valeurs possibles sont : CP_ACP (utilise le code système par défaut d'ANSI - valeur par défaut si le paramètre est omis), CP_MACCP , CP_OEMCP , CP_SYMBOL , CP_THREAD_ACP (utilise la valeur du code local pour l'exécution courant), CP_UTF7 et CP_UTF8 . Vous devriez également utiliser le numéro pour un code donné ; consultez la documentation de Microsoft pour plus de détails sur les codes et leurs valeurs numériques.