(PHP 5, PHP 7, PHP 8)
pg_parameter_status — Consulta un parámetro de configuración actual del servidor
Consulta un parámetro de configuración actual del servidor.
Ciertos valores de parámetros son devueltos por el servidor automáticamente al inicio de la conexión o cuando un valor cambia. pg_parameter_status() puede ser utilizada para consultar estas configuraciones. La función devuelve el valor actual del parámetro si es conocido o false si el parámetro es desconocido.
Los parámetros devueltos por PostgreSQL 8.0 son server_version, server_encoding, client_encoding, is_superuser, session_authorization, DateStyle, TimeZone y integer_datetimes. (server_encoding, TimeZone y integer_datetimes no eran devueltos en versiones anteriores a 8.0.) Tenga en cuenta que server_version, server_encoding y integer_datetimes no pueden cambiar después del inicio de PostgreSQL.
Los servidores PostgreSQL 7.3 o versiones inferiores no devuelven parámetros de configuración, pg_parameter_status() incluye una lógica para obtener valores para server_version y client_encoding de todos modos. Las aplicaciones deberían utilizar pg_parameter_status() en lugar de código ad hoc para determinar estos valores.
En versiones de servidores PostgreSQL 7.4 y anteriores, el cambio de client_encoding con SET después del inicio de la conexión no será reflejado por pg_parameter_status().
connectionAn PgSql\Connection instance.
When connection is unspecified, the default connection is used.
The default connection is the last connection made by pg_connect()
or pg_pconnect().
As of PHP 8.1.0, using the default connection is deprecated.
param_name
Los valores posibles de param_name son server_version, server_encoding, client_encoding, is_superuser, session_authorization, DateStyle, TimeZone y integer_datetimes. Cabe señalar que este valor es sensible a mayúsculas y minúsculas.
Una cadena que contiene el valor del parámetro, false en caso de fallo o si el parámetro param_name es inválido.
| Versión | Descripción |
|---|---|
| 8.1.0 |
The connection parameter expects an PgSql\Connection
instance now; previously, a recurso was expected.
|
Ejemplo #1 Ejemplo con pg_parameter_status()
<?php
$dbconn = pg_connect("dbname=publisher") or die("Conexión imposible");
echo "Codificación del servidor: ", pg_parameter_status($dbconn, "server_encoding");
?>El resultado del ejemplo sería:
Codificación del servidor: SQL_ASCII