<?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 => 'es',
  ),
  'this' => 
  array (
    0 => 'sqlite3.backup.php',
    1 => 'SQLite3::backup',
    2 => 'Realiza una copia de seguridad de una base de datos en otra base de datos',
  ),
  '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' => 'es',
    '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">Realiza una copia de seguridad de una base de datos en otra base de datos</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-sqlite3.backup-description">
  <h3 class="title">Descripción</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> copia el contenido de una base de datos
   en otra, sobrescribiendo el contenido de la base de datos de destino.
   Esto es útil para crear copias de seguridad de bases de datos
   o para copiar bases de datos en memoria hacia o desde ficheros persistentes.
  </p>
  <div class="tip"><strong class="tip">Sugerencia</strong>
   <p class="para">
    Desde SQLite 3.27.0 (2019-02-07), también es posible utilizar la instrucción
    <code class="literal">VACUUM INTO &#039;file.db&#039;;</code> para guardar la base de datos en un nuevo fichero.
   </p>
  </div>
 </div>


 <div class="refsect1 parameters" id="refsect1-sqlite3.backup-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
    <dt><code class="parameter">destination</code></dt>
    <dd>
     <p class="para">
      Una conexión a una base de datos SQLite3 abierta con <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">
      El nombre de la base de datos es <code class="literal">&quot;main&quot;</code> para la base de datos principal,
      <code class="literal">&quot;temp&quot;</code> para la base de datos temporal,
      o el nombre especificado después del mot-clé <code class="literal">AS</code>
      en una instrucción <code class="literal">ATTACH</code> para una base de datos adjunta.
     </p>
    </dd>
   
   
    <dt><code class="parameter">destinationDatabase</code></dt>
    <dd>
     <p class="para">
      Análogo a <code class="parameter">sourceDatabase</code>
      pero para la <code class="parameter">destination</code>.
     </p>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-sqlite3.backup-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Esta función retorna <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> en caso de éxito o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-sqlite3.backup-examples">
  <h3 class="title">Ejemplos</h3>
  <div class="example" id="sqlite3.backup.example.basic">
   <p><strong>Ejemplo #1 Realizar una copia de seguridad de una base de datos existente</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 es una conexión a una base de datos sqlite3 ya abierta<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); ?>