<HTML ><HEAD ><TITLE >dbmopen</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="DBM Functions [deprecated]" HREF="ref.dbm.html"><LINK REL="PREVIOUS" TITLE="dbmnextkey" HREF="function.dbmnextkey.html"><LINK REL="NEXT" TITLE="dbmreplace" HREF="function.dbmreplace.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.dbmnextkey.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.dbmreplace.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.dbmopen" ></A >dbmopen</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN17581" ></A ><P > (PHP 3, PHP 4 )</P >dbmopen -- Opens a DBM database</DIV ><DIV CLASS="refsect1" ><A NAME="AEN17584" ></A ><H2 >Description</H2 >resource <B CLASS="methodname" >dbmopen</B > ( string filename, string flags)<BR ></BR ><P > The first argument is the full-path filename of the DBM file to be opened and the second is the file open mode which is one of "r", "n", "c" or "w" for read-only, new (implies read-write, and most likely will truncate an already-existing database of the same name), create (implies read-write, and will not truncate an already-existing database of the same name) and read-write respectively. </P ><P > Returns an identifier to be passed to the other DBM functions on success, or <TT CLASS="constant" ><B >FALSE</B ></TT > on failure. </P ><P > If NDBM support is used, NDBM will actually create filename.dir and filename.pag files. GDBM only uses one file, as does the internal flat-file support, and Berkeley DB creates a <TT CLASS="filename" >filename.db</TT > file. Note that PHP does its own file locking in addition to any file locking that may be done by the DBM library itself. PHP does not delete the <TT CLASS="filename" >.lck</TT > files it creates. It uses these files simply as fixed inodes on which to do the file locking. For more information on DBM files, see your Unix man pages, or obtain <A HREF="ftp://ftp.gnu.org/pub/gnu/gdbm/" TARGET="_top" >GNU's GDBM</A >. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Note: </B >When <A HREF="features.safe-mode.html" >safe mode</A > is enabled, PHP checks whether the files or directories you are about to operate on have the same UID (owner) as the script that is being executed.</P ></BLOCKQUOTE ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.dbmnextkey.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.dbmreplace.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >dbmnextkey</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.dbm.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >dbmreplace</TD ></TR ></TABLE ></DIV ></BODY ></HTML >