sybase_pconnect

(PHP 4, PHP 5)

sybase_pconnectAbre una conexión persistente a un servidor Sybase

Descripción

resource sybase_pconnect ([ string $servername [, string $username [, string $password [, string $charset [, string $appname ]]]]] )

sybase_pconnect() se comporta de forma parecida a sybase_connect() con dos diferencias principales.

En primer lugar, en el momento de conectar, la función intentará primero encontrar una conexión (persistente) que ya esté abierta para el mismo host, usuario y contraseña. Si se encuentra una, se devolverá un identificador para ella en vez de abrir una nueva conexión.

En segundo lugar, la conexión al servidor SQL no se cerrará cuando finalice la ejecución del script. En vez de eso, la conexión permanecerá abierta para ser utilizada en el futuro (sybase_close() no cerrará las conexiones establecidas por sybase_pconnect()).

Este tipo de conexiones, por tanto, se llaman 'persistentes'.

Parámetros

servername

El parámetro servername ha de ser un nombre de servidor válido que esté definido en el fichero 'interfaces'.

username

Nombre de usuario Sybase

password

Contraseña asociada a username.

charset

Especifica el mapa de caracteres para la conexión

appname

Especifica un appname para la conexión Sybase. Esto permite establecer conexiones separadas en el mismo script hacia la misma base de datos. Esto puede ser útil cuando se haya iniciado una transacción en la conexión actual, y se necesite realizar una consulta separada que no pueda ser realizada dentro de dicha transacción.

Valores devueltos

Devuelve un identificador de conexión persistente Sybase en caso de éxito, o FALSE en caso de error.

Historial de cambios

Versión Descripción
4.2.0 Se añade el parámetro appname.
4.0.2 Se añade el parámetro charset.

Ver también

add a note add a note

User Contributed Notes 1 note

up
1
verdy_p at wanadoo dot fr
14 years ago
The servername specified in sybase_connect and sybase_pconnect is solved locally on the PHP3 server host, which should be configured with the appropriate Sybase client configuration. This includes setting the environment variables for the account that runs the PHP3 extension, i.e. if it runs as a Web server extension, it must be configured in the user account that runs the Web server. You may setup at least the SYBASE environment, and add $SYBASE/bin within the user's path that runs the Web server. Standard installations of Sybase clients include setting up either a $SYBASE/interfaces file under Unix, or %SYBASE%\ini\sql.ini under Windows. This file contains local aliasnames for the referenced server names. These names may be different than that really used on the host that run the Sybase SQL Server. What is important is that this Sybase client configuration file will specify the location of the SQL Server, i.e. the network protocol to use, and if it's through TCP/IP, the host name or IP address of the Sybase SQL Server host, and its listener port number. Newer versions of Sybase includes the option to setup the interfaces or SQL.INI file with a single server entry, with will be a Sybase naming service. If this is used, the Sybase OpenClient libraries will connect to this naming service, if the SERVER name specified can't be solved locally. This naming service will provide the SQL Server location for the specified SERVER name you use in the sybase_connect or sybase_pconnect function calls, allowinf naming resolution on sites that want to have a centralized administration of multiple Sybase OpenServer servers, including gateways to other SQL servers such as OpenServer compatible gateways to Oracle or Informix servers. But if you want faster accesses to your Sybase SQL server used by your PHP3 scripts, you should configure the host which runs the PHP3 extension so that servernames can be solved locally. All you need is to add server entries in your interfaces or SQL.INI Sybase OpenClient configuration file.
To Top