doc-fr/faq/com.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2bb07c8c43f028c665a33bfc08a22639e9e35dc6 Maintainer: gui Status: ready -->
<!-- Reviewed: yes -->

 <chapter xml:id="faq.com" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>PHP et COM</title>
  <titleabbrev>PHP et COM</titleabbrev>

   <para>
    PHP peut être utilisé pour accéder à des objets COM et DCOM sur les
    plates-formes Win32.
   </para>

  <qandaset>
   <qandaentry xml:id="faq.com.q1">
    <question>
     <para>
      J'ai compilé une DLL pour calculer quelque chose. Y a-t-il un moyen
      d'utiliser cette DLL sous PHP ?
     </para>
    </question>
    <answer>
     <para>
      Si c'est une DLL simple, il n'y a aucun moyen pour le moment de
      l'utiliser avec PHP. Si la DLL contient un serveur COM, vous pourrez
      l'utiliser si elle implémente l'interface IDispatch.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q2">
    <question>
     <para>
      Que signifie 'Unsupported variant type: xxxx (0xxxxx)' ?
     </para>
    </question>
    <answer>
     <para>
      Il y a des dizaines de types de VARIANT et de combinaisons entre elles.
      La plupart d'entre elles sont déjà supportées, mais quelques une ne sont
      toujours pas implémentées.
      Les tableaux ne sont pas complètement supportés. Seuls le tableaux
      unidimensionnels indexés peuvent être transmis entre PHP et COM.
      Si vous trouvez d'autres types qui ne sont pas supportés, reportez-les
      nous comme un bogue (si ce n'est pas déjà fait) et fournissez le plus
      d'informations possibles.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q3">
    <question>
     <para>
      Est-il possible de manipuler des objets visuels en PHP ?
     </para>
    </question>
    <answer>
     <para>
      Généralement, c'est possible, mais comme PHP est utilisé le plus
      souvent en tant que langage de script web et dans un environnement de
      serveur web, les objets visuels n'apparaîtront jamais sur le bureau du
      serveur.
      Si vous voulez utiliser PHP pour scripter des applications, par
      exemple avec PHP-GTK, il n'y a aucune limitation à accéder et
      manipuler des objets visuels via COM.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q4">
    <question>
     <para>
      Puis-je stocker un objet COM dans une session ?
     </para>
    </question>
    <answer>
     <para>
      Non, vous ne pouvez pas. Les instances COM sont traitées comme des
      ressources, ce qui signifie qu'elles ne sont disponibles que dans un
      seul contexte de script.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q5">
    <question>
     <para>
      Comment puis-je intercepter des erreurs COM ?
     </para>
    </question>
    <answer>
     <para>
      L'extension COM envoie des exceptions
      <literal>com_exception</literal>, que vous pouvez intercepter en
      inspectant le membre <literal>code</literal> pour déterminer que faire.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q6">
    <question>
     <para>
      Puis-je générer des fichiers DLL à partir de PHP comme je le fais avec
      Perl ?
     </para>
    </question>
    <answer>
     <para>
      Non, il n'y a malheureusement pas d'outil disponible pour le faire en
      PHP.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q7">
    <question>
     <para>
      Que signifie 'Unable to obtain IDispatch interface for CLSID {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}' ?
     </para>
    </question>
    <answer>
     <para>
      Cette erreur peut avoir plusieurs causes :
      <itemizedlist>
       <listitem>
         <simpara>
         le CLSID est incorrect
         </simpara>
        </listitem>
       <listitem>
         <simpara>
         la DLL demandée est introuvable
         </simpara>
        </listitem>
       <listitem>
         <simpara>
         le composant demandé n'implémente pas l'interface IDispatch
         </simpara>
        </listitem>
       </itemizedlist>
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q8">
    <question>
     <para>
      Comment puis-je utiliser des objets COM à partir d'un serveur distant ?
     </para>
    </question>
    <answer>
     <para>
      Exactement de la même manière qu'avec des objets locaux. Vous devez
      juste passer l'adresse IP de la machine distante en deuxième paramètre
      du constructeur COM.
     </para>
     <para>
      Assurez-vous que vous avez spécifié 
      <link linkend="ini.com.allow-dcom">com.allow_dcom</link><literal>=</literal>&true; dans votre
      &php.ini;.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q9">
    <question>
     <para>
      J'obtiens 'DCOM is disabled in C:\path...\scriptname.php on line 6', que
      dois-je faire ?
     </para>
    </question>
    <answer>
     <para>
      Éditez votre &php.ini; et mettez 
      <link linkend="ini.com.allow-dcom">com.allow_dcom</link><literal>=</literal>&true;.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q10">
    <question>
     <para>
      Est-il possible de charger/manipuler des objets ActiveX dans une page en
      PHP ?
     </para>
    </question>
    <answer>
     <para>
      Cela n'a rien à voir avec PHP. Les objets ActiveX sont chargés côté
      client s'ils sont demandés par le document HTML. Il n'y a aucune relation
      avec le script PHP et il n'y a pas d'interaction directe possible
      avec le serveur.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q11">
    <question>
     <para>
      Est-il possible d'obtenir une instance fonctionnelle d'un composant ?
     </para>
    </question>
    <answer>
     <para>
      C'est possible avec l'aide de monikers. Si vous voulez des références
      multiples au même mot d'instance, vous pouvez créer une instance de la
      façon suivante :
     </para>
     <programlisting role="php">
<![CDATA[
<?php
$word = new COM("C:\docs\word.doc");
?>
]]>
     </programlisting>
     <para>
      Cela créera une nouvelle instance s'il n'y en a aucune disponible ou
      retournera un descripteur vers l'instance courante, si elle est
      disponible.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q12">
    <question>
     <para>
      Y a-t-il moyen de manipuler un événement envoyé par un objet COM ?
     </para>
    </question>
    <answer>
     <para>
      Vous pouvez définir un moniteur d'événement (sink) et le lier en
      utilisant <function>com_event_sink</function>. Vous pouvez utiliser
      <function>com_print_typeinfo</function> pour que PHP génère un
      squelette pour la classe du moniteur d'événement.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q13">
    <question>
     <para>
      J'ai des problèmes quand j'invoque une méthode d'un objet COM qui expose
      plus d'une interface. Que puis-je faire ?
     </para>
    </question>
    <answer>
     <para>
      La réponse est aussi simple que non satisfaisante. Je ne sais pas
      exactement, mais je pense que vous ne pouvez rien faire. Si quelqu'un a
      des informations spécifiques sur ce sujet, faites-le <link
      xlink:href="mailto:&email.harald;">moi</link> savoir :)
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q14">
    <question>
     <para>
      Bon, PHP fonctionne avec COM, mais qu'en est-il de COM+ ?
     </para>
    </question>
    <answer>
     <para>
      COM+ étend COM avec un canevas pour gérer des composants via MTS et MSMQ
      mais il n'y a rien de particulier que PHP doit supporter pour utiliser
      de tels composants.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.com.q15">
    <question>
     <para>
      Si PHP peut manipuler des objets COM, peut-on imaginer d'utiliser des
      ressources de composants, en conjonction avec PHP ?
     </para>
    </question>
    <answer>
     <para>
      PHP ne supporte pas encore les transactions. Ainsi, si une erreur se
      produit, aucun rollback n'est initié. Si vous utilisez des composants
      qui supportent les transactions, vous devrez implémenter le
      gestionnaire de transactions par vous-même.
     </para>
    </answer>
   </qandaentry>

  </qandaset>
 </chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->