Manual de PHP
AnteriorSiguiente

sqlite_open

(PHP 5)

sqlite_open -- Abre una base de datos de SQLite y la crea si no existía

Descripción

resource sqlite_open ( string nombre_archivo [, int modo [, string &mensaje_error]] )

(Constructor) según el estilo orientado a objetos:

class SQLiteDatabase {

__construct ( string nombre_archivo [, int modo [, string &mensaje_error]] )

}

Abre una base de datos de SQLite o la crea si no existía

Lista de parámetros

nombre_archivo

El nombre de archivo de la base de datos de SQLite. Si el archivo no existe, SQLite intenta crearlo. PHP debe tener permisos de escritura en el archivo si se van a insertar datos, si el esquema de la base de datos se modifica o si se va a crear la propia base de datos por no existir.

modo

El modo del archivo, que se emplea para abrir la base de datos en modo solo lectura. Actualmente, la librería sqlite ignora este parámetro. El valor por defecto en formato octal es 0666, que además es el valor recomendado.

mensaje_error

Se pasa por referencia y contiene un mensaje de error descriptivo que explica el motivo por el que no se pudo abrir la base de datos.

Valores retornados

Devuelve un recurso en caso de éxito (que realmente es un manejador de base de datos) o FALSE en caso de error.

Ejemplos

Ejemplo 1. Ejemplo de sqlite_open()

<?php
if ($db = sqlite_open('mysqlitedb', 0666, $sqlite_error)) {
    sqlite_query($db, 'CREATE TABLE prueba (nombre varchar(10))');
    sqlite_query($db, "INSERT INTO prueba VALUES ('prueba_de_nombre')");
    $resultado = sqlite_query($db, 'select nombre from prueba');
    var_dump(sqlite_fetch_array($resultado));
} else {
    die($sqlite_error);
}
?>

Notes

Sugerencia: En sistemas Unix, SQLite puede tener problemas con scripts que hacen uso de llamadas a fork(). Los scripts que realicen ese tipo de llamadas, deberín cerrar el manejador antes de realizar el fork() y volver a abrirlo en el proceso hijo y/o en el proceso padre original. Para más información sobre este asunto, vea la La interfaz de C a la librería de SQLite y en concreto la sección Multi-Threading And SQLite (SQLite y los procesos con múltiples hilos de ejecución).

Sugerencia: No se recomienda utilizar bases de datos SQLite montadas sobre particiones NFS. Como es sabido, NFS tiene un comportamiento con los bloqueos bastante deficiente, lo que puede provocar que no se puedan abrir bases de datos o que el comportamiento con las que estén abiertas sea impredecible debido al bloqueo.

Nota: Desde la versión 2.8.2 de la librería SQLite, se puede indicar como nombre_archivo el valor :memory:, con lo que se creará la base de datos en la memoria del sistema. Este tipo de bases de datos son útiles cuando se necesita realizar un procesamiento temporal, ya que las bases de datos residentes en memoria se eliminan cuando termina la ejecución del proceso. También puede ser útil cuando se emplea junto con la sentencia SQL ATTACH DATABASE, de forma que se puedan cargar bases de datos y mover y consultar datos entre ellas.

Nota: SQLite es safe mode y está preparada para el "open_basedir".

Ver también

sqlite_popen()
sqlite_close()
sqlite_factory()

AnteriorInicioSiguiente
sqlite_num_rowsSubirsqlite_popen

Hosting by: hurra.com
Generated: 2007-01-26 18:00:50