<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.com.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'com.construct.php',
    1 => 'com::__construct',
    2 => 'Конструктор класса com',
  ),
  'up' => 
  array (
    0 => 'class.com.php',
    1 => 'com',
  ),
  'prev' => 
  array (
    0 => 'class.com.php',
    1 => 'com',
  ),
  'next' => 
  array (
    0 => 'class.dotnet.php',
    1 => 'dotnet',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/com/com/construct.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="com.construct" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">com::__construct</h1>
  <p class="verinfo">(PHP 4 &gt; 4.1.0, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">com::__construct</span> &mdash; <span class="dc-title">Конструктор класса com</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-com.construct-description">
  <h3 class="title">Описание</h3>
  <div class="constructorsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>com::__construct</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$module_name</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><span class="type"><a href="language.types.array.php" class="type array">array</a></span>|<span class="type"><a href="language.types.string.php" class="type string">string</a></span>|<span class="type"><a href="language.types.null.php" class="type null">null</a></span></span> <code class="parameter">$server_name</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$codepage</code><span class="initializer"> = <strong><code><a href="com.constants.php#constant.cp-acp">CP_ACP</a></code></strong></span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$typelib</code><span class="initializer"> = &quot;&quot;</span></span><br>)</div>

  <p class="para rdfs-comment">
   Создаёт объект класса com.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-com.construct-parameters">
  <h3 class="title">Список параметров</h3>
  <dl>
   
    <dt><code class="parameter">module_name</code></dt>
    <dd>
     <span class="simpara">
      ProgID, Class ID или Moniker, указывающий на компонент для загрузки.
     </span>
     <span class="simpara">
      Обычно ProgID - это имя приложения или DLL и имя объекта, разделённые точкой. Например: <code class="literal">Word.Application</code>.
     </span>
     <span class="simpara">
      Class ID - это UUID, уникальный для заданного класса.
     </span>
     <span class="simpara">
      Moniker - специальная форма именования, похожая по
      концепции к URL, которая идентифицирует ресурс и
      способ его загрузки. Например, вы можете загрузить Word и
      получить объект, представляющий документ, указав полный
      путь к документу word как имя модуля, либо же использовать  <code class="literal">LDAP:</code> в качестве моникера для использования
      ADSI интерфейса к LDAP.
     </span>
    </dd>
   
   
    <dt><code class="parameter">server_name</code></dt>
    <dd>
     <span class="simpara">
      Имя сервера DCOM, на котором компонент должен быть
      загружен и запущен. Если задано как <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, объект будет
      запущен для сервере по умолчанию для приложения. Обычно
      сервер по умолчанию - это локальный компьютер, если
      администратор не сконфигурировал иначе.
     </span>
     <span class="simpara">
      Если для сервера указано значение отличное от <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, PHP не будет
      загружать объект, пока вы не установите опцию конфигурации <var class="filename">php.ini</var>
      <a href="com.configuration.php#ini.com.allow-dcom" class="link">com.allow_dcom</a> в <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>.
     </span>
     <p class="para">
      Если <code class="parameter">server_name</code> задан как массив,
      то этот массив должен содержать следующие элементы (регистр
      символов важен). Обратите внимание, что они все необязательные
      (единственно, что Username и Password должны идти парой);
      Если вы не укажете Server, то будет выбран сервер по
      умолчанию и создание объекта не будет зависеть от значения
      настройки директивы <var class="filename">php.ini</var> <a href="com.configuration.php#ini.com.allow-dcom" class="link">com.allow_dcom</a>.
      <table class="doctable table">
       <caption><strong>Имя сервера DCOM</strong></caption>
       
        <thead>
         <tr>
          <th>ключ</th>
          <th>тип</th>
          <th>описание</th>
         </tr>

        </thead>

        <tbody class="tbody">
         <tr>
          <td>Server</td>
          <td>string</td>
          <td>Имя сервера.</td>
         </tr>

         <tr>
          <td>Username</td>
          <td>string</td>
          <td>Имя пользователя.</td>
         </tr>

         <tr>
          <td>Password</td>
          <td>string</td>
          <td>Пароль для <code class="literal">Username</code>.</td>
         </tr>

         <tr>
          <td>Domain</td>
          <td>string</td>
          <td>Домен для <code class="literal">server</code>.</td>
         </tr>

         <tr>
          <td>Flags</td>
          <td>integer</td>
          <td>Одна или несколько констант, объединённых логическим ИЛИ:
           <strong><code><a href="com.constants.php#constant.clsctx-inproc-server">CLSCTX_INPROC_SERVER</a></code></strong>,
           <strong><code><a href="com.constants.php#constant.clsctx-inproc-handler">CLSCTX_INPROC_HANDLER</a></code></strong>,
           <strong><code><a href="com.constants.php#constant.clsctx-local-server">CLSCTX_LOCAL_SERVER</a></code></strong>,
           <strong><code><a href="com.constants.php#constant.clsctx-remote-server">CLSCTX_REMOTE_SERVER</a></code></strong>,
           <strong><code><a href="com.constants.php#constant.clsctx-server">CLSCTX_SERVER</a></code></strong> и
           <strong><code><a href="com.constants.php#constant.clsctx-all">CLSCTX_ALL</a></code></strong>. Значение по
           умолчанию <strong><code><a href="com.constants.php#constant.clsctx-server">CLSCTX_SERVER</a></code></strong>, если
           <code class="literal">Server</code> не задан и
           <strong><code><a href="com.constants.php#constant.clsctx-remote-server">CLSCTX_REMOTE_SERVER</a></code></strong>, если
           задан. Про назначение этих констант можно прочитать
           в документации Microsoft по CoCreateInstance.
           Но в реальности они вам вряд ли понадобятся.
          </td>
         </tr>

        </tbody>
       
      </table>

     </p>
    </dd>
   
   
    <dt><code class="parameter">codepage</code></dt>
    <dd>
     <span class="simpara">
      Кодовая страница для преобразования в юникод и обратно.
      Конвертация происходит когда строка PHP передаётся как
      параметр COM объекту и когда от него приходит ответ.
      Обратите внимание, что данная кодовая страница будет
      использоваться для всех объектов и вариантов, возвращаемых
      данным объектом.
     </span>
     <span class="simpara">
      Допустимые значения:
      <strong><code><a href="com.constants.php#constant.cp-acp">CP_ACP</a></code></strong> (Значение по умолчанию. Системная кодовая страница ANSI),
      <strong><code><a href="com.constants.php#constant.cp-maccp">CP_MACCP</a></code></strong>,
      <strong><code><a href="com.constants.php#constant.cp-oemcp">CP_OEMCP</a></code></strong>, <strong><code><a href="com.constants.php#constant.cp-symbol">CP_SYMBOL</a></code></strong>,
      <strong><code><a href="com.constants.php#constant.cp-thread-acp">CP_THREAD_ACP</a></code></strong> (Использовать кодовую
      страницу/локаль, установленную для запущенного потока), <strong><code><a href="com.constants.php#constant.cp-utf7">CP_UTF7</a></code></strong>
      и <strong><code><a href="com.constants.php#constant.cp-utf8">CP_UTF8</a></code></strong>. Также можно использовать
      число, обозначающее кодовую страницу. Подробности
      читайте в документации Microsoft.
     </span>
    </dd>
   
  </dl>
 </div>


</div><?php manual_footer($setup); ?>