Constructeur de la classe com

# com::__construct

(PHP 4 > 4.1.0, PHP 5, PHP 7, PHP 8)

com::__construct — Constructeur de la classe com

### Description

public function com::__construct(
string `$module_name`,
array|string|null `$server_name` = `null`,
int `$codepage` = `CP_ACP`,
string `$typelib` = ""
)

Construit un nouvel objet com.

### 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 ; il ne faudra 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.

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open