archived-doc-es/reference/sqlite/functions/sqlite-open.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.sqlite-open" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>sqlite_open</refname>
  <refpurpose>Abrir una base de datos SQLite y crear la base de datos si no existe</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>sqlite_open</methodname>
   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0666</initializer></methodparam>
   <methodparam choice="opt"><type>string</type><parameter role="reference">error_message</parameter></methodparam>
  </methodsynopsis>
  <para>&style.oop; (constructor):</para>
  <constructorsynopsis>
   <modifier>final</modifier> <modifier>public</modifier> <methodname>SQLiteDatabase::__construct</methodname>
   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0666</initializer></methodparam>
   <methodparam choice="opt"><type>string</type><parameter role="reference">error_message</parameter></methodparam>
  </constructorsynopsis>
  <para>
   Abre una base de datos SQLite o crea la base de datos si no existe.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>filename</parameter></term>
     <listitem>
      <para>
       El nombre de fichero de la base de datos SQLite. Si el fichero no existe, SQLite
       intentará crearla. PHP debe tener permisos de escritura del fichero
       si los datos son insertados, el esquema de la base de datos es modificado o se crea la
       base de datos si ésta no existe.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>mode</parameter></term>
     <listitem>
      <para>
       El modo del fichero. En un futuro se usará para abrir la base de datos en
       modo sólo lectura. Actualmente, este parámetro es ignorado por la biblioteca
       sqlite. El valor por defecto es el valor octal
       <literal>0666</literal> y es el valor recomendado.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>error_message</parameter></term>
     <listitem>
      <para>
       Pasado por referencia y establecido para contener un mensaje de error descriptivo
       explicando el por qué no se pudo abrir la base de datos si ocurriera un error.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve un recurso (gestor de base de datos) en caso de éxito, &false; en caso de error.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>sqlite_open</function></title>
    <programlisting role="php">
<![CDATA[
<?php
if ($db = sqlite_open('mysqlitedb', 0666, $sqliteerror)) { 
    sqlite_query($db, 'CREATE TABLE foo (bar varchar(10))');
    sqlite_query($db, "INSERT INTO foo VALUES ('fnord')");
    $result = sqlite_query($db, 'select bar from foo');
    var_dump(sqlite_fetch_array($result)); 
} else {
    die($sqliteerror);
}
?>]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <tip>
   <simpara>
    En plataformas Unix, SQLite es sensible a scripts que usan la llamada al sistema fork(). Si se
    tienen tales scripts, se recomienda que se cierre el gestor antes
    de usar la llamada al sistema y luego reabrirlo en el hijo y/o padre.
    Para más información de esta cuestión, véase
    <link xlink:href="&url.sqlite.interface.c;">The C language interface
    to the SQLite library</link> en la sección titulada
    <literal>Multi-Threading And SQLite</literal>. 
   </simpara>
  </tip>
  <tip>
   <simpara>
    No se recomienda trabajar con bases de datos SQLite montadas sobre particiones
    NFS. Ya que NFS es notoriamente malo cuando viene a cerrar
    se puede encontrar que no se puede abrir la base de datos, y que si se puede
    el comportamiento de cierre puede ser indefinido.
   </simpara>
  </tip>
  <note>
   <simpara>
    Desde la versión 2.8.2 de la biblioteca SQLite, se puede especificar
    <literal>:memory:</literal> como el parámetro <parameter>filename</parameter> para
    crear una base de datos que reside solamente en la memoria de la computadora.
    Ésto es útil principalmente para el procesamiento temporal, ya que la base de datos
    que está en memoria será destruida cuando el proceso finalice. También puede ser
    útil cuando se asocia con la sentencia <literal>ATTACH DATABASE</literal> de SQL
    para cargar otras bases de dtaos y mover y consultar datos entre ellas.
   </simpara>
  </note>
  <note>
   <simpara>
    SQLite es &safemode; y compatible con open_basedir.
   </simpara>
  </note>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>sqlite_popen</function></member>
    <member><function>sqlite_close</function></member>
    <member><function>sqlite_factory</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
 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
 -->