PHP 5.4.31 Released

sybase_pconnect

(PHP 4, PHP 5)

sybase_pconnectOuvre une connexion persistante à un serveur Sybase

Description

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

sybase_connect() se comporte comme sybase_connect() avec deux différences majeures.

Premièrement, lors de la connexion, la fonction va chercher une connexion, persistante, déjà ouverte, avec le même hôte, nom de compte et mot de passe. Si une telle connexion est trouvée, un identifiant de cette connexion est retourné, plutôt que d'en ouvrir une nouvelle.

Deuxièmement, la connexion au serveur Sybase ne sera pas terminée lors de la fin du script. Au contraire, le lien sera maintenu pour des connexions ultérieures. sybase_close() ne fermera pas un lien créé par sybase_pconnect().

Ce type de lien est dit 'persistant'.

Liste de paramètres

servername

Doit être un nom de serveur valide, défini dans le fichier 'interfaces'.

username

Le nom d'utilisateur Sybase

password

Le mot de passe, associé avec l'utilisateur username.

charset

Spécifie le jeu de caractères pour la connexion

appname

Spécifie un appname pour la connexion Sybase. Cela permet d'établir des connexions distinctes dans le même script, avec la même base de données. Cela peut être pratique quand vous avez démarré une connexion et que vous devez lancer une requête séparée, qui ne peut pas être exécutée dans la transaction courante.

Valeurs de retour

Retourne un identifiant de connexion persistant Sybase en cas de succès, ou FALSE si une erreur survient.

Historique

Version Description
4.2.0 Le paramètre appname a été ajouté.
4.0.2 Le paramètre charset a été ajouté.

Voir aussi

add a note add a note

User Contributed Notes 1 note

up
1
verdy_p at wanadoo dot fr
15 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