cvs: phpdoc-fr /reference/phar book.xml /reference/phar/Phar addEmptyDir.xml addFile.xml addFromString.xml apiVersion.xml buildFromDirectory.xml
buildFromIterator.xml
| From: | Guillaume Plessis | Date: | Tue, 06 Jan 2009 18:15:43 +0000 |
| Subject: | cvs: phpdoc-fr /reference/phar book.xml /reference/phar/Phar addEmptyDir.xml addFile.xml addFromString.xml apiVersion.xml buildFromDirectory.xml buildFromIterator.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6286@lists.php.net to get a copy of this message | ||
gui Tue Jan 6 18:15:43 2009 UTC
Added files:
/phpdoc-fr/reference/phar/Phar addEmptyDir.xml addFile.xml
addFromString.xml apiVersion.xml
buildFromDirectory.xml
buildFromIterator.xml
Modified files:
/phpdoc-fr/reference/phar book.xml
Log:
initial translation + typo
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/book.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/phar/book.xml diff -u phpdoc-fr/reference/phar/book.xml:1.3 phpdoc-fr/reference/phar/book.xml:1.4 --- phpdoc-fr/reference/phar/book.xml:1.3 Tue Jan 6 12:29:32 2009 +++ phpdoc-fr/reference/phar/book.xml Tue Jan 6 18:15:43 2009 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> <!-- EN-Revision: 1.7 Maintainer: gui Status: ready --> @@ -97,7 +97,7 @@ <para> En d'autres mots, même avec l'extension phar désactivée, il est possible d'exécuter ou d'inclure une archive basée sur phar. Accéder à des fichiers individuels au sein d'une archive phar n'est - possible qu'avec l'extension phar à moins quel'archive phar n'ait été créée par PHP_Archive. + possible qu'avec l'extension phar à moins que l'archive phar n'ait été créée par PHP_Archive. </para> <para> L'extension phar est aussi capable de convertir une archive phar à partir d'un tar vers un fichier zip @@ -150,7 +150,7 @@ <link xlink:href="http://pear.php.net/PHP_Archive">PHP_Archive</link>, et les détails d'implémentations sont les mêmes, bien que l'extension Phar soit plus puissante. En plus, celle-ci permet à la plupart des applications - PHP d'être exécutées sans modification alors que les archves basées sur PHP_Archive + PHP d'être exécutées sans modification alors que les archives basées sur PHP_Archive requièrent souvent beaucoup de modification pour fonctionner. </para> </preface> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/addEmptyDir.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/addEmptyDir.xml +++ phpdoc-fr/reference/phar/Phar/addEmptyDir.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.addemptydir"> <refnamediv> <refname>Phar::addEmptyDir</refname> <refpurpose>Ajoute un répertoire vide à l'archive phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::addEmptyDir</methodname> <methodparam><type>string</type><parameter>dirname</parameter></methodparam> </methodsynopsis> &phar.write; <para> Grâce à cette méthode, un répertoire vide est créé avec le chemin <literal>dirname</literal>. Cette méthode est identique à <function>ZipArchive::addEmptyDir</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>dirname</parameter></term> <listitem> <para> Le nom du répertoire vide à créer dans l'archive phar </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> pas de valeur de retour, une exception est lévée en cas d'échec. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::addEmptyDir</function></title> <programlisting role="php"> <![CDATA[ <?php try { $a = new Phar('/chemin/vers/phar.phar'); $a->addEmptyDir('/chemin/complet/vers/fichier'); // démontre comment le fichier est stocké $b = $a['chemin/complet/vers/fichier']->isDir(); } catch (Exception $e) { // traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharData::addEmptyDir</function></member> <member><function>Phar::addFile</function></member> <member><function>Phar::addFromString</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/addFile.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/addFile.xml +++ phpdoc-fr/reference/phar/Phar/addFile.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.addfile"> <refnamediv> <refname>Phar::addFile</refname> <refpurpose>Ajoute un fichier du système de fichiers à l'archive phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::addFile</methodname> <methodparam><type>string</type><parameter>file</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>localname</parameter></methodparam> </methodsynopsis> &phar.write; <para> Grâce à cette méthode, tout fichier ou URL peut être ajouté à l'archive phar. Si le second paramètre optionnel <literal>localname</literal> est spécifié, le fichier sera stocké dans l'archive de ce nom, sinon le paramètre <literal>file</literal> est utilisé comme chemin vers lequel stocker l'archive. Les URL doivent être locales, sans quoi une exception est levée. Cette méthode est identique à <function>ZipArchive::addFile</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>file</parameter></term> <listitem> <para> Chemin absolu ou relatif vers un fichier du disque à ajouter à l'archive phar. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>localname</parameter></term> <listitem> <para> Chemin où le fichier sera stocké dans l'archive. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> pas de valeur de retour, une exception est lévée en cas d'échec. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::addFile</function></title> <programlisting role="php"> <![CDATA[ <?php try { $a = new Phar('/chemin/vers/phar.phar'); $a->addFile('/chemin/complet/vers/fichier'); // démontre comment le fichier est stocké $b = $a['chemin/complet/vers/fichier']->getContent(); $a->addFile('/chemin/complet/vers/fichier', 'mon/fichier.txt'); $c = $a['mon/fichier.txt']->getContent(); // démontre l'utilisation d'URL $a->addFile('http://www.exemple.com', 'exemple.html'); } catch (Exception $e) { // traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::offsetSet</function></member> <member><function>PharData::addFile</function></member> <member><function>Phar::addFromString</function></member> <member><function>Phar::addEmptyDir</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/addFromString.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/addFromString.xml +++ phpdoc-fr/reference/phar/Phar/addFromString.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.addfromstring"> <refnamediv> <refname>Phar::addFromString</refname> <refpurpose>Ajoute un fichier du système de fichiers à l'archive phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::addFromString</methodname> <methodparam><type>string</type><parameter>localname</parameter></methodparam> <methodparam><type>string</type><parameter>contents</parameter></methodparam> </methodsynopsis> &phar.write; <para> Grâce à cette méthode, toute chaîne peut être ajoutée à l'archive phar. Le fichier sera stocké dans l'archive avec <literal>localname</literal> en tant que chemin. Cette méthode est identique à <function>ZipArchive::addFromString</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>localname</parameter></term> <listitem> <para> Chemin dans lequel le fichier sera stocké dans l'archive. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>contents</parameter></term> <listitem> <para> Le contenu de fichier à stocker </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> pas de valeur de retour, une exception est lévée en cas d'échec. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::addFromString</function></title> <programlisting role="php"> <![CDATA[ <?php try { $a = new Phar('/chemin/vers/phar.phar'); $a->addFromString('chemin/vers/fichier.txt', 'mon fichier simple'); $b = $a['chemin/vers/fichier.txt']->getContent(); // pour ajouter du contenu à partir d'un descripteur de flux pour des gros fichiers, utilisez offsetSet() $c = fopen('/chemin/vers/grosfichier.bin'); $a['grosfichier.bin'] = $c; fclose($c); } catch (Exception $e) { // traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::offsetSet</function></member> <member><function>PharData::addFromString</function></member> <member><function>Phar::addFile</function></member> <member><function>Phar::addEmptyDir</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/apiVersion.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/apiVersion.xml +++ phpdoc-fr/reference/phar/Phar/apiVersion.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.apiversion"> <refnamediv> <refname>Phar::apiVersion</refname> <refpurpose>Retourne la version de l'API</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>Phar::apiVersion</methodname> <void/> </methodsynopsis> <para> Retourne la version de l'API du format de fichier phar qui sera utilisée pour la création de phars. L'extension Phar supporte la lecture des versions d'API 1.0.0 et supérieures. L'API version 1.1.0 est requise pour les hachages SHA-256 et SHA-512, et l'API version 1.1.1 est requise pour stocker des répertoires vides. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La version de l'API, par exemple <literal>"1.0.0"</literal>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec<function>Phar::apiVersion</function></title> <programlisting role="php"> <![CDATA[ <?php echo Phar::apiVersion(); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 1.1.1 ]]> </screen> </example> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/buildFromDirectory.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/buildFromDirectory.xml +++ phpdoc-fr/reference/phar/Phar/buildFromDirectory.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.buildfromdirectory" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::buildFromDirectory</refname> <refpurpose>Construit une archive phar à partir des fichiers d'un répertoire.</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>Phar::buildFromDirectory</methodname> <methodparam><type>string</type><parameter>base_dir</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>regex</parameter></methodparam> </methodsynopsis> &phar.write; <para> Remplit une archive phar à partir du contenu d'un répertoire. Le second paramètre, optionnel, est une expression rationnelle (pcre) utilisée pour exclure des fichiers. Tout fichier dont le nom satisfait l'expression rationnelle sera inclus, les autres seront exclus. Pour un contrôle plus fin, utilisez <function>Phar::buildFromIterator</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>base_dir</parameter></term> <listitem> <para> Le chemin absolu ou relatif vers le répertoire contenant tous les fichiers à ajouter à l'archive. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>regex</parameter></term> <listitem> <para> Une expression rationnelle optionnelle utilisée pour filtrer la liste des fichiers. Seuls les fichiers dont le nom satisfait l'expression rationnelle seront inclus dans l'archive. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <function>Phar::buildFromDirectory</function> retourne un tableau associatif faisant correspondre le chemin interne du fichier avec le chemin complet sur le système de fichiers. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Cette méthode lève une exception <classname>BadMethodCallException</classname> quand elle est incapable d'instancier l'itérateur de répertoire interne, ou une exception <classname>PharException</classname> s'il y a eu des erreurs lors de la sauvegarde de l'archive. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Un exemple avec<function>Phar::buildFromDirectory</function></title> <para> </para> <para> <programlisting role="php"> <![CDATA[ <?php // crée avec l'alias "projet.phar" $phar = new Phar('projet.phar', 0, 'projet.phar'); // ajoute des fichiers dans le projet $phar->buildFromDirectory(dirname(__FILE__) . '/projet'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); $phar2 = new Phar('projet2.phar', 0, 'projet2.phar'); // ajoute tous les fichiers dans le projet, mais juste les fichiers .php $phar->buildFromDirectory(dirname(__FILE__) . '/projet', '/\.php$/'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> </example> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::buildFromIterator</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/buildFromIterator.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/buildFromIterator.xml +++ phpdoc-fr/reference/phar/Phar/buildFromIterator.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.buildfromiterator" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::buildFromIterator</refname> <refpurpose>Construit une archive phar à partir d'un itérateur.</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>Phar::buildFromIterator</methodname> <methodparam><type>Iterator</type><parameter>iter</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>base_directory</parameter></methodparam> </methodsynopsis> &phar.write; <para> Remplit uen archive phar à partir d'un itérateur. Deux styles d'itérateur sont supportés, les itérateurs qui font correspondre le nom de fichier au sein du phar avec le nom d'un fichier sur le disque, et les itérateurs comme DirectoryIterator qui retournent des objets SplFileInfo. Pour les itérateurs qui retournent des objets SplFileInfo, le second paramètre est requis. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Un exemple avec <function>Phar::buildFromIterator</function> et SplFileInfo</title> <para> Pour la plupart des archives phar, l'archive reflétera l'arborescence d'un répertoire, et le second style est le plus utile. Par exemple, pour créer une archive phar contenant les fichiers de l'arborescence du répertoire : </para> <para> <screen> <![CDATA[ /chemin/vers/projet/ config/ dist.xml debug.xml lib/ file1.php file2.php src/ processthing.php www/ index.php cli/ index.php ]]> </screen> </para> <para> ce code peut être utilisé pour ajouter à l'archive "projet.phar" : </para> <para> <programlisting role="php"> <![CDATA[ <?php // crée avec l'alias "projet.phar" $phar = new Phar('projet.phar', 0, 'projet.phar'); $phar->buildFromIterator( new RecursiveIteratorIterator( new RecursiveDirectoryIterator('/chemin/vers/projet')), '/chemin/vers/projet'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> <para> Le fichier projet.phar peut alors être utilisé immédiatement. <function>buildFromIterator</function> ne régle pas les paramètres tels que la compression ou les méta-données; ceci peut cependant être fait après avoir créé l'archive phar. </para> <para> Il est intéressant de noter que <function>buildFromIterator</function> peut aussi être utilisé pour copier les éléments d'une archive phar existante, car l'objet Phar descend de <classname>DirectoryIterator</classname> : </para> <para> <programlisting role="php"> <![CDATA[ <?php // crée avec l'alias "projet.phar" $phar = new Phar('projet.phar', 0, 'projet.phar'); $phar->buildFromIterator( new RecursiveIteratorIterator( new Phar('/chemin/vers/unautrephar.phar')), 'phar:///chemin/vers/unautrephar.phar/chemin/vers/projet'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> </example> <example> <title>Un exemple avec <function>Phar::buildFromIterator</function> et d'autres itérateurs</title> <para> La seconde forme d'itérateur peut être utilisée avec n'importe quel itérateur qui retourne une correspondance clé => valeur, tels que <classname>ArrayIterator</classname> : </para> <para> <programlisting role="php"> <![CDATA[ <?php // crée avec l'alias "projet.phar" $phar = new Phar('projet.phar', 0, 'projet.phar'); $phar->buildFromIterator( new ArrayIterator( array( 'interne/fichier.php' => dirname(__FILE__) . '/unfichier.php', 'unautre/fichier.jpg' => fopen('/chemin/vers/grosfichier.jpg', 'rb'), ))); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> </example> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>iter</parameter></term> <listitem> <para> N'importe quel itérateur qui fait correspondre de façon associative un fichier phar à un emplacement ou qui retourne des objets SplFileInfo </para> </listitem> </varlistentry> <varlistentry> <term><parameter>base_directory</parameter></term> <listitem> <para> Pour les itérateurs qui retournent des objets SplFileInfo, la portion du nom de chaque fichier à enlever lors de l'ajout à l'archive </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <function>buildFromIterator</function> retourne un tableau associatif faisant correspondre le chemin interne du fichier à son chemin complet sur le système de fichiers. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Cette méthode lève une exception <classname>UnexpectedValueException</classname> quand l'itérateur retourne des valeurs fausses, telles qu'une clé entière à la place d'une, chaîne, une exception <classname>BadMethodCallException</classname> quand un itérateur basé sur SplFileInfo est passé sans paramètre <parameter>base_directory</parameter>, ou une exception <classname>PharException</classname> s'il y a eu des erreurs lors de la sauvegarde de l'archive phar. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::buildFromDirectory</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 -->
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/book.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/phar/book.xml diff -u phpdoc-fr/reference/phar/book.xml:1.3 phpdoc-fr/reference/phar/book.xml:1.4 --- phpdoc-fr/reference/phar/book.xml:1.3 Tue Jan 6 12:29:32 2009 +++ phpdoc-fr/reference/phar/book.xml Tue Jan 6 18:15:43 2009 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- Purpose: compression --> <!-- Membership: pecl --> <!-- EN-Revision: 1.7 Maintainer: gui Status: ready --> @@ -97,7 +97,7 @@ <para> En d'autres mots, même avec l'extension phar désactivée, il est possible d'exécuter ou d'inclure une archive basée sur phar. Accéder à des fichiers individuels au sein d'une archive phar n'est - possible qu'avec l'extension phar à moins quel'archive phar n'ait été créée par PHP_Archive. + possible qu'avec l'extension phar à moins que l'archive phar n'ait été créée par PHP_Archive. </para> <para> L'extension phar est aussi capable de convertir une archive phar à partir d'un tar vers un fichier zip @@ -150,7 +150,7 @@ <link xlink:href="http://pear.php.net/PHP_Archive">PHP_Archive</link>, et les détails d'implémentations sont les mêmes, bien que l'extension Phar soit plus puissante. En plus, celle-ci permet à la plupart des applications - PHP d'être exécutées sans modification alors que les archves basées sur PHP_Archive + PHP d'être exécutées sans modification alors que les archives basées sur PHP_Archive requièrent souvent beaucoup de modification pour fonctionner. </para> </preface> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/addEmptyDir.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/addEmptyDir.xml +++ phpdoc-fr/reference/phar/Phar/addEmptyDir.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.addemptydir"> <refnamediv> <refname>Phar::addEmptyDir</refname> <refpurpose>Ajoute un répertoire vide à l'archive phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::addEmptyDir</methodname> <methodparam><type>string</type><parameter>dirname</parameter></methodparam> </methodsynopsis> &phar.write; <para> Grâce à cette méthode, un répertoire vide est créé avec le chemin <literal>dirname</literal>. Cette méthode est identique à <function>ZipArchive::addEmptyDir</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>dirname</parameter></term> <listitem> <para> Le nom du répertoire vide à créer dans l'archive phar </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> pas de valeur de retour, une exception est lévée en cas d'échec. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::addEmptyDir</function></title> <programlisting role="php"> <![CDATA[ <?php try { $a = new Phar('/chemin/vers/phar.phar'); $a->addEmptyDir('/chemin/complet/vers/fichier'); // démontre comment le fichier est stocké $b = $a['chemin/complet/vers/fichier']->isDir(); } catch (Exception $e) { // traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>PharData::addEmptyDir</function></member> <member><function>Phar::addFile</function></member> <member><function>Phar::addFromString</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/addFile.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/addFile.xml +++ phpdoc-fr/reference/phar/Phar/addFile.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.addfile"> <refnamediv> <refname>Phar::addFile</refname> <refpurpose>Ajoute un fichier du système de fichiers à l'archive phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::addFile</methodname> <methodparam><type>string</type><parameter>file</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>localname</parameter></methodparam> </methodsynopsis> &phar.write; <para> Grâce à cette méthode, tout fichier ou URL peut être ajouté à l'archive phar. Si le second paramètre optionnel <literal>localname</literal> est spécifié, le fichier sera stocké dans l'archive de ce nom, sinon le paramètre <literal>file</literal> est utilisé comme chemin vers lequel stocker l'archive. Les URL doivent être locales, sans quoi une exception est levée. Cette méthode est identique à <function>ZipArchive::addFile</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>file</parameter></term> <listitem> <para> Chemin absolu ou relatif vers un fichier du disque à ajouter à l'archive phar. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>localname</parameter></term> <listitem> <para> Chemin où le fichier sera stocké dans l'archive. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> pas de valeur de retour, une exception est lévée en cas d'échec. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::addFile</function></title> <programlisting role="php"> <![CDATA[ <?php try { $a = new Phar('/chemin/vers/phar.phar'); $a->addFile('/chemin/complet/vers/fichier'); // démontre comment le fichier est stocké $b = $a['chemin/complet/vers/fichier']->getContent(); $a->addFile('/chemin/complet/vers/fichier', 'mon/fichier.txt'); $c = $a['mon/fichier.txt']->getContent(); // démontre l'utilisation d'URL $a->addFile('http://www.exemple.com', 'exemple.html'); } catch (Exception $e) { // traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::offsetSet</function></member> <member><function>PharData::addFile</function></member> <member><function>Phar::addFromString</function></member> <member><function>Phar::addEmptyDir</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/addFromString.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/addFromString.xml +++ phpdoc-fr/reference/phar/Phar/addFromString.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.addfromstring"> <refnamediv> <refname>Phar::addFromString</refname> <refpurpose>Ajoute un fichier du système de fichiers à l'archive phar</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>Phar::addFromString</methodname> <methodparam><type>string</type><parameter>localname</parameter></methodparam> <methodparam><type>string</type><parameter>contents</parameter></methodparam> </methodsynopsis> &phar.write; <para> Grâce à cette méthode, toute chaîne peut être ajoutée à l'archive phar. Le fichier sera stocké dans l'archive avec <literal>localname</literal> en tant que chemin. Cette méthode est identique à <function>ZipArchive::addFromString</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>localname</parameter></term> <listitem> <para> Chemin dans lequel le fichier sera stocké dans l'archive. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>contents</parameter></term> <listitem> <para> Le contenu de fichier à stocker </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> pas de valeur de retour, une exception est lévée en cas d'échec. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec <function>Phar::addFromString</function></title> <programlisting role="php"> <![CDATA[ <?php try { $a = new Phar('/chemin/vers/phar.phar'); $a->addFromString('chemin/vers/fichier.txt', 'mon fichier simple'); $b = $a['chemin/vers/fichier.txt']->getContent(); // pour ajouter du contenu à partir d'un descripteur de flux pour des gros fichiers, utilisez offsetSet() $c = fopen('/chemin/vers/grosfichier.bin'); $a['grosfichier.bin'] = $c; fclose($c); } catch (Exception $e) { // traite les erreurs ici } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::offsetSet</function></member> <member><function>PharData::addFromString</function></member> <member><function>Phar::addFile</function></member> <member><function>Phar::addEmptyDir</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/apiVersion.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/apiVersion.xml +++ phpdoc-fr/reference/phar/Phar/apiVersion.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="phar.apiversion"> <refnamediv> <refname>Phar::apiVersion</refname> <refpurpose>Retourne la version de l'API</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>Phar::apiVersion</methodname> <void/> </methodsynopsis> <para> Retourne la version de l'API du format de fichier phar qui sera utilisée pour la création de phars. L'extension Phar supporte la lecture des versions d'API 1.0.0 et supérieures. L'API version 1.1.0 est requise pour les hachages SHA-256 et SHA-512, et l'API version 1.1.1 est requise pour stocker des répertoires vides. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> La version de l'API, par exemple <literal>"1.0.0"</literal>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Un exemple avec<function>Phar::apiVersion</function></title> <programlisting role="php"> <![CDATA[ <?php echo Phar::apiVersion(); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 1.1.1 ]]> </screen> </example> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/buildFromDirectory.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/buildFromDirectory.xml +++ phpdoc-fr/reference/phar/Phar/buildFromDirectory.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.buildfromdirectory" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::buildFromDirectory</refname> <refpurpose>Construit une archive phar à partir des fichiers d'un répertoire.</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>Phar::buildFromDirectory</methodname> <methodparam><type>string</type><parameter>base_dir</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>regex</parameter></methodparam> </methodsynopsis> &phar.write; <para> Remplit une archive phar à partir du contenu d'un répertoire. Le second paramètre, optionnel, est une expression rationnelle (pcre) utilisée pour exclure des fichiers. Tout fichier dont le nom satisfait l'expression rationnelle sera inclus, les autres seront exclus. Pour un contrôle plus fin, utilisez <function>Phar::buildFromIterator</function>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>base_dir</parameter></term> <listitem> <para> Le chemin absolu ou relatif vers le répertoire contenant tous les fichiers à ajouter à l'archive. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>regex</parameter></term> <listitem> <para> Une expression rationnelle optionnelle utilisée pour filtrer la liste des fichiers. Seuls les fichiers dont le nom satisfait l'expression rationnelle seront inclus dans l'archive. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <function>Phar::buildFromDirectory</function> retourne un tableau associatif faisant correspondre le chemin interne du fichier avec le chemin complet sur le système de fichiers. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Cette méthode lève une exception <classname>BadMethodCallException</classname> quand elle est incapable d'instancier l'itérateur de répertoire interne, ou une exception <classname>PharException</classname> s'il y a eu des erreurs lors de la sauvegarde de l'archive. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Un exemple avec<function>Phar::buildFromDirectory</function></title> <para> </para> <para> <programlisting role="php"> <![CDATA[ <?php // crée avec l'alias "projet.phar" $phar = new Phar('projet.phar', 0, 'projet.phar'); // ajoute des fichiers dans le projet $phar->buildFromDirectory(dirname(__FILE__) . '/projet'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); $phar2 = new Phar('projet2.phar', 0, 'projet2.phar'); // ajoute tous les fichiers dans le projet, mais juste les fichiers .php $phar->buildFromDirectory(dirname(__FILE__) . '/projet', '/\.php$/'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> </example> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::buildFromIterator</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/phar/Phar/buildFromIterator.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/phar/Phar/buildFromIterator.xml +++ phpdoc-fr/reference/phar/Phar/buildFromIterator.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: gui Status: ready --> <!-- Reviewed: no --> <refentry xml:id="phar.buildfromiterator" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Phar::buildFromIterator</refname> <refpurpose>Construit une archive phar à partir d'un itérateur.</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>Phar::buildFromIterator</methodname> <methodparam><type>Iterator</type><parameter>iter</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>base_directory</parameter></methodparam> </methodsynopsis> &phar.write; <para> Remplit uen archive phar à partir d'un itérateur. Deux styles d'itérateur sont supportés, les itérateurs qui font correspondre le nom de fichier au sein du phar avec le nom d'un fichier sur le disque, et les itérateurs comme DirectoryIterator qui retournent des objets SplFileInfo. Pour les itérateurs qui retournent des objets SplFileInfo, le second paramètre est requis. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Un exemple avec <function>Phar::buildFromIterator</function> et SplFileInfo</title> <para> Pour la plupart des archives phar, l'archive reflétera l'arborescence d'un répertoire, et le second style est le plus utile. Par exemple, pour créer une archive phar contenant les fichiers de l'arborescence du répertoire : </para> <para> <screen> <![CDATA[ /chemin/vers/projet/ config/ dist.xml debug.xml lib/ file1.php file2.php src/ processthing.php www/ index.php cli/ index.php ]]> </screen> </para> <para> ce code peut être utilisé pour ajouter à l'archive "projet.phar" : </para> <para> <programlisting role="php"> <![CDATA[ <?php // crée avec l'alias "projet.phar" $phar = new Phar('projet.phar', 0, 'projet.phar'); $phar->buildFromIterator( new RecursiveIteratorIterator( new RecursiveDirectoryIterator('/chemin/vers/projet')), '/chemin/vers/projet'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> <para> Le fichier projet.phar peut alors être utilisé immédiatement. <function>buildFromIterator</function> ne régle pas les paramètres tels que la compression ou les méta-données; ceci peut cependant être fait après avoir créé l'archive phar. </para> <para> Il est intéressant de noter que <function>buildFromIterator</function> peut aussi être utilisé pour copier les éléments d'une archive phar existante, car l'objet Phar descend de <classname>DirectoryIterator</classname> : </para> <para> <programlisting role="php"> <![CDATA[ <?php // crée avec l'alias "projet.phar" $phar = new Phar('projet.phar', 0, 'projet.phar'); $phar->buildFromIterator( new RecursiveIteratorIterator( new Phar('/chemin/vers/unautrephar.phar')), 'phar:///chemin/vers/unautrephar.phar/chemin/vers/projet'); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> </example> <example> <title>Un exemple avec <function>Phar::buildFromIterator</function> et d'autres itérateurs</title> <para> La seconde forme d'itérateur peut être utilisée avec n'importe quel itérateur qui retourne une correspondance clé => valeur, tels que <classname>ArrayIterator</classname> : </para> <para> <programlisting role="php"> <![CDATA[ <?php // crée avec l'alias "projet.phar" $phar = new Phar('projet.phar', 0, 'projet.phar'); $phar->buildFromIterator( new ArrayIterator( array( 'interne/fichier.php' => dirname(__FILE__) . '/unfichier.php', 'unautre/fichier.jpg' => fopen('/chemin/vers/grosfichier.jpg', 'rb'), ))); $phar->setStub($phar->createDefaultWebStub('cli/index.php', 'www/index.php')); ?> ]]> </programlisting> </para> </example> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>iter</parameter></term> <listitem> <para> N'importe quel itérateur qui fait correspondre de façon associative un fichier phar à un emplacement ou qui retourne des objets SplFileInfo </para> </listitem> </varlistentry> <varlistentry> <term><parameter>base_directory</parameter></term> <listitem> <para> Pour les itérateurs qui retournent des objets SplFileInfo, la portion du nom de chaque fichier à enlever lors de l'ajout à l'archive </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <function>buildFromIterator</function> retourne un tableau associatif faisant correspondre le chemin interne du fichier à son chemin complet sur le système de fichiers. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Cette méthode lève une exception <classname>UnexpectedValueException</classname> quand l'itérateur retourne des valeurs fausses, telles qu'une clé entière à la place d'une, chaîne, une exception <classname>BadMethodCallException</classname> quand un itérateur basé sur SplFileInfo est passé sans paramètre <parameter>base_directory</parameter>, ou une exception <classname>PharException</classname> s'il y a eu des erreurs lors de la sauvegarde de l'archive phar. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>Phar::buildFromDirectory</function></member> </simplelist> </para> </refsect1> </refentry> <!-- 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:"../../../../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 -->