Files
doc-fr/reference/phar/Phar/mapPhar.xml
George Peter Banyard ede1b06016 Sync Phar docs with EN
2021-09-07 17:20:29 +01:00

129 lines
3.7 KiB
XML

<?xml version='1.0' encoding='utf-8'?>
<!-- $Revision$ -->
<!-- EN-Revision: 28046efaba656e158bdf45a2585c23a339943869 Maintainer: gui Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="phar.mapphar" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>Phar::mapPhar</refname>
<refpurpose>Lit le phar exécuté et charge son manifeste</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>final</modifier> <modifier>public</modifier> <modifier>static</modifier> <type>bool</type><methodname>Phar::mapPhar</methodname>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>alias</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Cette méthode statique peut être utilisée seulement au sein du conteneur de chargement
d'une archive Phar pour initialiser le phar quand il est exécuté directement ou quand il
est inclus dans un autre script.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>alias</parameter></term>
<listitem>
<para>
L'alias qui peut être utilisé dans l'URL <literal>phar://</literal> pour se
référer à l'archive plutôt que d'utiliser son chemin complet.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<para>
Variable inutilisée, présente par souci de compatibilité
avec la bibliothèque PHP_Archive de PEAR.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Une exception <classname>PharException</classname> est levée si la méthode n'est pas appelée
directement au sein de l'exécution de PHP, si aucun jeton __HALT_COMPILER(); n'est trouvé dans le
fichier source actuel ou si le fichier ne peut pas être ouvert en lecture.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>Phar::mapPhar</function></title>
<para>
mapPhar ne doit être utilisé qu'au sein du conteneur de chargement d'un phar. Utilisez
loadPhar pour charger un phar externe en mémoire.
</para>
<para>
Voici un exemple de conteneur de chargement Phar qui utilise mapPhar.
</para>
<programlisting role="php">
<![CDATA[
<?php
function __autoload($class)
{
include 'phar://mon.phar/' . str_replace('_', '/', $class) . '.php';
}
try {
Phar::mapPhar('mon.phar');
include 'phar://mon.phar/demarrage.php';
} catch (PharException $e) {
echo $e->getMessage();
die('Ne peut pas initialiser le Phar');
}
__HALT_COMPILER();
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>Phar::loadPhar</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:"~/.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
-->