<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.sqlite3.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'sqlite3.backup.php',
    1 => 'SQLite3::backup',
    2 => 'Sauvegarde une base de donn&eacute;es dans une autre base de donn&eacute;es',
  ),
  'up' => 
  array (
    0 => 'class.sqlite3.php',
    1 => 'SQLite3',
  ),
  'prev' => 
  array (
    0 => 'class.sqlite3.php',
    1 => 'SQLite3',
  ),
  'next' => 
  array (
    0 => 'sqlite3.busytimeout.php',
    1 => 'SQLite3::busyTimeout',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/sqlite3/sqlite3/backup.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="sqlite3.backup" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">SQLite3::backup</h1>
  <p class="verinfo">(PHP 7 &gt;= 7.4.0, PHP 8)</p><p class="refpurpose"><span class="refname">SQLite3::backup</span> &mdash; <span class="dc-title">Sauvegarde une base de données dans une autre base de données</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-sqlite3.backup-description">
  <h3 class="title">Description</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>SQLite3::backup</strong></span>(<span class="methodparam"><span class="type"><a href="class.sqlite3.php" class="type SQLite3">SQLite3</a></span> <code class="parameter">$destination</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$sourceDatabase</code><span class="initializer"> = &quot;main&quot;</span></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$destinationDatabase</code><span class="initializer"> = &quot;main&quot;</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="para rdfs-comment">
   <span class="methodname"><strong>SQLite3::backup()</strong></span> copie le contenu d&#039;une base de données
   dans une autre, écrasant le contenu de la base de données de destination.
   Cela est utile pour créer des sauvegardes de bases de données
   ou pour copier des bases de données en mémoire vers ou depuis des fichiers persistants.
  </p>
  <div class="tip"><strong class="tip">Astuce</strong>
   <p class="para">
    Depuis SQLite 3.27.0 (2019-02-07), il est également possible d&#039;utiliser l&#039;instruction
    <code class="literal">VACUUM INTO &#039;file.db&#039;;</code> pour sauvegarder la base de données dans un nouveau fichier.
   </p>
  </div>
 </div>


 <div class="refsect1 parameters" id="refsect1-sqlite3.backup-parameters">
  <h3 class="title">Liste de paramètres</h3>
  <dl>
   
    <dt><code class="parameter">destination</code></dt>
    <dd>
     <p class="para">
      Une connexion à une base de données SQLite3 ouverte avec <span class="methodname"><a href="sqlite3.open.php" class="methodname">SQLite3::open()</a></span>.
     </p>
    </dd>
   
   
    <dt><code class="parameter">sourceDatabase</code></dt>
    <dd>
     <p class="para">
      Le nom de la base de données est <code class="literal">&quot;main&quot;</code> pour la base de données principale,
      <code class="literal">&quot;temp&quot;</code> pour la base de données temporaire,
      ou le nom spécifié après le mot-clé <code class="literal">AS</code>
      dans une instruction <code class="literal">ATTACH</code> pour une base de données attachée.
     </p>
    </dd>
   
   
    <dt><code class="parameter">destinationDatabase</code></dt>
    <dd>
     <p class="para">
      Analogue à <code class="parameter">sourceDatabase</code>
      mais pour la <code class="parameter">destination</code>.
     </p>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-sqlite3.backup-returnvalues">
  <h3 class="title">Valeurs de retour</h3>
  <p class="para">
   Cette fonction retourne <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> en cas de succès ou <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si une erreur survient.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-sqlite3.backup-examples">
  <h3 class="title">Exemples</h3>
  <div class="example" id="sqlite3.backup.example.basic">
   <p><strong>Exemple #1 Sauvegarder une base de données existante</strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">// $conn est une connexion à une base de données sqlite3 déjà ouverte<br /><br /></span><span style="color: #0000BB">$backup </span><span style="color: #007700">= new </span><span style="color: #0000BB">SQLite3</span><span style="color: #007700">(</span><span style="color: #DD0000">'backup.sqlite'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$conn</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">backup</span><span style="color: #007700">(</span><span style="color: #0000BB">$backup</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>


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