<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/faq.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'de',
  ),
  'this' => 
  array (
    0 => 'faq.com.php',
    1 => 'PHP und COM',
    2 => 'PHP und COM',
  ),
  'up' => 
  array (
    0 => 'faq.php',
    1 => 'FAQ',
  ),
  'prev' => 
  array (
    0 => 'faq.html.php',
    1 => 'PHP und HTML',
  ),
  'next' => 
  array (
    0 => 'faq.misc.php',
    1 => 'Verschiedene Fragen',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'de',
    'path' => 'faq/com.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="faq.com" class="chapter">
  <h1 class="title">PHP und COM</h1>

  

   <p class="para">
    PHP kann auf Win32-Plattformen benutzt werden, um auf COM- und DCOM-Objekte
    zuzugreifen.
   </p>

  <div class="qandaset"><ol class="qandaset_questions"><li><a href="#faq.com.q1">
     
      Ich habe eine DLL-Datei erstellt, um etwas zu berechnen.
      Kann ich diese DLL-Datei auch in PHP benutzen?
     
    </a></li><li><a href="#faq.com.q2">
     
      Was bedeutet &quot;Unsupported variant type: xxxx (0xxxxx)&quot;?
     
    </a></li><li><a href="#faq.com.q3">
     
      Ist es m&ouml;glich, visuelle Objekte in PHP zu ver&auml;ndern?
     
    </a></li><li><a href="#faq.com.q4">
     
      Kann ich ein COM-Objekt in einer Session speichern?
     
    </a></li><li><a href="#faq.com.q5">
     
      Wie kann ich COM-Fehler abfangen?
     
    </a></li><li><a href="#faq.com.q6">
     
      Kann ich DLL-Dateien aus PHP-Skripten wie in Perl generieren?
     
    </a></li><li><a href="#faq.com.q7">
     
      Was bedeutet &quot;Unable to obtain IDispatch interface for CLSID
      {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}&quot;?
     
    </a></li><li><a href="#faq.com.q8">
     
      Wie kann ich ein COM-Object von einem entfernten Server ausf&uuml;hren?
     
    </a></li><li><a href="#faq.com.q9">
     
      Ich bekomme die Meldung &quot;DCOM is disabled in C:\path...\scriptname.php on
      line 6&quot; angezeigt, was kann ich tun?
     
    </a></li><li><a href="#faq.com.q10">
     
      Ist es m&ouml;glich ein ActiveX-Objekt auf einer Seite mit PHP zu
      laden/manipulieren?
     
    </a></li><li><a href="#faq.com.q11">
     
      Ist es m&ouml;glich, eine laufende Instanz einer Komponente zu erhalten?
     
    </a></li><li><a href="#faq.com.q12">
     
      Gibt es einen Weg, um ein Ereignis von einem COM-Objekt zu verarbeiten?
     
    </a></li><li><a href="#faq.com.q13">
     
      Ich habe Probleme, wenn ich versuche eine Methode eines COM-Objekts
      auszuf&uuml;hren, die mehr als ein Interface implementiert. Was kann ich tun?
     
    </a></li><li><a href="#faq.com.q14">
     
      PHP funktioniert mit COM, aber was ist mit COM+?
     
    </a></li><li><a href="#faq.com.q15">
     
      Wenn PHP COM-Objekte manipulieren kann, k&ouml;nnten wir in Zukunft MTS in
      Verbindung mit PHP benutzen, um Komponenten-Ressourcen zu verwalten?
     
    </a></li></ol></div>
   <dl class="qandaentry" id="faq.com.q1">
    <dt><strong>
     
      Ich habe eine DLL-Datei erstellt, um etwas zu berechnen.
      Kann ich diese DLL-Datei auch in PHP benutzen?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Wenn es eine einfache DLL-Datei ist, gibt es noch keinen Weg diese auch
      in PHP zu benutzen. Wenn die DLL-Datei aber einen COM-Server enthält,
      können Sie diese möglicherweise benutzen, wenn sie das
      IDispatch-Interface implementiert.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q2">
    <dt><strong>
     
      Was bedeutet &quot;Unsupported variant type: xxxx (0xxxxx)&quot;?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Es gibt dutzende VARIANT-Typen und -Kombination. Die meisten werden
      bereits unterstützt, aber es gibt immer noch einige, die noch
      implementiert werden müssen. Arrays werden zum Beispiel noch nicht
      vollständig unterstützt. Nur eindimensional indexierte Arrays können
      zwischen PHP und COM ausgetauscht werden. Wenn Sie andere Typen finden,
      die nicht unterstützt werden, melden Sie diese bitte als Bug (wenn sie
      nicht schon gemeldet wurden) und stellen so viele Informationen zur
      Verfügung wie möglich.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q3">
    <dt><strong>
     
      Ist es möglich, visuelle Objekte in PHP zu verändern?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Generell ja, aber da PHP normalerweise als Web-Skriptsprache verwendet
      wird, läuft es im Webserver-Kontext, also werden visuelle Objekte niemals
      auf dem Desktop des Servers erscheinen. Wenn Sie PHP für
      Anwendungsskripting benutzen, zum Beispiel in Verbindung mit PHP-GTK,
      gibt es keine Limitation bei Zugriff und Veränderung von visuellen
      Objekten durch COM.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q4">
    <dt><strong>
     
      Kann ich ein COM-Objekt in einer Session speichern?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Nein, können Sie nicht. COM-Instanzen werden als Ressourcen behandelt und
      können somit nur im Kontext eines einzelnen Skripts benutzt werden.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q5">
    <dt><strong>
     
      Wie kann ich COM-Fehler abfangen?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Die COM-Erweiterung wirft eine <code class="literal">com_exception</code>, die Sie
      abfangen und dann das <code class="literal">code</code>-Member inspizieren können,
      um zu bestimmen, wie fortzufahren ist.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q6">
    <dt><strong>
     
      Kann ich DLL-Dateien aus PHP-Skripten wie in Perl generieren?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Nein, leider gibt es kein Tool, das für PHP verfügbar ist.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q7">
    <dt><strong>
     
      Was bedeutet &quot;Unable to obtain IDispatch interface for CLSID
      {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}&quot;?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Dieser Fehler kann mehrere Gründe haben:
      <ul class="itemizedlist">
       <li class="listitem">
         <span class="simpara">
          Die CLSID ist falsch
         </span>
        </li>
       <li class="listitem">
         <span class="simpara">
          Die angeforderte DLL-Datei fehlt
         </span>
        </li>
       <li class="listitem">
         <span class="simpara">
          Die angeforderte Komponente implementiert das IDispatch-Interface nicht.
         </span>
        </li>
       </ul>
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q8">
    <dt><strong>
     
      Wie kann ich ein COM-Object von einem entfernten Server ausführen?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Genauso, wie Sie lokale COM-Objekte ausführen. Sie müssen nur die IP des
      entfernten Rechners als zweiten Parameter an den COM-Konstruktor
      übergeben.
     </p>
     <p class="para">
      Stellen Sie sicher, dass Sie
      <a href="com.configuration.php#ini.com.allow-dcom" class="link">com.allow_dcom</a><code class="literal">=</code><strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>
      in der <var class="filename">php.ini</var> gesetzt haben.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q9">
    <dt><strong>
     
      Ich bekomme die Meldung &quot;DCOM is disabled in C:\path...\scriptname.php on
      line 6&quot; angezeigt, was kann ich tun?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Bearbeiten Sie die <var class="filename">php.ini</var> und setzen Sie
      <a href="com.configuration.php#ini.com.allow-dcom" class="link">com.allow_dcom</a><code class="literal">=</code><strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q10">
    <dt><strong>
     
      Ist es möglich ein ActiveX-Objekt auf einer Seite mit PHP zu
      laden/manipulieren?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Das hat nichts mit PHP zu tun. ActiveX-Objekte werden beim Benutzer
      geladen, wenn sie vom HTML-Dokument angefordert werden. Es gibt keine
      Verbindung zum PHP-Skript, also ist auch keine direkte Interaktion auf
      der Seite des Servers möglich.
     </p>
    </dd>
   </dl>
   <dl class="qandaentry" id="faq.com.q11">
    <dt><strong>
     
      Ist es möglich, eine laufende Instanz einer Komponente zu erhalten?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Mithilfe von Monikern ist das möglich. Wenn Sie mehrere Referenzen zum
      selben Word-Exemplar erhalten möchten, können Sie dieses Exemplar
      erstellen, wie hier beschrieben:
     </p>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$word </span><span style="color: #007700">= new </span><span style="color: #0000BB">COM</span><span style="color: #007700">(</span><span style="color: #DD0000">"C:\docs\word.doc"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

     <p class="para">
      Dieser Code erstellt ein neues Exemplar, wenn kein laufendes Exemplar
      verfügbar ist, oder er gibt ein Handle zum laufenden Exemplar zurück,
      wenn dieses verfügbar ist.
     </p>
    </dd>
   </dl>
   <dl class="qandaentry" id="faq.com.q12">
    <dt><strong>
     
      Gibt es einen Weg, um ein Ereignis von einem COM-Objekt zu verarbeiten?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Sie können einen Listener definieren und ihn mithilfe von
      <span class="function"><a href="function.com-event-sink.php" class="function">com_event_sink()</a></span> binden.
      Sie können <span class="function"><a href="function.com-print-typeinfo.php" class="function">com_print_typeinfo()</a></span> benutzen, um
      eine Listener-Skelettklasse von PHP erstellen zu lassen.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q13">
    <dt><strong>
     
      Ich habe Probleme, wenn ich versuche eine Methode eines COM-Objekts
      auszuführen, die mehr als ein Interface implementiert. Was kann ich tun?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      Die Antwort ist genauso einfach wie unbefriedigend. Wir wissen es nicht
      genau, aber wir glauben, dass Sie nichts tun können.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q14">
    <dt><strong>
     
      PHP funktioniert mit COM, aber was ist mit COM+?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      COM+ erweitert COM um ein Framework, um Komponenten über MTS und MSMQ zu
      verwalten, aber es gibt nichts Besonderes, das PHP unterstützen müsste,
      um solche Komponenten zu benutzen.
     </p>
    </dd>
   </dl>

   <dl class="qandaentry" id="faq.com.q15">
    <dt><strong>
     
      Wenn PHP COM-Objekte manipulieren kann, könnten wir in Zukunft MTS in
      Verbindung mit PHP benutzen, um Komponenten-Ressourcen zu verwalten?
     
    </strong></dt>
    <dd class="answer">
     <p class="para">
      PHP selbst verarbeitet Transaktionen noch nicht. Wenn also ein Fehler
      auftritt, wird kein Rollback gestartet. Wenn Sie Komponenten benutzen, die
      Transaktionen unterstützen, müssen Sie das Transaktions-Management selbst
      implementieren.
     </p>
    </dd>
   </dl>

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